GetCalendarDateFormatEx

非推奨。

GetCalendarDateFormatEx lpszLocale, dwFlags, lpCalDateTime, lpFormat, lpDateStr, cchDate

lpszLocale : [wstr] ロケール名へのポインタ、または次の定義済み値のいずれか。 -   [LOCALE\_NAME\_INVARIANT](locale-name-constants.md) -   [LOCALE\_NAME\_SYSTEM\_DEFAULT](locale-name-constants.md) -   [LOCALE\_NAME\_USER\_DEFAULT](locale-name-constants.md)
dwFlags : [int] 日付フォーマットオプションを指定するフラグ。*lpFormat* が **NULL** でない場合、このパラメータは 0 を指定する必要がある。*lpFormat* が **NULL** の場合、アプリケーションは次の値と [LOCALE\_NOUSEROVERRIDE](locale-nouseroverride.md) との組み合わせを指定できる。
lpCalDateTime : [var] 整形対象の日付とカレンダー情報を含む [**CALDATETIME**](caldatetime.md) 構造体へのポインタ。
lpFormat : [wstr] 日付文字列を組み立てるために使われるフォーマットピクチャ文字列へのポインタ。フォーマットピクチャ文字列に指定可能な値は [Day, Month, Year, and Era Format Pictures](day--month--year--and-era-format-pictures.md) で定義されている。フォーマットピクチャ文字列は NULL 終端でなければならない。関数はフォーマットピクチャ文字列で指定されていない情報（たとえばロケールの曜日名や月名）にのみロケールを使う。指定したロケールの日付形式を使わせる場合、アプリケーションはこのパラメータを **NULL** に設定する。
lpDateStr : [wstr] 整形済み日付文字列をこの関数が受け取るバッファへのポインタ。
cchDate : [int] *lpDateStr* バッファのサイズを文字数で指定する。あるいは、アプリケーションはこのパラメータに 0 を設定することもできる。その場合、関数は整形済み日付文字列を保持するのに必要な文字数を返し、*lpDateStr* パラメータは使われない。

(プラグイン / モジュール : kernel32.dll)

解説

非推奨。

[戻り値]
成功した場合は *lpDateStr* バッファに書き込まれた文字数を返す。*cchDate* パラメータが 0
に設定されている場合、関数は終端 NULL 文字を含む整形済み日付文字列を保持するのに必要な文字数を返す。成功しなかった場合は 0
を返す。拡張エラー情報を取得するには GetLastError を呼び出すことができ、次のいずれかのエラーコードが返ることがある。 -
ERROR\_DATE\_OUT\_OF\_RANGE: 指定された日付が範囲外。 -
ERROR\_INSUFFICIENT\_BUFFER: 指定されたバッファサイズが十分でないか、誤って **NULL**
に設定されていた。 - ERROR\_INVALID\_FLAGS: フラグに指定された値が無効。 -
ERROR\_INVALID\_PARAMETER: いずれかのパラメータ値が無効。

[備考]
この関数がサポートする最も古い日付は 1601 年 1 月 1
日である。この関数には対応するヘッダファイルやライブラリファイルがない。アプリケーションは
[**LoadLibrary**](/windows/win32/api/libloaderapi/nf-libloaderapi-loadlibrarya)
を DLL 名（Kernel32.dll）で呼び出してモジュールハンドルを取得し、そのモジュールハンドルとこの関数名を
[**GetProcAddress**](/windows/win32/api/libloaderapi/nf-libloaderapi-getprocaddress)
に渡して関数アドレスを取得できる。

情報