Функция EnumDateFormatsA (winnls.h)

Статья
11/20/2024

Перечисляет длинные форматы даты, короткой даты или месяца, доступные для указанного языкового стандарта.

Примечание Чтобы получить идентификатор календаря в дополнение к сведениям о формате даты, приложение должно использовать функцию EnumDateFormatsEx. Другая причина, по которой эта функция предпочтительна, заключается в том, что корпорация Майкрософт переносится на использование имен языкового стандарта вместо идентификаторов языкового стандарта для новых языковых стандартов по соображениям взаимодействия.

Примечание Любое приложение, которое будет работать только в Windows Vista или более поздней версии, должно использовать EnumDateFormatsExExEx в предпочтениях EnumDateFormats.

Синтаксис

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

Параметры

[in] lpDateFmtEnumProc

Указатель на функцию обратного вызова, определяемую приложением. Дополнительные сведения см. в разделе EnumDateFormatsProc.

[in] Locale

идентификатор языкового стандарта, указывающий языковой стандарт, для которого требуется получить сведения о формате даты. Вы можете использовать макрос MAKELCID для создания идентификатора или использования одного из следующих предопределенных значений.

[in] dwFlags

Флаг, указывающий форматы дат. Подробные определения см. в параметре dwFlags enumDateFormatsExEx.

Возвращаемое значение

Возвращает ненулевое значение в случае успешного выполнения или 0 в противном случае. Чтобы получить расширенные сведения об ошибке, приложение может вызывать GetLastError, что может возвращать один из следующих кодов ошибок:

ERROR_INVALID_FLAGS. Значения, предоставленные для флагов, недопустимы.
ERROR_INVALID_PARAMETER. Любое из значений параметров было недопустимым.

Замечания

Примечание Этот API обновляется для поддержки изменений в японской эпохе в мае 2019 года. Если приложение поддерживает японский календарь, убедитесь, что оно правильно обрабатывает новую эпоху. Дополнительные сведения см. в подготовке приложения к изменению японской эпохи.

Дополнительные сведения об операции этой функции см. в разделе "Примечания" в EnumDateFormatsEx.

Примечание Чтобы перечислить форматы дат для языковых стандартов с альтернативными календарями, приложение должно использовать EnumDateFormatsEx.

Заметка

Заголовок winnls.h определяет EnumDateFormats как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winnls.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll

См. также

EnumDateFormatsEx

EnumDateFormatsExExex

EnumDateFormatsProc

поддержки национальных языков

функции поддержки национальных языков

Поделиться через