Поделиться через

dateTimeFormat

  • Статья

Указывает, как IPropertyDescription::FormatForDisplay должен форматировать значение свойства в виде строки. Это применимо, только если <displayInfo displayType="DateTime">. Для каждого элемента displayInfo должен быть только один элемент dateTimeFormat .

При наличии нескольких элементов используется последний элемент. Если элемент dateTimeFormat не указан, параметры атрибута по умолчанию применяются к описанию свойства.

Синтаксис

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

Сведения об элементе

Родительский элемент Дочерние элементы
displayInfo Никакой

 

Атрибуты

Атрибут Описание
форматы Общественный. Необязательный. Значение по умолчанию — "Общие". Ниже приведены допустимые значения.
Ценность Значение
Общее По умолчанию. Форматирует значение даты и времени с помощью SHFormatDateTime. Используйте атрибуты formatTimeAs и formatDateAs, чтобы указать формат времени и даты. Требует, чтобы тип свойства был DateTime.
Месяц Форматирует значение как одно из месяцев года. Требует, чтобы тип свойства был Int32. Значение должно храниться как числовое значение с 1, представляющее первый месяц года.
YearMonth Форматирует значение "Year - Month". Требует, чтобы тип свойства был Int32. Значение должно храниться таким образом, чтобы два самых высоких байта указали год, а нижние два байта указывают месяц.
Год Форматирует значение как простую строку.

 
formatTimeAs Общественный. Необязательный. Значение по умолчанию — ShortTime. Указывает формат, в котором будет отображаться время. Применяется, если formatAs="General". Ниже приведены допустимые значения.
Ценность Значение
ShortTime По умолчанию. Показать время, как "7:48 вечера".
Долгосрочный Показать время, например "7:48:33 вечера".
HideTime Не отображайте часть времени даты.

 
formatDateAs Общественный. Необязательный. Значение по умолчанию — ShortDate. Указывает формат, в котором отображается дата. Применяется, если formatAs="General". Ниже приведены допустимые значения.
Ценность Пример
ShortDate По умолчанию. Отображение даты, например "5/13/59".
LongDate Показать дату, например "Среда, 13 мая 1959 года".
СкрытьDate Не отображайте часть даты.
ОтносительныйShortDate Отображение даты, например ShortDate, но используйте относительные описания, такие как "вчера", когда это возможно.
ОтносительныйlongDate Показывать дату, например LongDate, но используйте относительные описания, такие как "вчера", каждый раз, когда это возможно.