Nous recommandons d’utiliser Visual Studio 2017

strftime, wcsftime, _strftime_l, _wcsftime_l

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Format de chaîne d’heure.

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 strDest tampon, mesurée en caractères (char ou wchart_t).

format
Chaîne de contrôle de format.

timeptr
tmstructure de données.

locale
Paramètres régionaux à utiliser.

strftimeRetourne le nombre de caractères placée dans strDest et wcsftime renvoie le nombre de caractères larges correspondant.

Si le nombre total de caractères, y compris le caractère null de fin, n’est plus de maxsize, strftime et wcsftime retournent 0 et le contenu de strDest sont indéterminés.

Le nombre de caractères dans strDest est égal au nombre de caractères littéraux dans format , ainsi que tous les caractères qui peuvent être ajoutés au format via les codes de mise en forme. Le caractère null de fin d’une chaîne n’est pas compté dans la valeur de retour.

Le strftime et wcsftime format de fonctions la tm valeur dans timeptr en fonction de l’élément format argument et le résultat dans la mémoire tampon de magasin strDest . Au maximum maxsize caractères sont placés dans la chaîne. Pour obtenir une description des champs dans le timeptr de la structure, consultez asctime. wcsftimeéquivaut à caractères larges strftime; son argument de pointeur de chaîne pointe vers une chaîne à caractères larges. Ces fonctions se comportent sinon de façon identique.

System_CAPS_ICON_note.jpg Remarque

Dans les versions antérieures de Visual C++ 2005, la documentation décrit la format paramètre de wcsftime comme ayant les données de type const wchar_t *, mais l’implémentation réelle de la format type de données a été const char *. L’implémentation de la formattype de données a été mis à jour pour refléter la documentation précédente et actuelle, c'est-à-dire const wchar_t *.

Cette fonction valide ses paramètres. Si strDest, format, outimeptr est un pointeur null, ou si le tm structure de données traité par timeptr n’est pas valide (par exemple, s’il contient des valeurs hors limites pour la date ou heure), ou si le format chaîne contient un code de mise en forme non valide, le Gestionnaire de paramètre 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 à EINVAL.

Mappages de routines de texte générique

Routine TCHAR.H_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_tcsftimestrftimestrftimewcsftime

Le format argument se compose d’un ou plusieurs codes ; comme dans printf, les codes de mise en forme sont précédées par un signe de pourcentage (%). Les caractères qui ne commencent pas par % sont copiées telles quelles à strDest . Le LC_TIME catégorie de paramètres régionaux actuels affecte la sortie de la mise en forme de strftime. (Pour plus d’informations sur LC_TIME, consultez setlocale.) Les fonctions sans le _l suffixe utiliser la paramètres régionaux. Les versions de ces fonctions avec le _l suffixe sont identiques, sauf qu’ils considèrent les paramètres régionaux en tant que paramètre et l’utilisent au lieu de la paramètres régionaux. Pour plus d’informations, consultez Locale.

La mise en forme les codes de strftime sont répertoriées ci-dessous :

%a
Nom de jour abrégé

%A
Nom de jour complet

%b
Nom de mois abrégé

%B
Nom complet du mois

%c
Représentation sous forme de date et d’heure, approprié pour les paramètres régionaux

%d
Jour du mois sous forme décimale (01 à 31)

%H
Heure au format 24 heures (00-23)

%I
Heure au format 12 heures (01-12)

%j
Jour de l’année sous forme décimale (001-366)

%m
Mois sous forme décimale (01-12)

%M
Minute sous forme de nombre décimal (00-59)

%p
P.M. de paramètre régional actuel. indicateur d’horloge de 12 heures

%S
Deuxième en tant que nombre décimal (00-59)

%U
Semaine de l’année sous la forme d’un nombre décimal, dimanche étant le premier jour de la semaine (00-53)

%w
Jour de la semaine sous forme décimale (0-6. Dimanche est 0)

%W
Semaine de l’année sous la forme d’un nombre décimal, lundi étant le premier jour de la semaine (00-53)

%x
Représentation sous forme de date pour les paramètres régionaux actuels

%X
Représentation sous forme de temps pour les paramètres régionaux actuels

%y
Année sans siècle, sous forme de nombre décimal (00-99)

%Y
Année avec siècle, sous forme de nombre décimal

%z, %Z
Le nom du fuseau horaire ou abréviation du fuseau horaire, en fonction des paramètres de Registre ; aucun caractère si le fuseau horaire est inconnu

%%
Symbole de pourcentage

Comme dans le printf (fonction), la # indicateur peut précéder n’importe quel code de mise en forme. Dans ce cas, la signification du code de format est modifiée comme suit.

Code du formatSignification
%#a, %#A, %#b, %#B, %#p, %#X, %#z, %#Z, %#%#indicateur est ignoré.
%#cLong date et heure de représentation, appropriée pour les paramètres régionaux actuels. Par exemple : « Mardi, mars 14 1995, 12:41:29 ».
%#xReprésentation de date longue appropriée aux paramètres régionaux actuels. Par exemple : « Mardi 14 mars 1995 ».
%#d, %#H, %#I, %#j, %#m, %#M, %#S, %#U, %#w, %#W, %#y, %#YSupprimer les zéros non significatifs (le cas échéant).
RoutineEn-tête requis
strftime<time.h>
wcsftime<time.h>ou<wchar.h></wchar.h></time.h>
_strftime_l<time.h>
_wcsftime_l<time.h>ou<wchar.h></wchar.h></time.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité dans l'introduction.

Consultez l’exemple de temps.

Paramètres régionaux
Gestion du temps
Manipulation de chaînes
localeconv
SetLocale, _wsetlocale
strcoll (fonctions)
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l

Afficher: