Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

asctime — texte de date et d’heure au format fixe

asctime convertit une struct tm en texte au format fixe. En C23, la fonction est obsolète et doit être évitée dans le nouveau code.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <time.h>
[[deprecated]] char *asctime(const struct tm *timeptr);

asctime, de <time.h>, lit une struct tm et renvoie un pointeur vers du texte : 25 caractères plus \0, avec des abréviations anglaises et un \n final. La fonction ne convertit pas les fuseaux horaires et ne calcule pas le jour de la semaine. tm_mon compte les mois à partir de zéro ; tm_year compte les années depuis 1900.

NULL, des champs hors de leurs plages habituelles ou une année en dehors de 1000–9999 entraînent un comportement indéfini. Le tampon appartient à la bibliothèque : ne le libérez pas ; des appels ultérieurs à asctime ou ctime peuvent l’écraser. La fonction n’est pas réentrante et ne garantit pas l’absence de courses de données. En C23, elle porte l’attribut [[deprecated]] ; pour du nouveau code, préférez strftime avec votre propre tampon.

Exemples

#include <stdio.h>
#include <time.h>

int main(void)
{
    const struct tm value = {
        .tm_year = 123,
        .tm_mon = 0,
        .tm_mday = 1,
        .tm_wday = 0,
        .tm_yday = 0,
        .tm_hour = 12,
        .tm_min = 34,
        .tm_sec = 56,
        .tm_isdst = 0
    };

    return fputs(asctime(&value), stdout) == EOF ? 1 : 0;
}

Résultat

Sun Jan  1 12:34:56 2023

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources