Fechas

Funciones de manipulación de fechas.

---

Funciones

Date	date_system (void)
Date	date_add_seconds (...)
Date	date_add_minutes (...)
Date	date_add_hours (...)
Date	date_add_days (...)
int16_t	date_year (void)
int	date_cmp (...)
bool_t	date_between (...)
bool_t	date_is_null (...)
String*	date_DD_MM_YYYY_HH_MM_SS (...)
String*	date_YYYY_MM_DD_HH_MM_SS (...)
const char_t*	date_month_en (...)
const char_t*	date_month_es (...)

---

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_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_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_DD_MM_YYYY_HH_MM_SS ()

Convierte una fecha a string, con el formato DD/MM/YYYY-HH:MM:SS.

String*
date_DD_MM_YYYY_HH_MM_SS(const Date *date);

date

Fecha.

Retorna

Objeto string con la conversión.

---

date_YYYY_MM_DD_HH_MM_SS ()

Convierte una fecha a string, con el formato YYYY/MM/DD-HH:MM:SS.

String*
date_YYYY_MM_DD_HH_MM_SS(const Date *date);

date

Fecha.

Retorna

Objeto string con la conversión.

---

date_month_en ()

Obtiene el nombre del mes, en Inglés.

const char_t*
date_month_en(const month_t month);

month

El mes, normalmente obtenido con btime_date.

Retorna

Cadena UTF8 con el nombre (January, February, ...).

---

date_month_es ()

Obtiene el nombre del mes, en Español.

const char_t*
date_month_es(const month_t month);

month

El mes, normalmente obtenido con btime_date.

Retorna

Cadena UTF8 con el nombre (Enero, Febrero, ...).

---