Datetimeformat

Specifica come IPropertyDescription::FormatForDisplay deve formattare il valore della proprietà come stringa. Questa opzione è applicabile solo se <displayInfo displayType="DateTime">. Deve essere presente un solo elemento dateTimeFormat per ogni elemento displayInfo .

Se sono presenti più elementi, viene usato l'ultimo. Se non viene fornito alcun elemento dateTimeFormat , le impostazioni predefinite dell'attributo vengono applicate alla descrizione della proprietà.

Sintassi

      <!-- dateTimeFormat -->
      <xs:element name="dateTimeFormat"  minOccurs="0" maxOccurs="1">
        <xs:complexType>
          <xs:attribute name="formatAs">
            <xs:simpleType>
              <xs:restriction base="xs:string">
                <xs:enumeration value="General"/>
                <xs:enumeration value="Month"/>
                <xs:enumeration value="YearMonth"/>
                <xs:enumeration value="Year"/>
              </xs:restriction>
            </xs:simpleType>
          </xs:attribute>
          <xs:attribute name="formatTimeAs">
            <xs:simpleType>
              <xs:restriction base="xs:string">
                <xs:enumeration value="ShortTime"/>
                <xs:enumeration value="LongTime"/>
                <xs:enumeration value="HideTime"/>
              </xs:restriction>
            </xs:simpleType>
          </xs:attribute>
          <xs:attribute name="formatDateAs">
            <xs:simpleType>
              <xs:restriction base="xs:string">
                <xs:enumeration value="ShortDate"/>
                <xs:enumeration value="LongDate"/>
                <xs:enumeration value="HideDate"/>
                <xs:enumeration value="RelativeShortDate"/>
                <xs:enumeration value="RelativeLongDate"/>
              </xs:restriction>
            </xs:simpleType>
          </xs:attribute>
        </xs:complexType>
      </xs:element>

Informazioni sull'elemento

Elemento padre Elementi figlio
displayInfo Nessuno

 

Attributi

Attributo Descrizione
formatAs Pubblica. facoltativo. Il valore predefinito è "Generale". I valori validi sono i seguenti.
Valore Significato
Generale Valore predefinito. Formatta il valore data-ora usando SHFormatDateTime. Usare gli attributi formatTimeAs e formatDateAs per specificare la formattazione della data e dell'ora. Richiede che il tipo di proprietà sia DateTime.
Month Formatta il valore come uno dei mesi dell'anno. Richiede che il tipo di proprietà sia Int32. Il valore deve essere archiviato come valore numerico con 1 che rappresenta il primo mese dell'anno.
YearMonth Formatta il valore come "Year - Month". Richiede che il tipo di proprietà sia Int32. Il valore deve essere archiviato in modo che i due byte più alti specificano l'anno e i due byte inferiori specificano il mese.
Year Formatta il valore come stringa semplice.

 

formatTimeAs Pubblica. facoltativo. Il valore predefinito è "ShortTime". Specifica il formato in cui visualizzare l'ora. Si applica quando formatAs="General". I valori validi sono i seguenti.
Valore Significato
ShortTime Valore predefinito. Mostra l'ora come "7:48 PM".
LongTime Mostra l'ora come "7:48:33 PM".
HideTime Non visualizzare la parte dell'ora della data.

 

formatDateAs Pubblica. facoltativo. Il valore predefinito è "ShortDate". Specifica il formato in cui visualizzare la data. Si applica quando formatAs="General". I valori validi sono i seguenti.
Valore Esempio
ShortDate Valore predefinito. Mostra la data come "5/13/59".
LongDate Mostra la data come "Mercoledì, 13 maggio 1959".
HideDate Non visualizzare la parte della data.
RelativeShortDate Visualizzare la data come "ShortDate", ma usare descrizioni relative, ad esempio "ieri", ogni volta che è possibile.
RelativeLongDate Visualizzare la data come "LongDate", ma usare descrizioni relative, ad esempio "ieri", ogni volta che è possibile.