SDK Multiplataforma en C logo
EspañolEnglish
SDK Multiplataforma en C

Tiempo

❮ Anterior
Siguiente ❯

Acceso al reloj interno del computador.


#Cabecera

#include <osbs/btime.h>


#Funciones

uint64_tbtime_now (void)
voidbtime_date (...)
uint64_tbtime_to_micro (...)
voidbtime_to_date (...)
week_day_tbtime_first_wday (void)
voidbtime_month_name (...)
voidbtime_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.
  • Imagen que muestra el segundo 0 del Unix Epoch.
    Figura 1: Instante 0 del Unix Epoch.

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.

❮ Anterior
Siguiente ❯

#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).

❮ Anterior
Siguiente ❯