Udostępnij przez


dateTimeFormat

Określa, jak IPropertyDescription::FormatForDisplay powinny formatować wartość właściwości jako ciąg. Ma to zastosowanie tylko wtedy, gdy <displayInfo displayType="DateTime">. Powinien istnieć tylko jeden element dateTimeFormat dla każdego elementu displayInfo.

Jeśli istnieje wiele elementów, zostanie użyty ostatni element. Jeśli nie podano elementu dateTimeFormat, domyślne ustawienia atrybutu są stosowane do opisu właściwości.

Składnia

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

Informacje o elementach

Element nadrzędny Elementy podrzędne
displayInfo Żaden

 

Atrybuty

Atrybut Opis
formatAs Publiczny. Fakultatywny. Wartość domyślna to "Ogólne". Poniżej przedstawiono prawidłowe wartości.
Wartość Znaczenie
Ogólne Domyślny. Formatuje wartość daty i godziny przy użyciu SHFormatDateTime. Użyj formatTimeAs i formatDateAs atrybutów, aby określić sposób formatowania godziny i daty. Wymaga, aby typ właściwości był typu DateTime.
Miesiąc Formatuje wartość jako jedną z miesięcy roku. Wymaga, aby typ właściwości był int32. Wartość musi być przechowywana jako wartość liczbowa z wartością 1 reprezentującą pierwszy miesiąc roku.
Miesiąc roku Formatuje wartość jako "Year - Month". Wymaga, aby typ właściwości był int32. Wartość musi być przechowywana tak, aby dwa najwyższe bajty określały rok, a dolne dwa bajty określają miesiąc.
Rok Formatuje wartość jako prosty ciąg.

 

formatTimeAs Publiczny. Fakultatywny. Wartość domyślna to "ShortTime". Określa format, w którym ma być wyświetlany czas. Ma zastosowanie, gdy formatAs="Ogólne". Poniżej przedstawiono prawidłowe wartości.
Wartość Znaczenie
Krótki czas Domyślny. Pokaż godzinę, na przykład "19:48".
Długoletni Pokaż godzinę, na przykład "19:48:33".
HideTime Nie wyświetlaj części godziny daty.

 

formatDateAs Publiczny. Fakultatywny. Wartość domyślna to "ShortDate". Określa format, w którym ma być wyświetlana data. Ma zastosowanie, gdy formatAs="Ogólne". Poniżej przedstawiono prawidłowe wartości.
Wartość Przykład
Data skrócona Domyślny. Pokaż datę, na przykład "5/13/59".
Data długiej Pokaż datę, na przykład "Środa, 13 maja 1959".
UkryjDate Nie wyświetlaj części daty.
RelativeShortDate Pokaż datę, taką jak "ShortDate", ale używaj opisów względnych, takich jak "wczoraj", zawsze, gdy jest to możliwe.
RelativeLongDate Pokaż datę taką jak "LongDate", ale używaj opisów względnych, takich jak "wczoraj", zawsze, gdy jest to możliwe.