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

Fechas

❮ Anterior
Siguiente ❯

Funciones de manipulación de fechas.


#Cabecera

#include <core/date.h>


#Funciones

Datedate_system (void)
Datedate_pack (...)
Datedate_add_seconds (...)
Datedate_add_minutes (...)
Datedate_add_hours (...)
Datedate_add_days (...)
int16_tdate_year (void)
intdate_cmp (...)
int64_tdate_ellapsed_seconds (...)
bool_tdate_between (...)
bool_tdate_is_null (...)
bool_tdate_is_valid (...)
week_day_tdate_weekday (...)
bool_tdate_is_leap (...)
uint8_tdate_month_days (...)
int32_tdate_to_days (...)
Datedate_from_days (...)
const String*date_format (...)

#Tipos y Constantes

DatekDATE_NULL

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

❮ Anterior
Siguiente ❯

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

Retorna

Cadena con la fecha.

Observaciones

Ver Conversión de fechas.

❮ Anterior
Siguiente ❯