Condividi tramite


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 utilizzata l'ultima. Se non viene specificato 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 sugli elementi

Elemento padre Elementi figlio
displayInfo Nessuno

 

Attributi

Attributo Descrizione
formatAs Pubblico. Opzionale. Il valore predefinito è "Generale". Di seguito sono riportati i valori validi.
Valore Significato
Generale Default. Formatta il valore di data e ora usando SHFormatDateTime. Usare gli attributi formatTimeAs e formatDateAs per specificare la formattazione dell'ora e della data. Richiede che il tipo di proprietà sia DateTime.
Mese 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 specifichino l'anno e i due byte inferiori specifichino il mese.
Anno Formatta il valore come stringa semplice.

 

formatTimeAs Pubblico. Opzionale. Il valore predefinito è "ShortTime". Specifica il formato in cui visualizzare l'ora. Si applica quando formatAs="General". Di seguito sono riportati i valori validi.
Valore Significato
ShortTime Default. Mostra l'ora come "7:48 PM".
Di vecchia data Mostra l'ora come "7:48:33 PM".
HideTime Non visualizzare la parte relativa all'ora della data.

 

formatDateAs Pubblico. Opzionale. Il valore predefinito è "ShortDate". Specifica il formato in cui visualizzare la data. Si applica quando formatAs="General". Di seguito sono riportati i valori validi.
Valore Esempio
ShortDate Default. Mostra la data come "5/13/59".
LongDate Mostra la data come "Mercoledì, 13 maggio 1959".
HideDate Non visualizzare la parte relativa alla data.
RelativeShortDate Mostra la data come "ShortDate", ma usa descrizioni relative, ad esempio "ieri", quando possibile.
RelativeLongDate Mostra la data come "LongDate", ma usa descrizioni relative, ad esempio "ieri", quando possibile.