# Objetos DateTime

El módulo `datetime` proporciona varios objetos de fecha y hora. Antes de usar cualquiera de estas funciones, el archivo de encabezado `datetime.h` debe estar incluido en su fuente (tenga en cuenta que esto no está incluido en el archivo `Python.h`), y la macro `PyDateTime_IMPORT` debe llamarse, generalmente como parte de la función de inicialización del módulo. La macro coloca un puntero a una estructura C en una variable estática, `PyDateTimeAPI`, que utilizan las siguientes macros.

Macro para acceder al singleton UTC:

PyObject* `PyDateTime_TimeZone_UTC`

  Retorna la zona horaria singleton que representa UTC, el mismo objeto que `datetime.timezone.utc`.

  Nuevo en la versión 3.7.

Macros de verificación de tipo:

int `PyDate_Check`(PyObject *ob)

  Retorna verdadero si ob es de tipo `PyDateTime_DateType` o un subtipo de `PyDateTime_DateType`. ob no debe ser `NULL`. Esta función siempre finaliza con éxito.

int `PyDate_CheckExact`(PyObject *ob)

  Retorna verdadero si ob es de tipo `PyDateTime_DateType`. ob no debe ser `NULL`. Esta función siempre finaliza con éxito.

int `PyDateTime_Check`(PyObject *ob)

  Retorna verdadero si ob es de tipo `PyDateTime_DateTimeType` o un subtipo de `PyDateTime_DateTimeType`. ob no debe ser `NULL`. Esta función siempre finaliza con éxito.

int `PyDateTime_CheckExact`(PyObject *ob)

  Retorna verdadero si ob es de tipo `PyDateTime_DateTimeType`. ob no debe ser `NULL`. Esta función siempre finaliza con éxito.

int `PyTime_Check`(PyObject *ob)

  Retorna verdadero si ob es de tipo `PyDateTime_TimeType` o un subtipo de `PyDateTime_TimeType`. ob no debe ser `NULL`. Esta función siempre finaliza con éxito.

int `PyTime_CheckExact`(PyObject *ob)

  Retorna verdadero si ob es de tipo `PyDateTime_TimeType`. ob no debe ser `NULL`. Esta función siempre finaliza con éxito.

int `PyDelta_Check`(PyObject *ob)

  Retorna verdadero si ob es de tipo `PyDateTime_DeltaType` o un subtipo de `PyDateTime_DeltaType`. ob no debe ser `NULL`. Esta función siempre finaliza con éxito.

int `PyDelta_CheckExact`(PyObject *ob)

  Retorna verdadero si ob es de tipo `PyDateTime_DeltaType`. ob no debe ser `NULL`. Esta función siempre finaliza con éxito.

int `PyTZInfo_Check`(PyObject *ob)

  Retorna verdadero si ob es de tipo `PyDateTime_TZInfoType` o un subtipo de `PyDateTime_TZInfoType`. ob no debe ser `NULL`. Esta función siempre finaliza con éxito.

int `PyTZInfo_CheckExact`(PyObject *ob)

  Retorna verdadero si ob es de tipo `PyDateTime_TZInfoType`. ob no debe ser `NULL`. Esta función siempre finaliza con éxito.

Macros para crear objetos:

PyObject* `PyDate_FromDate`(int year, int month, int day)
  Return value: New reference.

  Retorna un objeto `datetime.date` con el año, mes y día especificados.

PyObject* `PyDateTime_FromDateAndTime`(int year, int month, int day, int hour, int minute, int second, int usecond)
  Return value: New reference.

  Retorna un objeto `datetime.datetime` con el año, mes, día, hora, minuto, segundo y micro segundo especificados.

PyObject* `PyDateTime_FromDateAndTimeAndFold`(int year, int month, int day, int hour, int minute, int second, int usecond, int fold)
  Return value: New reference.

  Retorna un objeto `datetime.datetime` con el año, mes, día, hora, minuto, segundo, micro segundo y doblez especificados.

  Nuevo en la versión 3.6.

PyObject* `PyTime_FromTime`(int hour, int minute, int second, int usecond)
  Return value: New reference.

  Retorna un objeto `datetime.time` con la hora, minuto, segundo y micro segundo especificados.

PyObject* `PyTime_FromTimeAndFold`(int hour, int minute, int second, int usecond, int fold)
  Return value: New reference.

  Retorna un objeto `datetime.time` con la hora, minuto, segundo, micro segundo y doblez especificados.

  Nuevo en la versión 3.6.

PyObject* `PyDelta_FromDSU`(int days, int seconds, int useconds)
  Return value: New reference.

  Retorna un objeto `datetime.timedelta` que representa el número dado de días, segundos y micro segundos. La normalización se realiza de modo que el número resultante de micro segundos y segundos se encuentre en los rangos documentados para los objetos `datetime.timedelta`.

