time.h

time.h relacionado con formato de hora y fecha es un archivo de cabecera de la biblioteca estándar del lenguaje de programación C que contiene funciones para manipular y formatear la fecha y hora del sistema.

Funciones

Nombre	Descripción
`char * asctime(struct tm *)`	Recibe una variable de tipo puntero a estructura tm (`struct tm`) y devuelve una cadena de caracteres cuyo formato es: "Www Mmm dd hh:mm:ss yyyy\n" (ej: Tue May 15 19:07:04 2008\n*)
`clock_t clock (void)`	Devuelve el número de pulsos de reloj desde que se inició el proceso.
`char * ctime(time_t *)`	Recibe una variable de tipo puntero a `time_t` (`time t*`) y devuelve una cadena con el mismo formato que `asctime()`
`double difftime(time_t, time t)`	Recibe dos variables de tipo `time_t`, calcula su diferencia y devuelve el resultado (`double`) expresado en segundos.
`struct tm gmtime(time_t )`	Recibe un puntero a una variable de tiempo (`time_t*`) y devuelve su conversión como fecha/hora UTC a `struct tm` a través de un puntero.
`struct tm localtime(time_t )`	Similar funcionalidad a `gmtime()`, pero devuelve la conversión como fecha/hora LOCAL.
`time_t mktime(struct_tm *)`	Inversamente a `gmtime()` y `localtime()`,l recibe un puntero a `struct tm` (`struct tm*`) y devuelve su conversión al tipo `time t`.
`time_t time(time_t *)`	Devuelve la fecha/hora (`time_t`) actual o -1 en caso de no ser posible. Si el argumento que se le pasa no es NULL, también asigna la fecha/hora actual a dicho argumento.
`size_t strftime(char ,size_t,char ,struct tm *)`	Formatea la información pasada mediante la estructura (`struct tm`) mediante el formato indicado en una cadena (`char`) e imprime el resultado sobre otra cadena (`char*`) hasta un límite de caracteres (`size_t`).

Constantes

Nombre	Descripción
`CLK_PER_SEC`	Constante que define el número de pulsos de reloj por segundo; usado por la función `clock()`
`CLOCKS_PER_SEC`	nombre alternativo para `CLK_PER_SEC` usado en su lugar en algunas bibliotecas
`CLK_TCK`	usualmente una macro para `CLK_PER_SEC`

Tipos de datos

Nombre	Descripción
`clock_t`	tipo de dato devuelto por `clock()`, generalmente un `long int`
`time t`	tipo de dato devuelto por `time()`, generalmente un `long int`
`struct tm`	representación del tiempo en formato de calendario (fecha/hora)

Fecha (día/hora) de calendario

La fecha de calendario se representa como la estructura struct tm, que consta de los siguientes atributos:

Atributo	Descripción
`int tm_hour`	hora (0 - 23)
`int tm_isdst`	Horario de verano enabled/disabled
`int tm_mday`	día del mes (1 - 31)
`int tm_min`	minutos (0 - 59)
`int tm_mon`	mes (0 - 11, 0 = Enero)
`int tm_sec`	segundos (0 - 60)
`int tm_wday`	día de la semana (0 - 6, 0 = domingo)
`int tm_yday`	día del año (0 - 365)
`int tm_year`	año desde 1900

Véase también

Lenguaje de programación C

Referencias

Datos: Q306163