FileTimeToDosDateTime 関数 (winbase.h)

ファイル時刻を MS-DOS の日付と時刻の値に変換します。

構文

BOOL FileTimeToDosDateTime(
  [in]  const FILETIME *lpFileTime,
  [out] LPWORD         lpFatDate,
  [out] LPWORD         lpFatTime
);

パラメーター

[in] lpFileTime

MS-DOS の日時形式に変換するファイル時刻を含む FILETIME 構造体へのポインター。

[out] lpFatDate

MS-DOS 日付を受け取る変数へのポインター。 日付は、次の形式のパック値です。

Bits 説明
0–4 月の日 (1 から 31)
5–8 月 (1 = 1 月、2 = 2 月など)
9-15 1980 年からの年オフセット (実際の年を取得するには 1980 を加算します)

[out] lpFatTime

MS-DOS 時刻を受け取る変数へのポインター。 時刻は、次の形式のパック値です。

Bits 説明
0–4 2 番目を 2 で割った
5–10 分 (0 から 59)
11–15 時間 (24 時間制の場合は 0 から 23)

戻り値

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

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

解説

MS-DOS 日付形式は、1980 年 1 月 1 日から 2107 年 12 月 31 日までの日付のみを表すことができます。入力ファイルの時刻がこの範囲外の場合、この変換は失敗します。

要件

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

関連項目

DosDateTimeToFileTime

FileTimeToSystemTime

SystemTimeToFileTime

時間関数