PyObject* `PyTimeZone_FromOffset`(PyDateTime_DeltaType* offset)
  Return value: New reference.

  Retorna un objeto `datetime.timezone` con un desplazamiento fijo sin nombre representado por el argumento offset.

  Nuevo en la versión 3.7.

PyObject* `PyTimeZone_FromOffsetAndName`(PyDateTime_DeltaType* offset, PyUnicode* name)
  Return value: New reference.

  Retorna un objeto `datetime.timezone` con un desplazamiento fijo representado por el argumento offset y con tzname name.

  Nuevo en la versión 3.7.

Macros para extraer campos de objetos de fecha. El argumento debe ser una instancia de `PyDateTime_Date`, incluidas las subclases (como `PyDateTime_DateTime`). El argumento no debe ser `NULL` y el tipo no está marcado:

int `PyDateTime_GET_YEAR`(PyDateTime_Date *o)

  Regrese el año, como un int positivo.

int `PyDateTime_GET_MONTH`(PyDateTime_Date *o)

  Regresa el mes, como int del 1 al 12.

int `PyDateTime_GET_DAY`(PyDateTime_Date *o)

  Retorna el día, como int del 1 al 31.

Macros para extraer campos de objetos de fecha y hora. El argumento debe ser una instancia de `PyDateTime_DateTime`, incluidas las subclases. El argumento no debe ser `NULL` y el tipo no es comprobado:

int `PyDateTime_DATE_GET_HOUR`(PyDateTime_DateTime *o)

  Retorna la hora, como un int de 0 hasta 23.

int `PyDateTime_DATE_GET_MINUTE`(PyDateTime_DateTime *o)

  Retorna el minuto, como un int de 0 hasta 59.

int `PyDateTime_DATE_GET_SECOND`(PyDateTime_DateTime *o)

  Retorna el segundo, como un int de 0 hasta 59.

int `PyDateTime_DATE_GET_MICROSECOND`(PyDateTime_DateTime *o)

  Retorna el micro segundo, como un int de 0 hasta 999999.

int `PyDateTime_DATE_GET_FOLD`(PyDateTime_DateTime *o)

  Return the fold, as an int from 0 through 1.

  Nuevo en la versión 3.6.

Macros para extraer campos de objetos de tiempo. El argumento debe ser una instancia de `PyDateTime_Time`, incluidas las subclases. El argumento no debe ser `NULL` y el tipo no está marcado:

int `PyDateTime_TIME_GET_HOUR`(PyDateTime_Time *o)

  Retorna la hora, como un int de 0 hasta 23.

int `PyDateTime_TIME_GET_MINUTE`(PyDateTime_Time *o)

  Retorna el minuto, como un int de 0 hasta 59.

int `PyDateTime_TIME_GET_SECOND`(PyDateTime_Time *o)

  Retorna el segundo, como un int de 0 hasta 59.

int `PyDateTime_TIME_GET_MICROSECOND`(PyDateTime_Time *o)

  Retorna el micro segundo, como un int de 0 hasta 999999.

int `PyDateTime_TIME_GET_FOLD`(PyDateTime_Time *o)

  Return the fold, as an int from 0 through 1.

  Nuevo en la versión 3.6.

Macros para extraer campos de objetos delta de tiempo. El argumento debe ser una instancia de `PyDateTime_Delta`, incluidas las subclases. El argumento no debe ser `NULL` y el tipo no está marcado:

int `PyDateTime_DELTA_GET_DAYS`(PyDateTime_Delta *o)

  Retorna el número de días, como un int desde -999999999 a 999999999.

  Nuevo en la versión 3.3.

int `PyDateTime_DELTA_GET_SECONDS`(PyDateTime_Delta *o)

  Retorna el número de segundos, como un int de 0 a 86399.

  Nuevo en la versión 3.3.

int `PyDateTime_DELTA_GET_MICROSECONDS`(PyDateTime_Delta *o)

  Retorna el número de micro segundos, como un int de 0 a 999999.

  Nuevo en la versión 3.3.

Macros para la conveniencia de módulos que implementan la API DB:

PyObject* `PyDateTime_FromTimestamp`(PyObject *args)
  Return value: New reference.

  Crea y retorna un nuevo objeto `datetime.datetime` dado una tupla de argumentos adecuada para pasar a `datetime.datetime.fromtimestamp()`.

PyObject* `PyDate_FromTimestamp`(PyObject *args)
  Return value: New reference.

  Crea y retorna un nuevo objeto `datetime.date` dado una tupla de argumentos adecuada para pasar a `datetime.date.fromtimestamp()`.