CKTIS / C
ctime — função de tempo C23 obsoleta
`ctime(timer)` de `<time.h>` converte o tempo de calendário `time_t` apontado numa cadeia de hora local e devolve o ponteiro do equivalente `asctime(localtime(timer))`. Em C23 é declarada `[[deprecated]]`; é obsoleta e deve ser evitada em código novo.
Versão: C23
Sintaxe
[[deprecated]] char *ctime(const time_t *timer);ctime(timer) de <time.h> converte o tempo de calendário time_t apontado numa cadeia de hora local e devolve o ponteiro do equivalente asctime(localtime(timer)). Em C23 é declarada [[deprecated]]; é obsoleta e deve ser evitada em código novo.
O exemplo passa um time_t zero, verifica o ponteiro e imprime o comprimento e o newline final. Zero era um tempo válido na plataforma testada; C não define a sua época nem codificação. O formato de 25 caracteres só se aplica após conversão bem-sucedida para tempo decomposto com ano entre 1000 e 9999. Fora desse domínio, asctime tem comportamento indefinido, pelo que uma verificação posterior de NULL não valida uma entrada inválida.
O buffer devolvido pode ser sobrescrito por outra conversão que use o mesmo objeto; estas funções não são reentrantes nem têm de evitar data races entre si. Aceder pelo ponteiro após terminar a thread chamadora é UB. Usa localtime_r com um struct tm próprio e depois strftime num buffer próprio.
Exemplos
#include <stdio.h>
#include <string.h>
#include <time.h>
int main(void) {
time_t moment = 0;
char *text = ctime(&moment);
if (text == NULL) return 1;
size_t length = strlen(text);
printf("%zu %d\n", length, length > 0 && text[length - 1] == '\n');
return 0;
}
Resultado
25 1
O exemplo passa um `time_t` zero, verifica o ponteiro e imprime o comprimento e o newline final. Zero era um tempo válido na plataforma testada; C não define a sua época nem codificação. O formato de 25 caracteres só se aplica após conversão bem-sucedida para tempo decomposto com ano entre 1000 e 9999. Fora desse domínio, `asctime` tem comportamento indefinido, pelo que uma verificação posterior de `NULL` não valida uma entrada inválida.