Fonction EnumDateFormatsExEx (winnls.h)

Article
03/04/2024

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

Note L’application doit appeler cette fonction de préférence pour EnumDateFormats ou EnumDateFormatsEx si elle est conçue pour s’exécuter uniquement sur Windows Vista et versions ultérieures.

Note Cette fonction peut énumérer les données qui changent d’une version à l’autre, par exemple en raison d’un paramètre régional personnalisé. Si votre application doit conserver ou transmettre des données, consultez Utilisation des données de paramètres régionaux persistants.

Syntaxe

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

Paramètres

[in] lpDateFmtEnumProcExEx

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

[in, optional] lpLocaleName

Pointeur vers un nom de paramètres régionaux ou l’une des valeurs prédéfinies suivantes.

[in] dwFlags

Indicateur spécifiant les formats de date. L’application peut fournir l’une des valeurs suivantes ou la constante LOCALE_USE_CP_ACP .

Valeur	Signification
DATE_SHORTDATE	Utilisez des formats de date courts. Cette valeur ne peut pas être utilisée avec les autres valeurs d’indicateur.
DATE_LONGDATE	Utilisez des formats de date longs. Cette valeur ne peut pas être utilisée avec les autres valeurs d’indicateur.
DATE_YEARMONTH	Utilisez des formats année/mois. Cette valeur ne peut pas être utilisée avec les autres valeurs d’indicateur.
DATE_MONTHDAY	Utilisez des formats mois/jour. Cette valeur ne peut pas être utilisée avec les autres valeurs d’indicateur.

[in] lParam

Paramètre fourni par l’application à passer à la fonction de rappel. Cette valeur est particulièrement utile pour les applications multithread.

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_BADDB. La fonction n’a pas pu accéder aux données. Cette situation ne doit normalement pas se produire, et indique généralement une installation incorrecte, un problème de disque ou autre.
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 .

La fonction énumère les formats de date en passant les pointeurs de chaîne de format de date, un par un, à la fonction de rappel définie par l’application spécifiée, ainsi qu’une constante définie par l’application qui est utile pour les applications multithread. Ce processus se poursuit jusqu’à ce qu’EnumDateFormatsExEx trouve le dernier format de date ou que la fonction de rappel retourne FALSE.

À compter de Windows 8 : si votre application transmet des balises de langue à cette fonction à partir de l’espace de noms Windows.Globalization, elle doit d’abord convertir les balises en appelant ResolveLocaleName.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	winnls.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

EnumDateFormats

EnumDateFormatsEx

EnumDateFormatsProcExExEx

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales

Partager via