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

Статья
11/20/2024

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

Примечание Любое приложение, которое работает только в 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

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

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

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

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

Замечания

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

Функция перечисляет форматы дат путем передачи указателей строки формата даты (по одному за раз) в указанную функцию обратного вызова, определяемую приложением. Этот процесс продолжается до тех пор, пока EnumDateFormatsEx находит последний формат даты или функция обратного вызова возвращает FALSE.

Эта функция перечисляет все форматы дат для указанного языкового стандарта, включая альтернативные календари, если таковые есть. Однако идентификатор календаря не перечисляется вместе с форматом даты, что делает форматы языковых стандартов с альтернативными календарями трудно использовать.

Эта функция может перечислять данные из пользовательских языковых стандартов . Данные не гарантированы одинаковыми с компьютера на компьютер или между запусками приложения. Если приложение должно сохранять или передавать данные, см. использованиеданных постоянного языкового стандарта.

Если версия этой функции ANSI используется с идентификатором языкового стандарта юникода, функция может завершиться успешно, так как операционная система использует системную кодовую страницу. Однако символы, которые не определены в системной кодовой странице, отображаются в строке как вопросительный знак (?).

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

Заметка

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

Требования

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

См. также

EnumDateFormats

EnumDateFormatsExExex

EnumDateFormatsProcEx

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

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

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