Tiempo
Acceso al reloj interno del computador.
#Cabecera
#include <osbs/btime.h>
#Funciones
| uint64_t | btime_now (void) |
| void | btime_date (...) |
| uint64_t | btime_to_micro (...) |
| void | btime_to_date (...) |
| week_day_t | btime_first_wday (void) |
| void | btime_month_name (...) |
| void | btime_wday_name (...) |
El sistema operativo mide el paso del tiempo utilizando un reloj interno, implementado típicamente mediante un contador de los ticks que han pasado desde un instante inicial denominado epoch. En sistemas tipo Unix este contador representa el número de segundos transcurridos desde el 1 de Enero de 1970 UTC. Sin embargo, en Windows representa el número de intervalos de 100 nanosegundos desde el 1 de Enero de 1601 coincidiendo con el inicio del calendario Gregoriano. En NAppGUI se han unificado estos valores para trabajar con el Unix Epoch en todas las plataformas.
- Utiliza btime_now para obtener el número de micro-segundos trascurridos desde el 1 de Enero de 1970 UTC.
- Utiliza btime_date para obtener la fecha del sistema.
- Utiliza btime_to_micro y btime_to_date para convertir fechas en Unix Time y viceversa.
La diferencia entre dos instantes nos dará el tiempo transcurrido durante la ejecución de una tarea.
1 2 3 4 5 6 7 |
uint64_t ed, st = btime_now(); // Do something... ... ed = btime_now(); bstd_printf("Total elapsed micro-seconds: %lu\n", ed - st); |
Algunas convenciones del calendario dependen de la configuración regional del usuario, como el día en el que comienza la semana o los nombres de los meses y de los días. Por ejemplo, en España la semana comienza el lunes y en Estados Unidos el domingo. Estos valores se obtienen directamente del sistema operativo, respetando las personalizaciones que haya realizado el usuario.
- Utiliza btime_first_wday para obtener el primer día de la semana.
- Utiliza btime_month_name para obtener el nombre de un mes.
- Utiliza btime_wday_name para obtener el nombre abreviado de un día de la semana.
1 2 3 4 5 6 |
char_t month[64]; char_t wday[16]; week_day_t first = btime_first_wday(); btime_month_name(ekNOVEMBER, month, sizeof(month)); btime_wday_name(first, wday, sizeof(wday)); bstd_printf("%s, week starts on: %s\n", month, wday); |
#btime_now ()
Obtiene el número de micro-segundos trascurridos desde el 1 de Enero de 1970 UTC (Unix Time) hasta este preciso momento. Utiliza la diferencia entre instantes para saber el tiempo consumido por un proceso.
uint64_t btime_now(void);
Retorna
El número de micro-segundos transcurridos, es decir, el número de intervalos de 1/1000000 segundos.
Observaciones
El instante inicial es el 1 de Enero de 1970 en sistemas Unix/Linux y el 1 de Enero de 1601 en Windows ya que es el primer año del ciclo Gregoriano en el que fue activado Windows NT. Esta función equipara ambos inicios, devolviendo siempre el tiempo Unix.
#btime_date ()
Obtiene la fecha actual del sistema.
void btime_date(Date *date);
| date | La fecha actual. |
#btime_to_micro ()
Convierte una fecha en Tiempo Unix.
uint64_t btime_to_micro(const Date *date);
| date | La fecha a convertir. |
Retorna
El número de micro-segundos desde 1 de Enero de 1970 UTC.
#btime_to_date ()
Transforma el Tiempo Unix en una fecha.
void btime_to_date(const uint64_t micro, Date *date);
| micro | Número de micro-segundos desde el 1 de Enero de 1970 UTC. |
| date | Fecha resultado. |
#btime_first_wday ()
Obtiene el primer día de la semana según la configuración regional del usuario.
week_day_t btime_first_wday(void);
Retorna
El primer día de la semana.
#btime_month_name ()
Obtiene el nombre de un mes según la configuración regional del usuario.
void btime_month_name(const month_t month, char_t *name, const uint32_t size);
| month | El mes. |
| name | Buffer donde se escribirá el nombre (UTF-8). |
| size | Tamaño del buffer en bytes. |
Observaciones
Se devuelve el nombre completo en su forma independiente, tal y como aparece en la cabecera de un calendario (p.e. "noviembre" y no "de noviembre"). El uso de mayúsculas depende del idioma.
#btime_wday_name ()
Obtiene el nombre abreviado de un día de la semana según la configuración regional del usuario.
void btime_wday_name(const week_day_t wday, char_t *name, const uint32_t size);
| wday | El día de la semana. |
| name | Buffer donde se escribirá el nombre (UTF-8). |
| size | Tamaño del buffer en bytes. |
Observaciones
Se devuelve la abreviatura más corta que proporcione el sistema operativo, por lo que su longitud puede variar entre plataformas (una, dos o tres letras).


