EnumDateFormatsExEx 関数 (winnls.h)

名前で指定されたロケールで使用できる長い日付、短い日付、または年/月の形式を列挙します。

メモ アプリケーションは、Windows Vista 以降でのみ実行するように設計されている場合は、 EnumDateFormats または EnumDateFormatsEx を優先してこの関数を呼び出す必要があります。

 
メモ この関数は、たとえばカスタム ロケールのためにリリース間で変更されるデータを列挙できます。 アプリケーションでデータを永続化または送信する必要がある場合は、「 永続的なロケール データの使用」を参照してください。
 

構文

BOOL EnumDateFormatsExEx(
  [in]           DATEFMT_ENUMPROCEXEX lpDateFmtEnumProcExEx,
  [in, optional] LPCWSTR              lpLocaleName,
  [in]           DWORD                dwFlags,
  [in]           LPARAM               lParam
);

パラメーター

[in] lpDateFmtEnumProcExEx

アプリケーション定義のコールバック関数へのポインター。 詳細については、「 EnumDateFormatsProcExEx」を参照してください。

[in, optional] lpLocaleName

ロケール名へのポインター、または次の定義済みの値のいずれか。

[in] dwFlags

日付形式を指定するフラグ。 アプリケーションは、次のいずれかの値または LOCALE_USE_CP_ACP 定数を指定できます。

意味
DATE_SHORTDATE
短い日付形式を使用します。 この値は、他のどのフラグ値とも併用できません。
DATE_LONGDATE
長い日付形式を使用します。 この値は、他のどのフラグ値とも併用できません。
DATE_YEARMONTH
年/月形式を使用します。 この値は、他のどのフラグ値とも併用できません。
DATE_MONTHDAY
月/日形式を使用します。 この値は、他のどのフラグ値とも併用できません。

[in] lParam

コールバック関数に渡すアプリケーション指定のパラメーター。 この値は、マルチスレッド アプリケーションに特に役立ちます。

戻り値

成功した場合は 0 以外の値を返し、それ以外の場合は 0 を返します。 拡張エラー情報を取得するために、アプリケーションは GetLastError を呼び出すことができます。これにより、次のいずれかのエラー コードが返されます。

  • ERROR_BADDB。 関数がデータにアクセスできませんでした。 この状況は通常は発生しません。通常は、インストールが正しくない、ディスクの問題などを示します。
  • ERROR_INVALID_FLAGS。 フラグに指定された値が無効でした。
  • ERROR_INVALID_PARAMETER。 パラメーター値のいずれかが無効です。

注釈

メモ この API は、2019 年 5 月の日本の時代変更をサポートするように更新されています。 アプリケーションで日本語カレンダーがサポートされている場合は、新しい時代 (年号) が適切に処理されていることを検証する必要があります。 詳細については、「 日本の時代 (年号) の変更に合わせてアプリケーションを準備 する」を参照してください。
 
関数は、指定されたアプリケーション定義コールバック関数に日付書式文字列ポインターを一度に 1 つずつ渡し、マルチスレッド アプリケーションに役立つアプリケーション定義の定数と共に、日付形式を列挙します。 このプロセスは、 EnumDateFormatsExEx が 最後の日付形式を見つけるか、コールバック関数が FALSE を返すまで続行されます。

Windows 8以降: アプリが Windows.Globalization 名前空間からこの関数に言語タグを渡す場合は、最初に ResolveLocaleName を呼び出してタグを変換する必要があります。

要件

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

関連項目

EnumDateFormats

EnumDateFormatsEx

EnumDateFormatsProcExEx

各国語サポート

各国語サポート関数