dateTimeFormat

  • [アーティクル]

IPropertyDescription::FormatForDisplay でプロパティの値を文字列として書式設定する方法を指定します。 これは、displayInfo displayType="DateTime" の>場合<にのみ適用されます。 displayInfo 要素ごとに dateTimeFormat 要素は 1 つだけ必要です。

複数の要素がある場合は、最後の要素が使用されます。 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>

要素情報

Parent 要素 子要素
displayInfo なし

 

属性

属性 説明
formatAs パブリック。 省略可能。 既定値は "General" です。 有効な値は次のとおりです。
値 説明
全般 既定値。 SHFormatDateTime を使用して、日付と時刻の値を書式設定します。 時刻と日付の書式設定方法を指定するには、 formatTimeAs 属性と formatDateAs 属性を使用します。 プロパティの種類を DateTime にする必要があります。
Month 値を年の月の 1 つとして書式設定します。 プロパティの種類が Int32 である必要があります。 値は、年の最初の月を表す 1 の数値として格納する必要があります。
YearMonth 値を "年 - 月" として書式設定します。 プロパティの種類が Int32 である必要があります。 2 つの最上位バイトが年を指定し、下位の 2 バイトが月を指定できるように、値を格納する必要があります。
Year 値を単純な文字列として書式設定します。

 
formatTimeAs パブリック。 省略可能。 既定値は "ShortTime" です。 時刻を表示する形式を指定します。 formatAs="General" の場合に適用されます。 有効な値は次のとおりです。
値 説明
短期間 既定値。 "午後 7:48" のような時間を表示します。
長年 "午後 7:48:33" のような時間を表示します。
HideTime 日付の時刻部分は表示しないでください。

 
formatDateAs パブリック。 省略可能。 既定値は "ShortDate" です。 日付を表示する形式を指定します。 formatAs="General" の場合に適用されます。 有効な値は次のとおりです。
値 例
ShortDate 既定値。 "5/13/59" のような日付を表示します。
LongDate "1959 年 5 月 13 日水曜日" のような日付を表示します。
HideDate 日付部分は表示しないでください。
RelativeShortDate 日付を "ShortDate" のように表示しますが、可能な限り"昨日" などの相対的な説明を使用します。
RelativeLongDate 日付を "LongDate" のように表示しますが、可能な限り"昨日" などの相対的な説明を使用します。