VarUdateFromDate 関数 (oleauto.h)

バリアント形式から MS-DOS 形式に変換された時刻と日付を変換します。

構文

HRESULT VarUdateFromDate(
  [in]  DATE  dateIn,
  [in]  ULONG dwFlags,
  [out] UDATE *pudateOut
);

パラメーター

[in] dateIn

パックされた日付。

[in] dwFlags

イスラム暦、ポーランド語、ロシア語などの代替カレンダーに設定します。

[out] pudateOut

開梱された日付。

戻り値

この関数は、これらの値のいずれかを返すことができます。

注釈

UDATE 構造体は、 VarDateFromUdate と VarUdateFromDate で使用されます。 "アンパックされた" 日付を表します。

typedef struct {
    SYSTEMTIME st;
    USHORT  wDayOfYear;
} UDATE;

VarUdateFromDate 関数は無効な日付を受け入れ、VARIANT 時刻に解決するときに修正しようとします。 たとえば、2001 年 2 月 29 日などの無効な日付は、2001 年 3 月 1 日に解決されます。 日のみが固定されているため、無効な月の値を指定するとエラーが返されます。 日数は 1 から 31 の間にチェックされます。 負の日数と 31 日を超える場合、エラーが発生します。 31 日未満で、その月の最大日より大きい日は、その日が翌月の適切な日に昇格します。 0 に等しい日は、前月の最後の日として解決されます。 たとえば、2001 年 2 月 0 日などの無効な日付は、2001 年 1 月 31 日に解決されます。

要件