共用方式為


enumDateFormatsExA 函式 (winnls.h)

列舉指定地區設定可用的完整日期、簡短日期或年份/月格式。

注意 只有在 Windows Vista 和更新版本上執行的任何應用程式,都應該使用 EnumDateFormatsExEx 來喜好設定此函式。
 

語法

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

參數

[in] lpDateFmtEnumProcEx

應用程式定義回呼函式的指標。 如需詳細資訊,請參閱 EnumDateFormatsProcEx

[in] Locale

地區設定標識碼 ,指定要擷取日期格式資訊的地區設定。 您可以使用 MAKELCID 宏來建立識別碼,或使用下列其中一個預先定義的值。

Windows Vista 和更新版本: 也支援下列自定義地區設定標識碼。

[in] dwFlags

指定日期格式的旗標。 如需詳細定義,請參閱 EnumDateFormatsExExdwFlags 參數。

傳回值

如果成功,則傳回非零值,否則傳回 0。 若要取得延伸的錯誤資訊,應用程式可以呼叫 GetLastError,這可以傳回下列其中一個錯誤碼:

  • ERROR_INVALID_FLAGS。 為旗標的值無效。
  • ERROR_INVALID_PARAMETER。 任何參數值都無效。

備註

注意 此 API 即將更新,以支援 2019 年 5 月日紀元變更。 如果您的應用程式支援日曆,您應該驗證它是否能夠正確處理新紀元。 如需詳細資訊 ,請參閱準備您的應用程式以進行日文紀元變更
 
函式會藉由將日期格式字串指標一次傳遞至指定的應用程式定義回呼函式,以列舉日期格式。 此程式會繼續執行,直到 EnumDateFormatsEx 找到最後一個日期格式或回呼函式傳回 FALSE 為止。

此函式會列舉指定地區設定的所有日期格式,如果有的話,包括替代行事曆。 不過,不會列舉行事曆標識符以及日期格式,讓具有替代行事曆的地區設定格式難以使用。

此函式可以從 自定義地區設定列舉數據。 數據不保證從計算機到計算機或在應用程式執行之間相同。 如果您的應用程式必須保存或傳輸數據,請參閱 使用持續性地區設定數據

當此函式的 ANSI 版本搭配僅限 Unicode 的地區設定識別碼使用時,函式可能會成功,因為操作系統使用系統代碼頁。 不過,系統代碼頁中未定義的字元會出現在字串中,以問號 (?) 。

應用程式應該使用 EnumDateFormatsEx (,而不是 EnumDateFormats) 來列舉具有替代行事曆的地區設定日期格式。

注意

winnls.h 標頭會根據 UNICODE 預處理器常數的定義,將 EnumDateFormatsEx 定義為別名,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winnls.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

EnumDateFormats

EnumDateFormatsExEx

EnumDateFormatsProcEx

國家語言支援

國家語言支援函式