Compartilhar via


dateTimeFormat

Especifica como IPropertyDescription::FormatForDisplay deve formatar o valor da propriedade como uma cadeia de caracteres. Isso só será aplicável se <displayInfo displayType="DateTime">. Deve haver apenas um elemento dateTimeFormat para cada elemento displayInfo .

Se houver vários elementos, o último será usado. Se nenhum elemento dateTimeFormat for fornecido, as configurações de atributo padrão serão aplicadas à descrição da propriedade.

Sintaxe

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

Informações do elemento

Elemento pai Elementos filho
displayInfo Nenhum

 

Atributos

Atributo Descrição
formatAs Público. Opcional. O padrão é "Geral". Os seguintes valores são válidos:
Valor Significado
Geral Padrão. Formata o valor de data e hora usando SHFormatDateTime. Use os atributos formatTimeAs e formatDateAs para especificar como a hora e a data são formatadas. Requer que o tipo de propriedade seja DateTime.
Mês Formata o valor como um dos meses do ano. Requer que o tipo de propriedade seja Int32. O valor deve ser armazenado como um valor numérico com 1 representando o primeiro mês do ano.
YearMonth Formata o valor como "Ano – Mês". Requer que o tipo de propriedade seja Int32. O valor deve ser armazenado de modo que os dois bytes mais altos especifiquem o ano e os dois bytes inferiores especifiquem o mês.
Year Formata o valor como uma cadeia de caracteres simples.

 

formatTimeAs Público. Opcional. O padrão é "ShortTime". Especifica o formato no qual exibir o tempo. Aplica-se quando formatAs="General". Os seguintes valores são válidos:
Valor Significado
ShortTime Padrão. Mostre a hora como "19h48".
Longa data Mostre a hora como "19:48:33".
HideTime Não exiba a parte de hora da data.

 

formatDateAs Público. Opcional. O padrão é "ShortDate". Especifica o formato no qual exibir a data. Aplica-se quando formatAs="General". Os seguintes valores são válidos:
Valor Exemplo
ShortDate Padrão. Mostre a data como "13/5/59".
LongDate Mostre a data como "Quarta-feira, 13 de maio de 1959".
HideDate Não exiba a parte de data.
RelativeShortDate Mostre a data como "ShortDate", mas use descrições relativas, como "yesterday", sempre que possível.
RelativeLongDate Mostre a data como "LongDate", mas use descrições relativas, como "ontem", sempre que possível.