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 Нет

 

Атрибуты

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

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

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