Fonction de la bibliothèque C -strftime()

Bibliothèque standard C - <time.h>

Description

Fonctions de la bibliothèque Csize_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr)SelonformatLes règles de formatage et la structure de formatage définies danstimeptrl'heure représentée, et la stocke dansstr.

Déclaration

Voici la déclaration de la fonction strftime().

size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr)

Paramètre

  • str-- Ceci est un pointeur vers le tableau de destination, utilisé pour copier la chaîne C résultante.
  • maxsize-- C'est le nombre maximum de caractères à copier dans str.
  • format-- Il s'agit d'une chaîne C contenant toute combinaison de caractères ordinaires et de spécificateurs de format spéciaux. La fonction remplace ces spécificateurs de format par les valeurs correspondantes représentant le temps spécifié dans tm. Les spécificateurs de format sont :
SpécificateurRemplacer parExemple
%aNom abrégé du jour de la semainedim.
%ANom complet du jour de la semaineSunday
%bNom abrégé du moismars
%BNom complet du moisMars
%cReprésentation de la date et de l'heuredim. août 19 02:56:02 2012
%dJour du mois (01-31)19
%HHeure au format 24 heures (00-23)14
%IHeure au format 12 heures (01-12)05
%jJour de l'année (001-366)231
%mMois sous forme de nombre décimal (01-12)08
%MMinute (00-59)55
%pNom AM ou PMPM
%SSeconde (00-61)02
%USemaine de l'année, avec le premier dimanche comme premier jour de la première semaine (00-53)33
%wJour de la semaine sous forme de nombre décimal, dimanche représenté par 0 (0-6)4
%WSemaine de l'année, avec le premier lundi comme premier jour de la première semaine (00-53)34
%xReprésentation de la date08/19/12
%XReprésentation de l'heure02:50:06
%yAnnée, deux derniers chiffres (00-99)01
%YAnnée2012
%ZNom ou abréviation du fuseau horaireCDT
%%Un signe %%
  • timeptr-- Ceci est un pointeur vers une structure tm qui contient une heure calendaire décomposée en parties suivantes :
struct tm {
   int tm_sec;         /* 秒,范围从 0 到 59                */
   int tm_min;         /* 分,范围从 0 到 59                */
   int tm_hour;        /* 小时,范围从 0 到 23                */
   int tm_mday;        /* 一月中的第几天,范围从 1 到 31                    */
   int tm_mon;         /* 月份,范围从 0 到 11                */
   int tm_year;        /* 自 1900 起的年数                */
   int tm_wday;        /* 一周中的第几天,范围从 0 到 6                */
   int tm_yday;        /* 一年中的第几天,范围从 0 到 365                    */
   int tm_isdst;       /* 夏令时                        */    
};

Valeur de retour

Si la chaîne C résultante contient moins de size caractères (y compris le caractère de terminaison nul), le nombre total de caractères copiés dans str est renvoyé (à l'exclusion du caractère de terminaison nul) ; sinon, zéro est renvoyé.

Exemple

L'exemple suivant illustre l'utilisation de la fonction strftime().

Exemple

#include <stdio.h> #include <time.h> int main () { time_t rawtime; struct tm *info; char buffer[80]; time( &rawtime ); info = localtime( &rawtime ); strftime(buffer, 80, "%Y-%m-%d %H:%M:%S", info); printf("Date et heure formatées : |%s|\n", buffer ); return(0); }

Compilons et exécutons le programme ci-dessus, ce qui produira le résultat suivant :

格式化的日期 & 时间 : |2018-09-19 08:59:07|

Bibliothèque standard C - <time.h>

autres extensions