SystemTimeToFileTime 関数 (timezoneapi.h)

  • [アーティクル]

システム時刻をファイル時刻形式に変換します。 システム時刻は協定世界時 (UTC) に基づいています。

構文

BOOL SystemTimeToFileTime(
  [in]  const SYSTEMTIME *lpSystemTime,
  [out] LPFILETIME       lpFileTime
);

パラメーター

[in] lpSystemTime

UTC からファイル時刻形式に変換されるシステム時刻を含む SYSTEMTIME 構造体へのポインター。

SYSTEMTIME 構造体の wDayOfWeek メンバーは無視されます。

[out] lpFileTime

変換されたシステム時刻を受け取る FILETIME 構造体へのポインター。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

注意

False の戻り値は、渡された SYSTEMTIME 構造体が無効な日付を表していることを示すことができます。 閏年に追加された日など、特定の状況では、アプリケーション ロジックによって予期せず無効な日付が作成される可能性があります。 これらの問題の回避の詳細については、「 うるう年の準備」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー timezoneapi.h (Windows.h を含む)
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

DosDateTimeToFileTime

FILETIME

FileTimeToDosDateTime

FileTimeToSystemTime

SYSTEMTIME

システム時刻

時間関数