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 |