Fechas
Funciones de manipulación de fechas.
#Cabecera
#include <core/date.h>
#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 (...) |
| bool_t | date_is_leap (...) |
| uint8_t | date_month_days (...) |
| int32_t | date_to_days (...) |
| Date | date_from_days (...) |
| 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.
- Utiliza date_month_days para obtener el número de días de un mes.
- Utiliza date_to_days para convertir una fecha en un número de días.
- Utiliza date_from_days para convertir un número de días en una fecha.
#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.
Observaciones
Se admite cualquier año representable en int16_t (de -32768 a 32767), siguiendo el calendario gregoriano proléptico con numeración astronómica de años (el año 0 equivale al 1 a.C.).
#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_is_leap ()
Comprueba si un año es bisiesto, según el calendario gregoriano.
bool_t date_is_leap(const int16_t year);
| year | Año. |
Retorna
TRUE si year es bisiesto.
#date_month_days ()
Obtiene el número de días de un mes.
uint8_t date_month_days(const int16_t year, const month_t month);
| year | Año. Necesario para conocer los días de febrero. |
| month | Mes. |
Retorna
Número de días (28, 29, 30 o 31).
#date_to_days ()
Convierte una fecha en el número de días transcurridos desde el 1 de enero de 1970.
int32_t date_to_days(const Date *date);
| date | Fecha. Se ignoran la hora, los minutos y los segundos. |
Retorna
Número de días. El 1 de enero de 1970 es el día 0, los días anteriores son negativos y los posteriores positivos.
Observaciones
Utiliza el calendario gregoriano proléptico con numeración astronómica de años, por lo que el resultado no depende de la zona horaria ni del sistema operativo. Es la representación que utiliza DateView al vincularse con campos int32_t (Particularidades de cada control).
#date_from_days ()
Convierte un número de días transcurridos desde el 1 de enero de 1970 en una fecha.
Date date_from_days(const int32_t days);
| days | Número de días. El 1 de enero de 1970 es el día 0. |
Retorna
La fecha, a las 00:00:00 y con el día de la semana calculado.
Observaciones
Los valores fuera del rango de Date (años de -32768 a 32767) se ajustan al límite más cercano.
#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 |
Retorna
Cadena con la fecha.
Observaciones
Ver Conversión de fechas.


