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 Public。 可选。 默认值为“常规”。 下面是有效的值。
含义
常规 默认。 使用 SHFormatDateTime 设置日期/时间值的格式。 使用 formatTimeAsformatDateAs 属性指定时间和日期的格式。 需要属性类型为 DateTime。
Month 将值的格式设置为年份的月份之一。 需要属性类型为 Int32。 该值必须存储为一个数值,其中 1 表示年份的第一个月。
YearMonth 将值的格式设置为“Year - Month”。 需要属性类型为 Int32。 必须存储该值,以便两个最高字节指定年份,而较低的两个字节指定月份。
年龄 将值的格式设置为简单字符串。

 

formatTimeAs Public。 可选。 默认值为“ShortTime”。 指定要显示时间的格式。 当 formatAs=“General”时适用。 下面是有效的值。
含义
ShortTime 默认。 显示时间,如“下午 7:48”。
长期 显示时间,如“下午 7:48:33”。
HideTime 不显示日期的时间部分。

 

formatDateAs Public。 可选。 默认值为“ShortDate”。 指定要在其中显示日期的格式。 当 formatAs=“General”时适用。 下面是有效的值。
示例
ShortDate 默认。 显示日期,如“5/13/59”。
LongDate 显示日期,如“1959年5月13日星期三”。
HideDate 不显示日期部分。
RelativeShortDate 尽可能显示日期(如“ShortDate”),但尽可能使用相对说明,如“昨天”。
RelativeLongDate 尽可能显示日期(如“LongDate”),但尽可能使用相对说明,如“昨天”。