次の方法で共有


EnumDateFormatsExA 関数 (winnls.h)

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

Windows Vista 以降でのみ実行されるアプリケーションでは、この関数に優先して EnumDateFormatsEx 使用する必要があります。
 

構文

BOOL EnumDateFormatsExA(
  [in] DATEFMT_ENUMPROCEXA lpDateFmtEnumProcEx,
  [in] LCID                Locale,
  [in] DWORD               dwFlags
);

パラメーター

[in] lpDateFmtEnumProcEx

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

[in] Locale

日付書式情報を取得するロケールを指定するロケール識別子MAKELCID マクロを使用して識別子を作成するか、次のいずれかの定義済み値を使用できます。

Windows Vista 以降 : 次のカスタム ロケール識別子もサポートされています。

[in] dwFlags

日付形式を指定するフラグ。 詳細な定義については、EnumDateFormatsExの dwFlags パラメーター 参照してください。

戻り値

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

  • ERROR_INVALID_FLAGS。 フラグに指定された値が無効でした。
  • ERROR_INVALID_PARAMETER。 パラメーター値のいずれかが無効でした。

備考

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

この関数は、代替カレンダー (ある場合) を含め、指定されたロケールのすべての日付形式を列挙します。 ただし、カレンダー識別子は日付形式と共に列挙されないため、別の予定表を含むロケールの形式は使いづらくなります。

この関数は、カスタム ロケールからデータ 列挙できます。 データは、コンピューター間、またはアプリケーションの実行間で同じであるとは限りません。 アプリケーションでデータを永続化または送信する必要がある場合は、「永続的なロケール データの使用 」を参照してください。

この関数の ANSI バージョンを Unicode のみのロケール識別子と共に使用すると、オペレーティング システムがシステム コード ページを使用するため、関数は成功する可能性があります。 ただし、システム コード ページで未定義の文字は、文字列に疑問符 (?) として表示されます。

アプリケーションでは、(EnumDateFormatsではなく) EnumDateFormatsEx を使用して、代替カレンダーを含むロケールの日付形式を列挙する必要があります。

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winnls.h (Windows.h を含む)
ライブラリ Kernel32.lib
DLL Kernel32.dll

関連項目

EnumDateFormats の

EnumDateFormatsExEx の

EnumDateFormatsProcEx の

各国語サポート

各国語サポート関数