SHFormatDateTimeA 関数 (shlwapi.h)

[アーティクル]
11/20/2024

[SHFormatDateTime は、[要件] セクションで指定されたオペレーティングシステムで使用できます。それ以降のバージョンでは、変更または使用できない可能性があります。

FILETIME 構造体として指定された時刻の文字列形式を生成します。

構文

int SHFormatDateTimeA(
  [in]                const FILETIME *pft,
  [in, out, optional] DWORD          *pdwFlags,
  [out]               LPSTR          pszBuf,
                      UINT           cchBuf
);

パラメーター

[in] pft

型: const FILETIME UNALIGNED*

時刻を文字列に変換する FILETIME 構造体へのポインター。

[in, out, optional] pdwFlags

型: DWORD*

日付と時刻の形式を指定するビットごとのフラグを含む DWORD 値へのポインター。

関数を呼び出すときに、次のフラグを 0 個以上組み合わせることができます。ただし、例外は示されています。このパラメーターを NULLに設定することもできます。この場合、関数は FDTF_DEFAULT フラグが設定されていると見なします。

FDTF_SHORTTIME (0x00000001)

0x00000001。コントロールパネルの 地域と言語のオプション アプリケーションで指定された時刻を書式設定しますが、秒は設定しません。このフラグをFDTF_LONGTIMEと組み合わせることはできません。

短い時間が正常に書式設定されました。

FDTF_SHORTDATE (0x00000002)

0x00000002。コントロールパネルの [地域と言語のオプション] アプリケーションのの短い日付形式で指定された日付を書式設定します。このフラグをFDTF_LONGDATEと組み合わせることはできません。

短い日付が正常に書式設定されました。

FDTF_DEFAULT

FDTF_SHORTDATEと同等 |FDTF_SHORTTIME。

FDTF_LONGDATE (0x00000004)

0x00000004。コントロールパネルの 地域および言語オプション アプリケーションで、長い日付形式で指定された日付を書式設定します。このフラグをFDTF_SHORTDATEと組み合わせることはできません。

長い日付が正常に書式設定されました。

FDTF_LONGTIME (0x00000008)

0x00000008。コントロールパネルの [地域と言語のオプション] アプリケーションで指定時刻 (秒を含む) を書式設定します。このフラグをFDTF_SHORTTIMEと組み合わせることはできません。

長い時間が正常に書式設定されました。

FDTF_RELATIVE (0x00000010)

0x00000010。 FDTF_LONGDATE フラグが設定され、FILETIME 構造体の日付が SHFormatDateTime 呼び出される日付と同じ場合、曜日 (存在する場合) は "Today" に変更されます。構造体の日付が前日の場合、曜日 (存在する場合) は "昨日" に変更されます。

日付には相対表記が使用されました。

FDTF_LTRDATE (0x00000100)

0x00000100。左から右の読み取りレイアウトのマークを追加します。このフラグをFDTF_RTLDATEと組み合わせることはできません。

FDTF_RTLDATE (0x00000200)

0x00000200。右から左への読み取りレイアウトのマークを追加します。このフラグをFDTF_LTRDATEと組み合わせることはできません。

FDTF_NOAUTOREADINGORDER (0x00000400)

0x00000400。読み取り順序マークは挿入されません。通常、FDTF_LTRDATEフラグまたはFDTF_RTLDATE フラグがない場合、SHFormatDateTime は、ユーザーの既定のロケールからの読み取り順序を決定し、読み取り順序マークを挿入し、pdwFlags 出力値を適切に更新します。このフラグは、そのプロセスが発生するのを防ぎます。これは、SHFormatDateTimeのレガシ呼び出し元によって最も一般的に使用されます。このフラグをFDTF_RTLDATEまたはFDTF_LTRDATEと組み合わせることはできません。

Windows Server 2003 および Windows XP: この値は使用できません。

関数から制御が戻るときに、このパラメーターが指す DWORD 値には、次のフラグを 0 個以上含めることができます。

[out] pszBuf

型: LPTSTR

書式設定された日時を受け取るバッファーへのポインター。バッファーは、cchBuf パラメーターで指定された TCHAR 文字の数 (終端の null 文字を含む) を格納するのに十分な大きさである必要があります。

cchBuf

型: UINT

pszBufが指すバッファーに含めることができる TCHAR の数。

戻り値

型: int

バッファーに書き込まれた TCHAR の数 (終端の null 文字を含む) を返します。失敗した場合、この値は 0 です。

備考

手記

shlwapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SHFormatDateTime を定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows XP [デスクトップアプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	shlwapi.h
ライブラリ	Shlwapi.lib
DLL	Shlwapi.dll (バージョン 5.0 以降)

次の方法で共有