Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

asctime — texto de data e hora com formato fixo

asctime converte uma struct tm em texto com formato fixo. Em C23, a função está obsoleta e deve ser evitada em código novo.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

asctime, de <time.h>, lê uma struct tm e devolve um ponteiro para texto: 25 caracteres mais \0, com abreviaturas em inglês e um \n no final. Não converte fusos horários nem calcula o dia da semana. tm_mon conta os meses a partir de zero; tm_year conta os anos desde 1900.

NULL, campos fora dos intervalos normais ou um ano fora de 1000–9999 provocam comportamento indefinido. O buffer pertence à biblioteca: não o libertes; chamadas posteriores a asctime ou ctime podem sobrescrevê-lo. A função não é reentrante e não garante a ausência de data races. Em C23, está marcada com [[deprecated]]; para código novo, prefere strftime com um buffer próprio.

Exemplos

#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;
}

Resultado

Sun Jan  1 12:34:56 2023

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes