Función EnumDateFormatsExEx (winnls.h)

  • Artículo

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

Nota La aplicación debe llamar a esta función en preferencia a EnumDateFormats o EnumDateFormatsEx si está diseñada para ejecutarse solo en Windows Vista y versiones posteriores.

 
Nota Esta función puede enumerar datos que cambian entre versiones, por ejemplo, debido a una configuración regional personalizada. Si la aplicación debe conservar o transmitir datos, consulte Uso de datos de configuración regional persistente.
 

Sintaxis

BOOL EnumDateFormatsExEx(
  [in]           DATEFMT_ENUMPROCEXEX lpDateFmtEnumProcExEx,
  [in, optional] LPCWSTR              lpLocaleName,
  [in]           DWORD                dwFlags,
  [in]           LPARAM               lParam
);

Parámetros

[in] lpDateFmtEnumProcExEx

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

[in, optional] lpLocaleName

Puntero a un nombre de configuración regional o uno de los siguientes valores predefinidos.

[in] dwFlags

Marca que especifica formatos de fecha. La aplicación puede proporcionar uno de los valores siguientes o la constante LOCALE_USE_CP_ACP .

Valor Significado
DATE_SHORTDATE
 Use formatos de fecha corta. Este valor no se puede usar con ninguno de los demás valores de marca.
DATE_LONGDATE
 Use formatos de fecha larga. Este valor no se puede usar con ninguno de los demás valores de marca.
DATE_YEARMONTH
 Use formatos de año/mes. Este valor no se puede usar con ninguno de los demás valores de marca.
DATE_MONTHDAY
 Use formatos de mes/día. Este valor no se puede usar con ninguno de los demás valores de marca.

[in] lParam

Parámetro proporcionado por la aplicación que se va a pasar a la función de devolución de llamada. Este valor es especialmente útil para las aplicaciones multiproceso.

Valor devuelto

Devuelve un valor distinto de cero si es correcto 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_BADDB. La función no pudo acceder a los datos. Esta situación no debería producirse normalmente y normalmente indica una instalación incorrecta, un problema de disco o similar.
  • 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.

Comentarios

Nota Esta API se está actualizando para admitir el cambio de 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 Preparación de la aplicación para el cambio en 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, junto con una constante definida por la aplicación que resulta útil para las aplicaciones multiproceso. Este proceso continúa hasta que EnumDateFormatsExex encuentra el último formato de fecha o la función de devolución de llamada devuelve FALSE.

A partir de Windows 8: si la aplicación pasa etiquetas de idioma a esta función desde el espacio de nombres Windows.Globalization, primero debe convertir las etiquetas mediante una llamada a ResolveLocaleName.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado winnls.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

EnumDateFormats

EnumDateFormatsEx

EnumDateFormatsProcEx

Compatibilidad con idiomas nacionales

Funciones de compatibilidad con idiomas nacionales