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
Referencias