STRFTIME |
Format de temps de chaîne de caractères |
---|---|
Langage C++ | ctime (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 | |||
%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 | |||
%d | Ce spécificateur indique d'insérer à cette position le jour du mois avec deux chiffres, soit une valeur entre 01 et 31. | |||
%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. | |||
%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. | |||
%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. | |||
%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. | |||
%S | Ce spécificateur indique d'insérer à cette position les 2 chiffres des secondes, soit une valeur entre 00 et 60. | |||
%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 le fuseau horaire, son nom ou son abréviation. | |||
%% | 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 chaîne de caractères.
Remarques
- La fonction strftime() place les informations d'heure et de date, ainsi que d'autres informations, dans la chaîne de caractères pointée par s selon les commandes de format trouvées dans la chaîne de caractères pointée par format et en utilisant le tm de temps décomposé. Un maximum de caractères max sera placé dans s.
- La fonction strftime() fonctionne un peu comme sprintf() en ce qu'elle reconnaît un ensemble de commandes de format commençant par le signe pourcentage (%) et place sa sortie formatée dans une chaîne de caractères. Les commandes de format sont utilisées pour spécifier la manière exacte dont diverses informations d'heure et de date sont représentées dans s. Tout autre caractère trouvé dans la chaîne de format sont placés dans s inchangés. L'heure et la date affichées sont en heure locale. Notez que de nombreuses format sont sensibles à la casse.
- La fonction strftime() renvoie le nombre de caractères placés dans la chaîne de caractères pointée par s ou zéro si une erreur se produit.
Voir également
Langage de programmation - C pour Linux - Référence procédures et fonctions - strftime
Dernière mise à jour : Vendredi, le 1er mai 2020