Función EnumDateFormatsExA (winnls.h)

Enumera los formatos de fecha larga, fecha corta o año/mes que están disponibles para una configuración regional especificada.

Nota Cualquier aplicación que se ejecute solo en Windows Vista y versiones posteriores debe usar EnumDateFormatsExEx en preferencia a esta función.

 

Sintaxis

BOOL EnumDateFormatsExA(
  [in] DATEFMT_ENUMPROCEXA lpDateFmtEnumProcEx,
  [in] LCID                Locale,
  [in] DWORD               dwFlags
);

Parámetros

[in] lpDateFmtEnumProcEx

Puntero a una función de devolución de llamada definida por la aplicación. Para obtener más información, vea EnumDateFormatsProcEx.

[in] Locale

identificador de configuración regional que especifica la configuración regional para la que se va a recuperar la información de formato de fecha. Puede usar la macro MAKELCID para crear un identificador o usar uno de los siguientes valores predefinidos.

• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

Windows Vista y versiones posteriores: también se admiten los siguientes identificadores de configuración regional personalizados.

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

[in] dwFlags

Marca que especifica formatos de fecha. Para obtener definiciones detalladas, consulte el parámetro dwFlags de EnumDateFormatsExEx.

Valor devuelto

Devuelve un valor distinto de cero si se ejecuta correctamente o 0 de lo contrario. Para obtener información de error extendida, la aplicación puede llamar a GetLastError, que puede devolver uno de los siguientes códigos de error:

• ERROR_INVALID_FLAGS. Los valores proporcionados para las marcas no eran válidos.
• ERROR_INVALID_PARAMETER. Cualquiera de los valores de parámetro no era válido.

Observaciones

Nota Esta API se está actualizando para admitir el cambio en la era japonesa de mayo de 2019. Si la aplicación admite el calendario japonés, debe validar que controla correctamente la nueva era. Consulte Preparar la aplicación para el cambio de la era japonesa para obtener más información.

 

La función enumera los formatos de fecha pasando punteros de cadena de formato de fecha, uno a uno, a la función de devolución de llamada definida por la aplicación especificada. Este proceso continúa hasta que EnumDateFormatsEx encuentra el último formato de fecha o la función de devolución de llamada devuelve FALSE.

Esta función enumera todos los formatos de fecha de la configuración regional especificada, incluidos los calendarios alternativos, si los hay. Sin embargo, el identificador de calendario no se enumera junto con el formato de fecha, lo que dificulta el uso de formatos para configuraciones regionales con calendarios alternativos.

Esta función puede enumerar datos de configuraciones regionales personalizadas. No se garantiza que los datos sean los mismos desde el equipo al equipo o entre ejecuciones de una aplicación. Si la aplicación debe conservar o transmitir datos, consulte Uso de datos de configuración regional persistente.

Cuando se usa la versión ANSI de esta función con un identificador de configuración regional de solo Unicode, la función puede realizarse correctamente porque el sistema operativo usa la página de códigos del sistema. Sin embargo, los caracteres que no están definidos en la página de códigos del sistema aparecen en la cadena como signo de interrogación (?).

La aplicación debe usar EnumDateFormatsEx (en lugar de EnumDateFormats) para enumerar formatos de fecha para configuraciones regionales con calendarios alternativos.

Nota

El encabezado winnls.h define EnumDateFormatsEx como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winnls.h (incluya Windows.h)
biblioteca de	Kernel32.lib
DLL de	Kernel32.dll

Consulte también

EnumDateFormats

EnumDateFormatsExEx

EnumDateFormatsProcEx

de compatibilidad con idiomas nacionales

funciones de compatibilidad con idiomas nacionales