strftime, , wcsftime_strftime_l, ,_wcsftime_l

Mettent en forme une chaîne d’heure.

Syntaxe

size_t strftime(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr
);
size_t _strftime_l(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr,
   _locale_t locale
);
size_t wcsftime(
   wchar_t *strDest,
   size_t maxsize,
   const wchar_t *format,
   const struct tm *timeptr
);
size_t _wcsftime_l(
   wchar_t *strDest,
   size_t maxsize,
   const wchar_t *format,
   const struct tm *timeptr,
   _locale_t locale
);

Paramètres

strDest
Chaîne de sortie.

maxsize
Taille de la mémoire tampon strDest, mesurée en caractères (char ou wchar_t).

format
Chaîne de contrôle de format.

timeptr
Structure de données tm.

locale
Paramètres régionaux à utiliser.

Valeur retournée

strftime retourne le nombre de caractères placés dans strDest et wcsftime retourne le nombre correspondant de caractères larges.

Si le nombre total de caractères, caractère Null de fin inclus, est supérieur à maxsize, strftime et wcsftime retournent 0 et le contenu de strDest est indéterminé.

Le nombre de caractères dans strDest est égal au nombre de caractères littérals dans format, ainsi que tous les caractères pouvant être ajoutés format via des codes de mise en forme. La valeur null de fin d’une chaîne n’est pas comptabilisée dans la valeur de retour.

Notes

Les fonctions et wcsftime formatent la tm valeur de temps en timeptr fonction de l’argument fourni format et stockent le résultat dans la mémoire tamponstrDest.strftime Tout au plus, des caractères maxsize sont placés dans la chaîne. Pour obtenir une description des champs de la timeptr structure, consultez asctime. wcsftime est l’équivalent en caractères larges de strftime ; son argument de pointeur de chaîne pointe vers une chaîne de caractères larges. Ces fonctions se comportent sinon de façon identique.

Cette fonction valide ses paramètres. Si strDest, formatou timeptr est un pointeur Null, ou si la tm structure de données traitée par timeptr n’est pas valide (par exemple, si elle contient des valeurs hors plage pour l’heure ou la date), ou si la format chaîne contient un code de mise en forme non valide, le gestionnaire de paramètres non valide est appelé, comme décrit dans validation de paramètre. Si l’exécution est autorisée à se poursuivre, la fonction retourne 0 et définit errno sur EINVAL.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Mappages de routines de texte générique

L’argument format se compose d’un ou plusieurs codes ; comme dans printf, les codes de mise en forme sont précédés d’un signe de pourcentage (%). Les caractères qui ne commencent % pas par sont copiés sans modification.strDest La catégorie LC_TIME des paramètres régionaux actifs affecte la mise en forme de sortie de strftime. (Pour plus d’informations sur LC_TIME, consultez setlocale.) Les strftime fonctions et wcsftime les fonctions utilisent les paramètres régionaux actuellement définis. Les _strftime_l versions et _wcsftime_l les versions de ces fonctions sont identiques, sauf qu’elles prennent les paramètres régionaux comme paramètre et utilisent cela au lieu des paramètres régionaux actuellement définis. Pour plus d’informations, consultez Locale.

Les strftime fonctions prennent en charge ces codes de mise en forme :

Comme dans la fonction printf, l’indicateur # peut servir de préfixe à n’importe quel code de mise en forme. Dans ce cas, la signification du code de format change comme suit.

La semaine ISO 8601 et l’année hebdomadaire produite par %V, %get %G, utilise une semaine qui commence le lundi. La semaine 1 est la semaine qui contient le quatrième jour de janvier, qui est la première semaine qui comprend au moins quatre jours de l’année. Si le premier lundi de l’année est le 2ème, le 3ème ou le 4ème, les jours précédents font partie de la dernière semaine de l’année précédente. Pour ces jours, %V est remplacé par 53, et les deux %g sont %G remplacés par les chiffres de l’année précédente.

Spécifications

Les _strftime_l fonctions et _wcsftime_l les fonctions sont spécifiques à Microsoft. Pour plus d’informations sur la compatibilité, consultez Compatibility.

Exemple

Consultez l’exemple pour time.

Voir aussi

Paramètres régionaux
Gestion des horaires
Manipulation de chaînes
localeconv
setlocale, _wsetlocale
strcoll, fonctions
strxfrm, , wcsxfrm_strxfrm_l, ,_wcsxfrm_l