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

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

  • Статья

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

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

Синтаксис

BOOL EnumDateFormatsW(
  [in] DATEFMT_ENUMPROCW 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 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winnls.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

EnumDateFormatsEx

EnumDateFormatsExEx

EnumDateFormatsProc

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

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