EnumDateFormatsExA, fonction (winnls.h)

  • Article

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

Note Toute application qui s’exécute uniquement sur Windows Vista et versions ultérieures doit utiliser EnumDateFormatsEx de préférence pour cette fonction.
 

Syntaxe

BOOL EnumDateFormatsExA(
  [in] DATEFMT_ENUMPROCEXA lpDateFmtEnumProcEx,
  [in] LCID                Locale,
  [in] DWORD               dwFlags
);

Paramètres

[in] lpDateFmtEnumProcEx

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

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

Windows Vista et versions ultérieures : Les identificateurs de paramètres régionaux personnalisés suivants sont également pris en charge.

[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 en cours de 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 la modification de l’è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. Ce processus se poursuit jusqu’à ce qu’EnumDateFormatsEx trouve le dernier format de date ou que la fonction de rappel retourne FALSE.

Cette fonction énumère tous les formats de date pour les paramètres régionaux spécifiés, y compris les autres calendriers, le cas échéant. Toutefois, l’identificateur de calendrier n’est pas énuméré avec le format de date, ce qui rend difficiles à utiliser pour les paramètres régionaux avec d’autres calendriers.

Cette fonction peut énumérer des données à partir de paramètres régionaux personnalisés. Il n’est pas garanti que les données soient identiques d’un ordinateur à l’autre ou entre les exécutions d’une application. Si votre application doit conserver ou transmettre des données, consultez Utilisation des données de paramètres régionaux persistants.

Lorsque la version ANSI de cette fonction est utilisée avec un identificateur de paramètres régionaux Unicode uniquement, la fonction peut réussir, car le système d’exploitation utilise la page de codes système. Toutefois, les caractères qui ne sont pas définis dans la page de codes système apparaissent dans la chaîne sous la forme d’un point d’interrogation ( ?).

L’application doit utiliser EnumDateFormatsEx (au lieu d’EnumDateFormats) pour énumérer les formats de date des paramètres régionaux avec d’autres calendriers.

Notes

L’en-tête winnls.h définit EnumDateFormatsEx 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. La combinaison 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

EnumDateFormats

EnumDateFormatsEx

EnumDateFormatsProcEx

Prise en charge des langues nationales

Fonctions de prise en charge des langues nationales