dateTimeFormat

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 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 l’élément

Parent, élément	Éléments enfants
displayInfo	Aucun

 

Attributs

Attribut	Description
formatAs	Public. Optionnel. La valeur par défaut est « Général ». Les valeurs suivantes sont valides. Valeur Signification Généralités Faire 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. Mois 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 « Year - Month ». 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. Année Met en forme la valeur sous forme de chaîne simple.
formatTimeAs	Public. Optionnel. La valeur par défaut est « ShortTime ». Spécifie le format dans lequel afficher l’heure. S’applique quand formatAs="General ». Les valeurs suivantes sont valides. Valeur Signification ShortTime Faire défaut. Affichez l’heure comme « 17 h 48 ». Longue Affichez l’heure comme « 17: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 quand formatAs="General ». Les valeurs suivantes sont valides. Valeur Exemple ShortDate Faire défaut. Affichez la date comme « 5/13/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.