STRFTIME |
Format de temps de chaîne de caractères |
---|---|
time.h |
Syntaxe
size_t strftime(char *s, size_t max, const char *format, const struct tm *tm); |
Paramètres
Nom | Description | |||
---|---|---|---|---|
s | Ce paramètre permet d'indiquer la chaîne de caractères recevant les données demandés. | |||
max | Ce paramètre permet d'indiquer la taille maximal que peut contenir la chaîne de caractères. | |||
format | Ce paramètre permet d'indiquer le format souhaité pour la date et l'heure. Il est a noter qu'un ou plusieurs des spécificateurs suivants peuvent être inclus dans le texte et il utilisera un argument supplémentaire pour chaque spécificateurs : | |||
Spécificateur | Description | |||
%a | Ce spécificateur indique d'insérer à cette position l'abréviation du nom du jour de la semaine en accord avec la région locale | |||
%A | Ce spécificateur indique d'insérer à cette position le nom complet du jour de la semaine en accord avec la région locale | |||
%b | Ce spécificateur indique d'insérer à cette position l'abréviation du nom du mois en accord avec la région locale | |||
%B | Ce spécificateur indique d'insérer à cette position le nom complet du mois en accord avec la région locale | |||
%c | Ce spécificateur indique d'insérer à cette position la représentation préféré de date et heure en accord avec la région locale | |||
%C | Ce spécificateur indique d'insérer à cette position le numéro du siècle avec deux chiffres. | |||
%d | Ce spécificateur indique d'insérer à cette position le jour du mois avec deux chiffres, soit une valeur entre 01 et 31. | |||
%D | Ce spécificateur indique d'insérer à cette position le format «%m/%d/%y». | |||
%e | Ce spécificateur indique d'insérer à cette position le jour du mois sans zéro si la taille est inférieur à 2, soit une valeur entre 1 et 31. | |||
%E | Ce spécificateur indique d'insérer à cette position un format alternatif. | |||
%F | Ce spécificateur indique d'insérer à cette position le format «%Y-%m-%d», soit une date de format ISO 8601. | |||
%G | Ce spécificateur indique d'insérer à cette position une année de format ISO 8601, lequel contient 4 chiffres. | |||
%g | Ce spécificateur indique d'insérer à cette position une année sans le siècle, lequel contient 2 chiffres, soit une valeur entre 00 et 99. | |||
%H | Ce spécificateur indique d'insérer à cette position l'heure en format 24 heures avec toujours 2 chiffres, soit une valeur entre 00 et 23. | |||
%h | Ce spécificateur indique d'insérer à cette position l'abréviation du nom du mois en accord avec la région courante | |||
%I | Ce spécificateur indique d'insérer à cette position l'heure en format 12 heures avec toujours 2 chiffres, soit une valeur entre 01 et 12. | |||
%j | Ce spécificateur indique d'insérer à cette position le jour de l'année avec toujours 3 chiffres, soit une valeur entre 001 et 366. | |||
%k | Ce spécificateur indique d'insérer à cette position l'heure en format 24 heures avec un espace blanc précédent un chiffre seul, soit une valeur entre 0 et 23. | |||
%l | Ce spécificateur indique d'insérer à cette position l'heure en format 12 heures avec un espace blanc précédent un chiffre seul, soit une valeur entre 1 et 12. | |||
%m | Ce spécificateur indique d'insérer à cette position le numéro du mois avec toujours 2 chiffres, soit une valeur entre 01 et 12. | |||
%M | Ce spécificateur indique d'insérer à cette position les minutes avec toujours 2 chiffres, soit une valeur entre 00 et 59. | |||
%n | Ce spécificateur indique d'insérer à cette position un caractère de nouvelle ligne. | |||
%O | Ce spécificateur indique d'insérer à cette position un format alternative. | |||
%p | Ce spécificateur indique d'insérer à cette position en majuscule AM (avant-midi) ou PM (après-midi) de la valeur de l'heure en accord avec la région locale. | |||
%P | Ce spécificateur indique d'insérer à cette position en minuscule AM (avant-midi) ou PM (après-midi) de la valeur de l'heure en accord avec la région locale. | |||
%r | Ce spécificateur indique d'insérer à cette position l'heure complète avec l'indicateur AM/PM, soit l'équivalent du format «%I:%M:%S %p». | |||
%R | Ce spécificateur indique d'insérer à cette position l'heure et les minutes en format 24 heures, soit l'équivalent du format «%H:%M». | |||
%s | Ce spécificateur indique d'insérer à cette position le nombre de secondes passés depuis le 1er janvier 1970, 00:00:00 en heure universel UTC. | |||
%S | Ce spécificateur indique d'insérer à cette position les 2 chiffres des secondes, soit une valeur entre 00 et 60. | |||
%t | Ce spécificateur indique d'insérer à cette position un caractère de tabulation. | |||
%T | Ce spécificateur indique d'insérer à cette position l'heure long au format 24 heures, soit l'équivalent du format «%H:%M:%S». | |||
%u | Ce spécificateur indique d'insérer à cette position le numéro du jour de la semaine, soit une valeur entre 1 et 7, où 1 correspond à Lundi, 2 à Mardi,... | |||
%U | Ce spécificateur indique d'insérer à cette position le numéro de la semaine de l'année courante, soit une valeur entre 00 et 53. | |||
%V | Ce spécificateur indique d'insérer à cette position le numéro de la semaine de l'année courante au format ISO 8601:1988, soit une valeur entre 01 et 53. | |||
%w | Ce spécificateur indique d'insérer à cette position le numéro du jour de la semaine, soit une valeur entre 0 et 6, où 0 correspond à Dimanche, 1 à Lundi,... | |||
%W | Ce spécificateur indique d'insérer à cette position le numéro de la semaine courante de l'année en 2 chiffres, soit une valeur 00 et 53. | |||
%x | Ce spécificateur indique d'insérer à cette position une représentation de la date courante sans l'heure. | |||
%X | Ce spécificateur indique d'insérer à cette position une représentation de l'heure courante sans l'heure. | |||
%y | Ce spécificateur indique d'insérer à cette position l'année avec 2 chiffres seulement ou sans les siècles, soit une valeur entre 00 et 99. | |||
%Y | Ce spécificateur indique d'insérer à cette position l'année avec 4 chiffres. | |||
%z | Ce spécificateur indique d'insérer à cette position l'heure selon le fuseaux horaire de Greenwich. | |||
%Z | Ce spécificateur indique d'insérer à cette position le fuseau horaire, son nom ou son abréviation. | |||
%+ | Ce spécificateur indique d'insérer à cette position la date et l'heure du format date. Ce spécificateur n'est pas supporté par le glibc2. | |||
%% | Ce spécificateur indique d'insérer à cette position le caractère «%». | |||
tm | Ce paramètre permet d'indiquer la structure de données contenant les informations de temps : | |||
Nom | Type de données | Description | ||
tm_sec | int | Ce champ permet d'indiquer les secondes, soit une valeur entre l'intervalle 0 et 61. | ||
tm_min | int | Ce champ permet d'indiquer les minutes, soit une valeur entre l'intervalle 0 et 59. | ||
tm_hour | int | Ce champ permet d'indiquer les heures, soit une valeur entre l'intervalle 0 et 23. | ||
tm_mday | int | Ce champ permet d'indiquer le jour du mois, soit une valeur entre l'intervalle 1 et 31. | ||
tm_mon | int | Ce champ permet d'indiquer le mois de l'année : | ||
Valeur | Description | |||
0 | Cette valeur permet d'indiquer le mois de Janvier. | |||
1 | Cette valeur permet d'indiquer le mois de Février. | |||
2 | Cette valeur permet d'indiquer le mois de Mars. | |||
3 | Cette valeur permet d'indiquer le mois d'Avril. | |||
4 | Cette valeur permet d'indiquer le mois de Mai. | |||
5 | Cette valeur permet d'indiquer le mois de Juin. | |||
6 | Cette valeur permet d'indiquer le mois de Juillet. | |||
7 | Cette valeur permet d'indiquer le mois d'Août. | |||
8 | Cette valeur permet d'indiquer le mois de Septembre. | |||
9 | Cette valeur permet d'indiquer le mois d'Octobre. | |||
10 | Cette valeur permet d'indiquer le mois de Novembre. | |||
11 | Cette valeur permet d'indiquer le mois de Décembre. | |||
tm_year | int | Ce champ permet d'indiquer l'année après 1900. | ||
tm_wday | int | Ce champ permet d'indiquer le jour de la semaine : | ||
Valeur | Description | |||
0 | Cette valeur permet d'indiquer le Dimanche. | |||
1 | Cette valeur permet d'indiquer le Lundi. | |||
2 | Cette valeur permet d'indiquer le Mardi. | |||
3 | Cette valeur permet d'indiquer le Mercredi. | |||
4 | Cette valeur permet d'indiquer le Jeudi. | |||
5 | Cette valeur permet d'indiquer le Vendredi. | |||
6 | Cette valeur permet d'indiquer le Samedi. | |||
tm_yday | int | Ce champ permet d'indiquer le jour de l'année, soit une valeur entre l'intervalle 0 et 365. | ||
tm_isdst | int | Ce champ permet d'indiquer le jour d'été ou avancé. |
Description
Cette fonction permet d'effectuer la conversion des informations de date et de l'heure en une chaine de caractères.
Exemple
Voici un exemple montrant un simple affichage de l'heure courante :
on obtiendra le résultat suivant si vous êtes le 31 juillet 2010 à 14:59:31 :
Sat, 31 Jul 2010 14:59:31 Est (heure d'été)
Dernière mise à jour : Dimanche, le 21 février 2016