Fonction EnumDateFormatsA (winnls.h)

Article
11/20/2024

Énumère les formats de date, de date courte ou d’année/mois longs disponibles pour les paramètres régionaux spécifiés.

Remarque Pour recevoir un identificateur de calendrier en plus des informations de format de date, l’application doit utiliser la fonction EnumDateFormatsEx. Une autre raison de préférer cette fonction est que Microsoft migre vers l’utilisation de noms de paramètres régionaux au lieu d’identificateurs de paramètres régionaux pour les nouveaux paramètres régionaux, pour des raisons d’interopérabilité.

Remarque Toute application qui sera exécutée uniquement sur Windows Vista ou version ultérieure doit utiliser EnumDateFormatsExex en préférence pour EnumDateFormats.

Syntaxe

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

Paramètres

[in] lpDateFmtEnumProc

Pointeur vers une fonction de rappel définie par l’application. Pour plus d’informations, consultez EnumDateFormatsProc.

[in] Locale

identificateur de paramètres régionaux qui spécifie les paramètres régionaux pour lesquels récupérer les informations de format de date. Vous pouvez utiliser la macro MAKELCID pour créer un identificateur ou utiliser l’une des valeurs prédéfinies suivantes.

[in] dwFlags

Indicateur spécifiant les formats de date. Pour obtenir des définitions détaillées, consultez le paramètre dwFlags de EnumDateFormatsExEx.

Valeur de retour

Retourne une valeur différente de zéro si elle réussit ou 0 sinon. Pour obtenir des informations d’erreur étendues, l’application peut appeler GetLastError, qui peut retourner l’un des codes d’erreur suivants :

ERROR_INVALID_FLAGS. Les valeurs fournies pour les indicateurs n’étaient pas valides.
ERROR_INVALID_PARAMETER. L’une des valeurs de paramètre n’est pas valide.

Remarques

Remarque Cette API est mise à jour pour prendre en charge le changement de l’ère japonaise de mai 2019. Si votre application prend en charge le calendrier japonais, vous devez vérifier qu’elle gère correctement la nouvelle ère. Pour plus d’informations, consultez Préparer votre application pour la modification de l’ère japonaise.

Pour plus d’informations sur l’opération de cette fonction, consultez Remarques dans EnumDateFormatsEx.

Remarque Pour énumérer les formats de date des paramètres régionaux avec d’autres calendriers, l’application doit utiliser EnumDateFormatsEx.

Note

L’en-tête winnls.h définit EnumDateFormats comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winnls.h (include Windows.h)
bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

EnumDateFormatsEx

EnumDateFormatsExex

EnumDateFormatsProc

prise en charge des langues nationales

fonctions de prise en charge des langues nationales

Partager via