Partilhar via


dateTimeFormat

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

Se houver vários elementos, o último é 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ública. Opcional. O padrão é "Geral". A seguir estão os valores válidos.
Valor Significado
Geral Inadimplência. Formata o valor de data-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.
AnoMês Formata o valor como "Ano - Mês". Requer que o tipo de propriedade seja Int32. O valor deve ser armazenado de forma que os dois bytes mais altos especifiquem o ano e os dois bytes inferiores especifiquem o mês.
Ano Formata o valor como uma cadeia de caracteres simples.

 

formatTimeAs Pública. Opcional. O padrão é "ShortTime". Especifica o formato no qual o tempo de exibição será exibido. Aplica-se quando formatAs="General". A seguir estão os valores válidos.
Valor Significado
Tempo curto Inadimplência. Mostre o horário como "19h48".
Longa Duração Mostre o horário como "19:48:33".
EsconderTempo Não exiba a parte de tempo da data.

 

formatDataAs Pública. Opcional. O padrão é "ShortDate". Especifica o formato no qual a data será exibida. Aplica-se quando formatAs="General". A seguir estão os valores válidos.
Valor Exemplo
Data curta Inadimplência. Mostre a data como "13/05/59".
LongDate Mostre a data como "Quarta-feira, 13 de maio de 1959".
DataOcultação Não exiba a parte da data.
RelativeShortDate Mostre a data como "ShortDate", mas use descrições relativas, como "ontem", sempre que possível.
RelativeLongDate Mostre a data como "LongDate", mas use descrições relativas, como "ontem", sempre que possível.