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。 若要取得延伸的錯誤資訊，應用程式可以呼叫 GetLastError，這可以傳回下列其中一個錯誤碼：

  • ERROR_BADDB。 函式無法存取數據。 這種情況通常不應該發生，通常表示安裝不正確、磁碟問題或類似。
  • ERROR_INVALID_FLAGS。 為旗標的值無效。
  • ERROR_INVALID_PARAMETER。 任何參數值都無效。

備註

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

從 Windows 8 開始：如果您的 app 從 Windows.Globalization 命名空間將語言標記傳遞至此函式，則必須先呼叫 ResolveLocaleName 來轉換標記。

規格需求

需求 值
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 winnls.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

EnumDateFormats

EnumDateFormatsEx

EnumDateFormatsProcExEx

國家語言支援

國家語言支援函式