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.
Macros de verificação de tipo:
-
int
PyDate_Check
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_DateType
or a subtype ofPyDateTime_DateType
. ob must not be NULL.Novo na versão 2.4.
-
int
PyDate_CheckExact
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_DateType
. ob must not be NULL.Novo na versão 2.4.
-
int
PyDateTime_Check
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_DateTimeType
or a subtype ofPyDateTime_DateTimeType
. ob must not be NULL.Novo na versão 2.4.
-
int
PyDateTime_CheckExact
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_DateTimeType
. ob must not be NULL.Novo na versão 2.4.
-
int
PyTime_Check
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_TimeType
or a subtype ofPyDateTime_TimeType
. ob must not be NULL.Novo na versão 2.4.
-
int
PyTime_CheckExact
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_TimeType
. ob must not be NULL.Novo na versão 2.4.
-
int
PyDelta_Check
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_DeltaType
or a subtype ofPyDateTime_DeltaType
. ob must not be NULL.Novo na versão 2.4.
-
int
PyDelta_CheckExact
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_DeltaType
. ob must not be NULL.Novo na versão 2.4.
-
int
PyTZInfo_Check
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_TZInfoType
or a subtype ofPyDateTime_TZInfoType
. ob must not be NULL.Novo na versão 2.4.
-
int
PyTZInfo_CheckExact
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_TZInfoType
. ob must not be NULL.Novo na versão 2.4.
Macros para criar objetos:
-
PyObject*
PyDate_FromDate
(int year, int month, int day)¶ - Return value: New reference.
Return a
datetime.date
object with the specified year, month and day.Novo na versão 2.4.
-
PyObject*
PyDateTime_FromDateAndTime
(int year, int month, int day, int hour, int minute, int second, int usecond)¶ - Return value: New reference.
Return a
datetime.datetime
object with the specified year, month, day, hour, minute, second and microsecond.Novo na versão 2.4.
-
PyObject*
PyTime_FromTime
(int hour, int minute, int second, int usecond)¶ - Return value: New reference.
Return a
datetime.time
object with the specified hour, minute, second and microsecond.Novo na versão 2.4.
-
PyObject*
PyDelta_FromDSU
(int days, int seconds, int useconds)¶ - Return value: New reference.
Return a
datetime.timedelta
object representing the given number of days, seconds and microseconds. Normalization is performed so that the resulting number of microseconds and seconds lie in the ranges documented fordatetime.timedelta
objects.Novo na versão 2.4.
Macros to extract fields from date objects. The argument must be an instance of
PyDateTime_Date
, including subclasses (such as
PyDateTime_DateTime
). The argument must not be NULL, and the type is
not checked:
-
int
PyDateTime_GET_YEAR
(PyDateTime_Date *o)¶ Retorna o ano, como um inteiro positivo.
Novo na versão 2.4.
-
int
PyDateTime_GET_MONTH
(PyDateTime_Date *o)¶ Retorna o mês, como um inteiro de 1 a 12.
Novo na versão 2.4.
-
int
PyDateTime_GET_DAY
(PyDateTime_Date *o)¶ Retorna o dia, como um inteiro de 1 a 31.
Novo na versão 2.4.
Macros to extract fields from datetime objects. The argument must be an
instance of PyDateTime_DateTime
, including subclasses. The argument
must not be NULL, and the type is not checked:
-
int
PyDateTime_DATE_GET_HOUR
(PyDateTime_DateTime *o)¶ Retorna a hora, como um inteiro de 0 a 23.
Novo na versão 2.4.
-
int
PyDateTime_DATE_GET_MINUTE
(PyDateTime_DateTime *o)¶ Retorna o minuto, como um inteiro de 0 a 59.
Novo na versão 2.4.
-
int
PyDateTime_DATE_GET_SECOND
(PyDateTime_DateTime *o)¶ Retorna o segundo, como um inteiro de 0 a 59.
Novo na versão 2.4.
-
int
PyDateTime_DATE_GET_MICROSECOND
(PyDateTime_DateTime *o)¶ Retorna o microssegundo, como um inteiro de 0 a 999999.
Novo na versão 2.4.
Macros to extract fields from time objects. The argument must be an instance of
PyDateTime_Time
, including subclasses. The argument must not be NULL,
and the type is not checked:
-
int
PyDateTime_TIME_GET_HOUR
(PyDateTime_Time *o)¶ Retorna a hora, como um inteiro de 0 a 23.
Novo na versão 2.4.
-
int
PyDateTime_TIME_GET_MINUTE
(PyDateTime_Time *o)¶ Retorna o minuto, como um inteiro de 0 a 59.
Novo na versão 2.4.
-
int
PyDateTime_TIME_GET_SECOND
(PyDateTime_Time *o)¶ Retorna o segundo, como um inteiro de 0 a 59.
Novo na versão 2.4.
-
int
PyDateTime_TIME_GET_MICROSECOND
(PyDateTime_Time *o)¶ Retorna o microssegundo, como um inteiro de 0 a 999999.
Novo na versão 2.4.
Macros para a conveniência de módulos implementando a API de DB: