# Objetos DateTime

Vários objetos de data e hora são fornecidos pelo módulo `datetime`. Antes de usar qualquer uma dessas funções, o arquivo de cabeçalho `datetime.h` deve ser incluído na sua fonte (observe que isso não é incluído por `Python.h`) e a macro `PyDateTime_IMPORT` deve ser chamada, geralmente como parte da função de inicialização do módulo. A macro coloca um ponteiro para uma estrutura C em uma variável estática, `PyDateTimeAPI`, usada pelas macros a seguir.

Macro para acesso ao singleton UTC:

PyObject* `PyDateTime_TimeZone_UTC`

  Retorna um singleton do fuso horário representando o UTC, o mesmo objeto que `datetime.timezone.utc`.

  Novo na versão 3.7.

Macros de verificação de tipo:

int `PyDate_Check`(PyObject *ob)

  Retorna true se ob for do tipo `PyDateTime_DateType` ou um subtipo de `PyDateTime_DateType`. ob não deve ser `NULL`. Esta função sempre tem sucesso.

int `PyDate_CheckExact`(PyObject *ob)

  Retorna true se ob for do tipo `PyDateTime_DateType`. ob não deve ser `NULL`. Esta função sempre tem sucesso.

int `PyDateTime_Check`(PyObject *ob)

  Retorna true se ob é do tipo `PyDateTime_DateTimeType` ou um subtipo de `PyDateTime_DateTimeType`. ob não deve ser `NULL`. Esta função sempre tem sucesso.

int `PyDateTime_CheckExact`(PyObject *ob)

  Retorna true se ob for do tipo `PyDateTime_DateTimeType`. ob não deve ser `NULL`. Esta função sempre tem sucesso.

int `PyTime_Check`(PyObject *ob)

  Retorna true se ob é do tipo `PyDateTime_TimeType` ou um subtipo de `PyDateTime_TimeType`. ob não deve ser `NULL`. Esta função sempre tem sucesso.

int `PyTime_CheckExact`(PyObject *ob)

  Retorna true se ob for do tipo `PyDateTime_TimeType`. ob não deve ser `NULL`. Esta função sempre tem sucesso.

int `PyDelta_Check`(PyObject *ob)

  Retorna true se ob é do tipo `PyDateTime_DeltaType` ou um subtipo de `PyDateTime_DeltaType`. ob não deve ser `NULL`. Esta função sempre tem sucesso.

int `PyDelta_CheckExact`(PyObject *ob)

  Retorna true se ob for do tipo `PyDateTime_DeltaType`. ob não deve ser `NULL`. Esta função sempre tem sucesso.

int `PyTZInfo_Check`(PyObject *ob)

  Retorna true se ob é do tipo `PyDateTime_TZInfoType` ou um subtipo de `PyDateTime_TZInfoType`. ob não deve ser `NULL`. Esta função sempre tem sucesso.

int `PyTZInfo_CheckExact`(PyObject *ob)

  Retorna true se ob for do tipo `PyDateTime_TZInfoType`. ob não deve ser `NULL`. Esta função sempre tem sucesso.

Macros para criar objetos:

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

  Retorna um objeto `datetime.date` com o ano, mês e dia especificados.

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

  Retorna um objeto `datetime.datetime` com o ano, mês, dia, hora, minuto, segundo, microssegundo 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 um objeto `datetime.datetime` com o ano, mês, dia, hora, minuto, segundo, microssegundo e a dobra especificados.

  Novo na versão 3.6.

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

  Retorna um objeto `datetime.time` com a hora, minuto, segundo e microssegundo especificados.

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

  Retorna um objeto `datetime.time` com a hora, minuto, segundo, microssegundo e a dobra especificados.

  Novo na versão 3.6.

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

  Retorna um objeto `datetime.timedelta` representando o número especificado de dias, segundos e microssegundos. A normalização é realizada para que o número resultante de microssegundos e segundos esteja nos intervalos documentados para objetos de `datetime.timedelta`.

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

  Retorna um objeto `datetime.timezone` com um deslocamento fixo sem nome representado pelo argumento offset.

  Novo na versão 3.7.

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

  Retorna um objeto `datetime.timezone` com um deslocamento fixo representado pelo argumento offset e com tzname name.

  Novo na versão 3.7.

Macros para extrair campos de objetos de data. O argumento deve ser uma instância de `PyDateTime_Date`, incluindo subclasses (como `PyDateTime_DateTime`). O argumento não deve ser `NULL` e o tipo não está marcado:

int `PyDateTime_GET_YEAR`(PyDateTime_Date *o)

  Retorna o ano, como um inteiro positivo.

int `PyDateTime_GET_MONTH`(PyDateTime_Date *o)

  Retorna o mês, como um inteiro de 1 a 12.

int `PyDateTime_GET_DAY`(PyDateTime_Date *o)

  Retorna o dia, como um inteiro de 1 a 31.

Macros para extrair campos de objetos de data e hora. O argumento deve ser uma instância de `PyDateTime_DateTime`, incluindo subclasses. O argumento não deve ser `NULL` e o tipo não é verificado:

int `PyDateTime_DATE_GET_HOUR`(PyDateTime_DateTime *o)

  Retorna a hora, como um inteiro de 0 a 23.

int `PyDateTime_DATE_GET_MINUTE`(PyDateTime_DateTime *o)

  Retorna o minuto, como um inteiro de 0 a 59.

int `PyDateTime_DATE_GET_SECOND`(PyDateTime_DateTime *o)

  Retorna o segundo, como um inteiro de 0 a 59.

int `PyDateTime_DATE_GET_MICROSECOND`(PyDateTime_DateTime *o)

  Retorna o microssegundo, como um inteiro de 0 a 999999.

int `PyDateTime_DATE_GET_FOLD`(PyDateTime_DateTime *o)

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

  Novo na versão 3.6.

Macros para extrair campos de objetos de tempo. O argumento deve ser uma instância de `PyDateTime_Time`, incluindo subclasses. O argumento não deve ser `NULL` e o tipo não é verificado:

int `PyDateTime_TIME_GET_HOUR`(PyDateTime_Time *o)

  Retorna a hora, como um inteiro de 0 a 23.

int `PyDateTime_TIME_GET_MINUTE`(PyDateTime_Time *o)

  Retorna o minuto, como um inteiro de 0 a 59.

int `PyDateTime_TIME_GET_SECOND`(PyDateTime_Time *o)

  Retorna o segundo, como um inteiro de 0 a 59.

int `PyDateTime_TIME_GET_MICROSECOND`(PyDateTime_Time *o)

  Retorna o microssegundo, como um inteiro de 0 a 999999.

int `PyDateTime_TIME_GET_FOLD`(PyDateTime_Time *o)

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

  Novo na versão 3.6.

Macros para extrair campos de objetos time delta. O argumento deve ser uma instância de `PyDateTime_Delta`, incluindo subclasses. O argumento não deve ser `NULL`, e o tipo não é checado:

int `PyDateTime_DELTA_GET_DAYS`(PyDateTime_Delta *o)

  Retorna o número de dias, como um inteiro de -999999999 a 999999999.

  Novo na versão 3.3.

int `PyDateTime_DELTA_GET_SECONDS`(PyDateTime_Delta *o)

  Retorna o número de segundos, como um inteiro de 0 a 86399.

  Novo na versão 3.3.

int `PyDateTime_DELTA_GET_MICROSECONDS`(PyDateTime_Delta *o)

  Retorna o número de microssegundos, como um inteiro de 0 a 999999.

  Novo na versão 3.3.

Macros para a conveniência de módulos implementando a API de DB:

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

  Cria e retorna um novo objeto `datetime.datetime`, com uma tupla de argumentos adequada para passar para `datetime.datetime.fromtimestamp()`.

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

  Cria e retorna um novo objeto `datetime.date`, com uma tupla de argumentos adequada para passar para `datetime.date.fromtimestamp()`.