Fechas

Funciones de manipulación de fechas.

Funciones

Date	date_system (void)
Date	date_pack (...)
Date	date_add_seconds (...)
Date	date_add_minutes (...)
Date	date_add_hours (...)
Date	date_add_days (...)
int16_t	date_year (void)
int	date_cmp (...)
int64_t	date_ellapsed_seconds (...)
bool_t	date_between (...)
bool_t	date_is_null (...)
bool_t	date_is_valid (...)
week_day_t	date_weekday (...)
const String*	date_format (...)

Tipos y Constantes

Date	kDATE_NULL

Se incluyen dentro de core una serie de funciones para trabajar con fechas.

Utiliza date_system para obtener la fecha del sistema.
Utiliza date_add_seconds para incrementar una fecha determinada.
Utiliza date_cmp para comparar dos fechas.

kDATE_NULL

Date kDATE_NULL;

Representa una fecha inválida.

date_system ()

Obtiene la fecha del sistema.

Date
date_system(void);

Retorna

La fecha actual.

date_pack ()

Empaqueta una fecha.

Date
date_pack(const int16_t year,
          const uint8_t month,
          const uint8_t mday,
          const uint8_t hour,
          const uint8_t minute,
          const uint8_t second);

year	Año.
month	Número de mes (1,12).
mday	Día del mes (1,31).
hour	Hora (0,23).
minute	Minuto (0,59).
second	Segundo (0,59).

Retorna

La fecha empaquetada.

date_add_seconds ()

Calcula la fecha resultante de añadir una cantidad de segundos a otra fecha.

Date
date_add_seconds(const Date *date,
                 int32_t seconds);

date	La fecha base.
seconds	El número de segundos. Si es positivo obtendremos un fecha futura. Si es negativo una fecha pasada.

Retorna

La fecha resultado.

date_add_minutes ()

Calcula la fecha resultante de añadir una cantidad de minutos a otra fecha.

Date
date_add_minutes(const Date *date,
                 int32_t minutes);

date	La fecha base.
minutes	El número de minutos. Si es positivo obtendremos un fecha futura. Si es negativo una fecha pasada.

Retorna

La fecha resultado.

date_add_hours ()

Calcula la fecha resultante de añadir una cantidad de horas a otra fecha.

Date
date_add_hours(const Date *date,
               int32_t hours);

date	La fecha base.
hours	El número de horas. Si es positivo obtendremos un fecha futura. Si es negativo una fecha pasada.

Retorna

La fecha resultado.

date_add_days ()

Calcula la fecha resultante de añadir una cantidad de días a otra fecha.

Date
date_add_days(const Date *date,
              int32_t days);

date	La fecha base.
days	El número de días. Si es positivo obtendremos un fecha futura. Si es negativo una fecha pasada.

Retorna

La fecha resultado.

date_year ()

Obtiene el año actual.

int16_t
date_year(void);

Retorna

El año actual.

date_cmp ()

Compara dos fechas. La fecha más reciente es considerada mayor.

int
date_cmp(const Date *date1,
         const Date *date2);

date1	Primera fecha a comparar.
date2	Segunda fecha a comparar.

Retorna

Resultado de la comparación.

date_ellapsed_seconds ()

Calcula el número de segundos transcurridos entre dos fechas.

int64_t
date_ellapsed_seconds(const Date *from,
                      const Date *to);

from	Fecha de inicio.
to	Fecha final.

Retorna

Número de segundos. Puede ser negativo, si from es posterior a to.

date_between ()

Comprueba si una fecha está dentro de un intervalo.

bool_t
date_between(const Date *date,
             const Date *from,
             const Date *to);

date	Fecha a comprobar.
from	Fecha de inicio.
to	Fecha final.

Retorna

TRUE si date está entre from y to.

date_is_null ()

Comprueba si una fecha es nula.

bool_t
date_is_null(const Date *date);

date	Fecha a comprobar.

Retorna

TRUE si date es nula.

date_is_valid ()

Comprueba si una fecha es válida.

bool_t
date_is_valid(const Date *date);

date	Fecha a comprobar.

Retorna

TRUE si date es válida.

date_weekday ()

Calcula el día de la semana de una fecha.

week_day_t
date_weekday(const Date *date);

date

Fecha.

Retorna

Día de la semana.

date_format ()

Retorna una cadena con una fecha formateada.

const String*
date_format(const Date *date,
            const char_t *format);

date	Fecha.
format	El formato especificado, basado en `strftime()`.

Retorna

Cadena con la fecha.

Observaciones

Ver Conversión de fechas.