strftime ()- Convertir la date / l'heure en chaîne

Format

#include <time.h>
size_t strftime(char *s, size_t maxsize, const char *format,
                   const struct tm *timeptr);

Niveau de langue

American National Standards Institute

Unités d'exécution protégées

Oui

Sensible à l'environnement local

Le comportement de cette fonction peut être affecté par les catégories LC_CTYPE, LC_TIME et LC_TOD de l'environnement local en cours. Pour plus d'informations, voir Présentation des CCSID et des environnements locaux.

Description

La fonction strftime() place les octets dans le tableau désigné par s comme contrôlé par la chaîne indiquée par format. La chaîne de format se compose de zéro ou plusieurs spécifications de conversion et de caractères ordinaires. Une spécification de conversion se compose d'un caractère% et d'un caractère de fin de conversion qui détermine le comportement de la conversion. Tous les caractères ordinaires (y compris les caractères nuls de fin et les caractères multi-octets) sont copiés tels quels dans le tableau. Si la copie a lieu entre des objets qui se chevauchent, le comportement n'est pas défini. Un maximum de maxsize octets est placé dans le tableau. Les caractères appropriés sont déterminés par les valeurs contenues dans la structure pointée par timeptret par les valeurs stockées dans l'environnement local en cours.

Spécificateurs de conversion modifiés

Certains spécificateurs de conversion peuvent être modifiés par les caractères de modification E ou O pour indiquer qu'un format ou une spécification de remplacement doit être utilisé plutôt que celui normalement utilisé par le spécificateur de conversion non modifié. Si un spécificateur de conversion modifié utilise une zone de l'environnement local en cours qui n'est pas disponible, le comportement sera comme si la spécification de conversion non modifiée était utilisée. Par exemple, si la chaîne era est la chaîne vide "", ce qui signifie que la chaîne n'est pas disponible, alors %EY se comporte comme %Y.

Valeur renvoyée

Si le nombre total d'octets résultants, y compris l'octet null de fin, n'est pas supérieur à maxsize, strftime() renvoie le nombre d'octets placés dans le tableau désigné par s, à l'exclusion de l'octet null de fin. Sinon, 0 est renvoyé et le contenu du tableau est indéterminé.

Exemple

#include <stdio.h>
#include <time.h>
 
int main(void)
{
     char s[100];
     int rc;
     time_t temp;
     struct tm *timeptr;

     temp = time(NULL);
     timeptr = localtime(&temp);

     rc = strftime(s,sizeof(s),"Today is %A, %b %d.\nTime:  %r", timeptr);
     printf("%d characters written.\n%s\n",rc,s);

     return 0;
}

/*************************************************
     The output should be similar to:
     46 characters written
     Today is Wednesday, Oct 24.
     Time:  01:01:15 PM
************************************************************/

Rubriques connexes