EnumDateFormatsA 函数 （winnls.h）

枚举可用于指定区域设置的长日期、短日期或年份/月格式。

注释 除了日期格式信息之外，应用程序还应使用 EnumDateFormatsEx 函数来接收日历标识符。 首选此函数的另一个原因是，出于互操作性原因，Microsoft迁移到使用区域设置名称而不是区域设置标识符。

 

注意 任何仅在 Windows Vista 或更高版本上运行的应用程序都应使用 EnumDateFormatsEx，而不是 EnumDateFormats。

 

语法

BOOL EnumDateFormatsA(
  [in] DATEFMT_ENUMPROCA lpDateFmtEnumProc,
  [in] LCID              Locale,
  [in] DWORD             dwFlags
);

参数

[in] lpDateFmtEnumProc

指向应用程序定义的回调函数的指针。 有关详细信息，请参阅 EnumDateFormatsProc。

[in] Locale

区域设置标识符，用于指定要为其检索日期格式信息的区域设置。 可以使用 MAKELCID 宏创建标识符或使用以下预定义值之一。

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED
• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

[in] dwFlags

指定日期格式的标志。 有关详细定义，请参阅 EnumDateFormatsEx的 dwFlags 参数。

返回值

如果成功，则返回非零值，否则返回 0。 若要获取扩展的错误信息，应用程序可以调用 GetLastError，这会返回以下错误代码之一：

• ERROR_INVALID_FLAGS。 为标志提供的值无效。
• ERROR_INVALID_PARAMETER。 任何参数值都无效。

言论

注意 此 API 正在更新，以支持 2019 年 5 月日本时代更改。 如果应用程序支持日语日历，则应验证它是否能够正确处理新纪元。 有关详细信息，请参阅 为日本时代更改准备应用程序。

 

有关此函数的操作的详细信息，请参阅 EnumDateFormatsEx中的备注。

注意 若要使用备用日历枚举区域设置的日期格式，应用程序应使用 EnumDateFormatsEx。

 

注意

winnls.h 标头将 EnumDateFormats 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
目标平台	窗户
标头	winnls.h （包括 Windows.h）
库	Kernel32.lib
DLL	Kernel32.dll

另请参阅

EnumDateFormatsEx

EnumDateFormatsExEx

EnumDateFormatsProc

国家语言支持

国家语言支持函数