Compartir a través de

Función EnumDateFormatsA (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.

Nota Para recibir un identificador de calendario además de la información de formato de fecha, la aplicación debe usar la función EnumDateFormatsEx . Otra razón para preferir esta función es que Microsoft está migrando hacia el uso de nombres de configuración regional en lugar de identificadores de configuración regional por nuevas configuraciones regionales, por motivos de interoperabilidad.
 
Nota Cualquier aplicación que se ejecute solo en Windows Vista o posterior debe usar EnumDateFormatsExEx en preferencia EnumDateFormats.
 

Sintaxis

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

Parámetros

[in] lpDateFmtEnumProc

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

[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.

[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.
 
Para obtener más información sobre el funcionamiento de esta función, vea Comentarios en EnumDateFormatsEx.
Nota Para enumerar los formatos de fecha de las configuraciones regionales con calendarios alternativos, la aplicación debe usar EnumDateFormatsEx.
 

Nota

El encabezado winnls.h define EnumDateFormats 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

EnumDateFormatsEx

EnumDateFormatsExEx

EnumDateFormatsProc

de compatibilidad con idiomas nacionales

funciones de compatibilidad con idiomas nacionales