Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

ctime — función de tiempo obsoleta de C23

`ctime(timer)` de `<time.h>` convierte el tiempo de calendario `time_t` señalado en una cadena de hora local y devuelve el puntero del equivalente `asctime(localtime(timer))`. En C23 se declara `[[deprecated]]`; es obsoleta y debe evitarse en código nuevo.

Versión: C23

Sintaxis

[[deprecated]] char *ctime(const time_t *timer);

ctime(timer) de <time.h> convierte el tiempo de calendario time_t señalado en una cadena de hora local y devuelve el puntero del equivalente asctime(localtime(timer)). En C23 se declara [[deprecated]]; es obsoleta y debe evitarse en código nuevo.

El ejemplo pasa un time_t cero, comprueba el puntero e imprime la longitud y el salto de línea final. Cero era un tiempo válido en la plataforma probada; C no define su época ni su codificación. El formato de 25 caracteres solo se aplica tras convertir correctamente a tiempo desglosado con año entre 1000 y 9999. Fuera de ese dominio, asctime tiene comportamiento indefinido, así que una comprobación posterior de NULL no valida una entrada no válida.

El búfer devuelto puede ser sobrescrito por otra conversión que use el mismo objeto; estas funciones no son reentrantes ni tienen que evitar data races entre sí. Acceder mediante el puntero tras terminar el hilo llamador es UB. Usa localtime_r con un struct tm propio y después strftime en un búfer propio.

Ejemplos

#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

El ejemplo pasa un `time_t` cero, comprueba el puntero e imprime la longitud y el salto de línea final. Cero era un tiempo válido en la plataforma probada; C no define su época ni su codificación. El formato de 25 caracteres solo se aplica tras convertir correctamente a tiempo desglosado con año entre 1000 y 9999. Fuera de ese dominio, `asctime` tiene comportamiento indefinido, así que una comprobación posterior de `NULL` no valida una entrada no válida.

Fuentes