enumDateFormatsA 函数 (winnls.h)

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

注意 若要接收日历标识符以及日期格式信息,应用程序应使用 EnumDateFormatsEx 函数。 首选此函数的另一个原因是,出于互操作性的原因,Microsoft 正在迁移到使用区域设置名称而不是新区域设置的区域设置标识符。
 
注意 将仅在 Windows Vista 或更高版本上运行的任何应用程序都应优先使用 EnumDateFormatsExExEx, 而不是 EnumDateFormats
 

语法

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

参数

[in] lpDateFmtEnumProc

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

[in] Locale

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

[in] dwFlags

指定日期格式的标志。 有关详细定义,请参阅 EnumDateFormatsExExEx 的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 [仅限桌面应用]
目标平台 Windows
标头 winnls.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

EnumDateFormatsEx

EnumDateFormatsExExEx

EnumDateFormatsProc

国家/地区语言支持

国家/地区语言支持函数