dateTimeFormat

  • Artículo

Especifica cómo IPropertyDescription::FormatForDisplay debe dar formato al valor de la propiedad como una cadena. Esto solo es aplicable si <displayInfo displayType="DateTime">. Solo debe haber un elemento dateTimeFormat para cada elemento displayInfo .

Si hay varios elementos, se usa el último. Si no se proporciona ningún elemento dateTimeFormat , la configuración de atributo predeterminada se aplica a la descripción de la propiedad.

Sintaxis

      <!-- 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>

Información de elemento

Elemento primario Elementos secundarios
displayInfo Ninguno

 

Atributos

Atributo Descripción
formatAs Público. Opcional. El valor predeterminado es "General". Estos son los valores válidos.
Value Significado
General Predeterminada. Da formato al valor de fecha y hora mediante SHFormatDateTime. Use los atributos formatTimeAs y formatDateAs para especificar cómo se da formato a la hora y la fecha. Requiere que el tipo de propiedad sea DateTime.
Month (Mes) Da formato al valor como uno de los meses del año. Requiere que el tipo de propiedad sea Int32. El valor debe almacenarse como un valor numérico con 1 que representa el primer mes del año.
YearMonth Da formato al valor como "Year - Month". Requiere que el tipo de propiedad sea Int32. El valor debe almacenarse de forma que los dos bytes más altos especifiquen el año y los dos bytes inferiores especifiquen el mes.
Year Da formato al valor como una cadena simple.

 
formatTimeAs Público. Opcional. El valor predeterminado es "ShortTime". Especifica el formato en el que se va a mostrar la hora. Se aplica cuando formatAs="General". Estos son los valores válidos.
Value Significado
ShortTime Predeterminada. Muestra la hora como "7:48 PM".
Largo Muestra la hora como "7:48:33 PM".
HideTime No muestre la parte de hora de la fecha.

 
formatDateAs Público. Opcional. El valor predeterminado es "ShortDate". Especifica el formato en el que se va a mostrar la fecha. Se aplica cuando formatAs="General". Estos son los valores válidos.
Valor Ejemplo
ShortDate Predeterminada. Muestra la fecha como "5/13/59".
LongDate Muestre la fecha como "Miércoles, 13 de mayo de 1959".
HideDate No muestre la parte de fecha.
RelativeShortDate Muestre la fecha como "ShortDate", pero use descripciones relativas, como "ayer", siempre que sea posible.
RelativeLongDate Muestre la fecha como "LongDate", pero use descripciones relativas, como "ayer", siempre que sea posible.