Time.h

time.h

Saltar a navegación, búsqueda

time.h 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" (ej: Tue May 15 19:07:04 2008)
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 conversion 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

• Calendar Time (The GNU C Library Reference Manual)
• time.h

Obtenido de "Time.h"