dateTimeFormat

  • Article

Spécifie comment IPropertyDescription::FormatForDisplay doit mettre en forme la valeur de la propriété en tant que chaîne. Cela s’applique uniquement si <displayInfo displayType="DateTime »>. Il ne doit y avoir qu’un seul élément dateTimeFormat pour chaque élément displayInfo .

S’il existe plusieurs éléments, le dernier est utilisé. Si aucun élément dateTimeFormat n’est fourni, les paramètres d’attribut par défaut sont appliqués à la description de la propriété.

Syntaxe

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

Informations sur les éléments

Élément parent Éléments enfants
displayInfo None

 

Attributs

Attribut Description
formatAs Public. Optionnel. La valeur par défaut est « General ». Les valeurs valides sont les suivantes.
Valeur Signification
Général Par défaut. Met en forme la valeur date-heure à l’aide de SHFormatDateTime. Utilisez les attributs formatTimeAs et formatDateAs pour spécifier la façon dont l’heure et la date sont mises en forme. Nécessite que le type de propriété soit DateTime.
Month Met en forme la valeur comme l’un des mois de l’année. Nécessite que le type de propriété soit Int32. La valeur doit être stockée sous forme de valeur numérique avec 1 représentant le premier mois de l’année.
YearMonth Met en forme la valeur en « Année - Mois ». Nécessite que le type de propriété soit Int32. La valeur doit être stockée de telle sorte que les deux octets les plus élevés spécifient l’année et les deux octets inférieurs spécifient le mois.
Year Met en forme la valeur sous la forme d’une chaîne simple.

 
formatTimeAs Public. Optionnel. La valeur par défaut est « ShortTime ». Spécifie le format dans lequel afficher l’heure. S’applique lorsque formatAs="General ». Les valeurs valides sont les suivantes.
Valeur Signification
ShortTime Par défaut. Affichez l’heure comme « 19 h 48 ».
Longue Affichez l’heure comme « 19:48:33 PM ».
HideTime N’affichez pas la partie heure de la date.

 
formatDateAs Public. Optionnel. La valeur par défaut est « ShortDate ». Spécifie le format dans lequel afficher la date. S’applique lorsque formatAs="General ». Les valeurs valides sont les suivantes.
Valeur Exemple
ShortDate Par défaut. Affichez la date comme « 13/05/59 ».
LongDate Affichez la date comme « Mercredi, 13 mai 1959 ».
HideDate N’affichez pas la partie date.
RelativeShortDate Affichez la date comme « ShortDate », mais utilisez des descriptions relatives, telles que « hier », dans la mesure du possible.
RelativeLongDate Affichez la date comme « LongDate », mais utilisez des descriptions relatives, telles que « hier », dans la mesure du possible.