Namespaces
Variants

tm

From cppreference.net
Definido en el encabezado <time.h>
struct tm ;

Estructura que contiene una fecha y hora del calendario desglosadas en sus componentes.

Contenidos

Objetos miembro

int tm_sec
segundos después del minuto – [ 0 , 61 ] (hasta C99) [ 0 , 60 ] (desde C99) [nota 1]
(objeto miembro público)
int tm_min
minutos después de la hora – [ 0 , 59 ]
(objeto miembro público)
int tm_hour
horas desde medianoche – [ 0 , 23 ]
(objeto miembro público)
int tm_mday
día del mes – [ 1 , 31 ]
(objeto miembro público)
int tm_mon
meses desde enero – [ 0 , 11 ]
(objeto miembro público)
int tm_year
años desde 1900
(objeto miembro público)
int tm_wday
días desde el domingo – [ 0 , 6 ]
(objeto miembro público)
int tm_yday
días desde el 1 de enero – [ 0 , 365 ]
(objeto miembro público)
int tm_isdst
Indicador de Horario de Verano. El valor es positivo si el horario de verano está en efecto, cero si no lo está y negativo si no hay información disponible
(objeto miembro público)
Notas

El Estándar solo exige la presencia de los miembros mencionados anteriormente en cualquier orden. Las implementaciones generalmente agregan más miembros de datos a esta estructura.

  1. El rango permite un segundo intercalar positivo. No se permiten dos segundos intercalares en el mismo minuto (el rango 0..61 de C89 era un defecto)

Ejemplo

#include <stdio.h>
#include <time.h>
int main(void)
{
    struct tm start = {.tm_year = 2022 - 1900, .tm_mday = 1};
    mktime(&start);
    printf("%s", asctime(&start)); // nota: '\n' final implícito
}

Salida:

Sat Jan  1 00:00:00 2022

Referencias

  • Estándar C23 (ISO/IEC 9899:2024):
  • 7.27.1/3 Componentes del tiempo (p: TBD)
  • Estándar C17 (ISO/IEC 9899:2018):
  • 7.27.1/3 Componentes del tiempo (p: 284)
  • Estándar C11 (ISO/IEC 9899:2011):
  • 7.27.1/3 Componentes del tiempo (p: 388)
  • Estándar C99 (ISO/IEC 9899:1999):
  • 7.23.1/3 Componentes del tiempo (p: 338)
  • Estándar C89/C90 (ISO/IEC 9899:1990):
  • 4.12.1 Componentes del tiempo

Véase también

convierte el tiempo desde la época a tiempo calendario expresado como hora local
(función)
convierte el tiempo desde la época a tiempo calendario expresado como Tiempo Universal Coordinado (UTC)
(función)