Datetimeformat

  • Articolo

Specifica il modo in cui 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 usata 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 sull'elemento

Elemento padre Elementi figlio
displayInfo Nessuno

 

Attributi

Attributo Descrizione
formatAs Pubblica. Facoltativa. Il valore predefinito è "General". I valori validi sono i seguenti.
Valore Significato
Generale Valore predefinito. Formatta il valore di data e ora usando SHFormatDateTime. Usare gli attributi formatTimeAs e formatDateAs per specificare la modalità di 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 specifichino l'anno e i due byte inferiori specifichino il mese.
Year Formatta il valore come stringa semplice.

 
formatTimeAs Pubblica. Facoltativa. 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 "17:48".
LongTime Mostra l'ora come "7:48:33 PM".
HideTime Non visualizzare la parte relativa all'ora della data.

 
formatDateAs Pubblica. Facoltativa. 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 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.