通过

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 设置日期时间值的格式。 使用 formatTimeAs 和 formatDateAs 属性指定时间和日期的格式。 要求属性类型为 DateTime。
Month 将值格式化为一年中的月份之一。 要求属性类型为 Int32。 该值必须存储为数字值，1 表示一年中的第一个月。
YearMonth 将值的格式设置为“Year - Month”。 要求属性类型为 Int32。 必须存储该值，以便两个最高字节指定年份，较低的两个字节指定月份。
Year 将值的格式设置为简单字符串。

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

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