Fonction EnumDateFormatsW (winnls.h)

Article
03/09/2024

Énumère les formats de date longue, de date courte ou d’année/mois disponibles pour un paramètre régional spécifié.

Note 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 régionaux pour les nouveaux paramètres régionaux, pour des raisons d’interopérabilité.

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

Syntaxe

BOOL EnumDateFormatsW(
  [in] DATEFMT_ENUMPROCW 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 des 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 retournée

Retourne une valeur différente de zéro en cas de réussite, ou 0 dans le cas contraire. 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’était pas valide.

Remarques

Note Cette API est mise à jour pour prendre en charge le changement d’è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 le changement d’ère japonaise .

Pour plus d’informations sur le fonctionnement de cette fonction, consultez Remarques dans EnumDateFormatsEx.

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

Notes

L’en-tête winnls.h définit EnumDateFormats comme un 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winnls.h (inclure 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