Objets DateTime¶
De nombreux objets date et time sont exposés par le module DateTime
. Avant d'utiliser une de ces fonctions, le fichier d'en-tête datetime.h
doit être inclus dans vos sources (veuillez noter qu'il n'est pas inclus par le fichier Python.h
) et la macro PyDateTime_IMPORT
doit être invoquée, généralement lors de la fonction d'initialisation du module. La macro crée un pointeur vers une structure C et place celui-ci dans une variable statique, PyDateTimeAPI
, qui est utilisée par les macros suivantes.
Macro pour accéder au singleton UTC :
-
PyObject *
PyDateTime_TimeZone_UTC
¶ Renvoie le singleton du fuseau horaire UTC, qui est le même objet que
datetime.timezone.utc
.Nouveau dans la version 3.7.
Macros pour vérifier les types :
-
int
PyDate_Check
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_DateType
or a subtype ofPyDateTime_DateType
. ob must not beNULL
. This function always succeeds.
-
int
PyDate_CheckExact
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_DateType
. ob must not beNULL
. This function always succeeds.
-
int
PyDateTime_Check
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_DateTimeType
or a subtype ofPyDateTime_DateTimeType
. ob must not beNULL
. This function always succeeds.
-
int
PyDateTime_CheckExact
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_DateTimeType
. ob must not beNULL
. This function always succeeds.
-
int
PyTime_Check
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_TimeType
or a subtype ofPyDateTime_TimeType
. ob must not beNULL
. This function always succeeds.
-
int
PyTime_CheckExact
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_TimeType
. ob must not beNULL
. This function always succeeds.
-
int
PyDelta_Check
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_DeltaType
or a subtype ofPyDateTime_DeltaType
. ob must not beNULL
. This function always succeeds.
-
int
PyDelta_CheckExact
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_DeltaType
. ob must not beNULL
. This function always succeeds.
-
int
PyTZInfo_Check
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_TZInfoType
or a subtype ofPyDateTime_TZInfoType
. ob must not beNULL
. This function always succeeds.
-
int
PyTZInfo_CheckExact
(PyObject *ob)¶ Return true if ob is of type
PyDateTime_TZInfoType
. ob must not beNULL
. This function always succeeds.
Macros pour créer des objets :
-
PyObject *
PyDate_FromDate
(int year, int month, int day)¶ - Return value: New reference.
Renvoie un objet
datetime.date
avec l'année, le mois et le jour spécifiés.
-
PyObject *
PyDateTime_FromDateAndTime
(int year, int month, int day, int hour, int minute, int second, int usecond)¶ - Return value: New reference.
Renvoie un objet
datetime.datetime
avec l'année, le mois, le jour, l'heure, la minute, la seconde et la microseconde spécifiés.
-
PyObject *
PyDateTime_FromDateAndTimeAndFold
(int year, int month, int day, int hour, int minute, int second, int usecond, int fold)¶ - Return value: New reference.
Renvoie un objet
datetime.datetime
avec l'année, le mois, le jour, l'heure, la minute, la seconde, la microseconde et le pli (fold en anglais) spécifiés.Nouveau dans la version 3.6.
-
PyObject *
PyTime_FromTime
(int hour, int minute, int second, int usecond)¶ - Return value: New reference.
Renvoie un objet
datetime.time
avec l'heure, la minute, la seconde et la microseconde spécifiées.
-
PyObject *
PyTime_FromTimeAndFold
(int hour, int minute, int second, int usecond, int fold)¶ - Return value: New reference.
Renvoie un objet
datetime.time
avec l'heure, la minute, la seconde, la microseconde et le pli (fold en anglais) spécifiés.Nouveau dans la version 3.6.
-
PyObject *
PyDelta_FromDSU
(int days, int seconds, int useconds)¶ - Return value: New reference.
Renvoie un objet
datetime.timedelta
représentant le nombre passé en paramètre de jours, de secondes et de microsecondes. Le résultat est normalisé pour que le nombre de microsecondes et de secondes tombe dans la plage documentée pour les objetsdatetime.timedelta
.
-
PyObject *
PyTimeZone_FromOffset
(PyDateTime_DeltaType *offset)¶ - Return value: New reference.
Renvoie un objet
datetime.timezone
avec un décalage anonyme fixe représenté par l'argument offset.Nouveau dans la version 3.7.
-
PyObject *
PyTimeZone_FromOffsetAndName
(PyDateTime_DeltaType *offset, PyUnicode *name)¶ - Return value: New reference.
Renvoie un objet
datetime.timezone
avec un décalage fixe représenté par l'argument offset et avec le nom de fuseau horaire name.Nouveau dans la version 3.7.
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)¶ Renvoie l'année, sous forme d'entier positif.
-
int
PyDateTime_GET_MONTH
(PyDateTime_Date *o)¶ Renvoie le mois, sous forme d'entier allant de 1 à 12.
-
int
PyDateTime_GET_DAY
(PyDateTime_Date *o)¶ Renvoie le jour, sous forme d'entier allant de 1 à 31.
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)¶ Renvoie l'heure, sous forme d'entier allant de 0 à 23.
-
int
PyDateTime_DATE_GET_MINUTE
(PyDateTime_DateTime *o)¶ Renvoie la minute, sous forme d'entier allant de 0 à 59.
-
int
PyDateTime_DATE_GET_SECOND
(PyDateTime_DateTime *o)¶ Renvoie la seconde, sous forme d'entier allant de 0 à 59.
-
int
PyDateTime_DATE_GET_MICROSECOND
(PyDateTime_DateTime *o)¶ Renvoie la microseconde, sous forme d'entier allant de 0 à 999999.
-
int
PyDateTime_DATE_GET_FOLD
(PyDateTime_DateTime *o)¶ Return the fold, as an int from 0 through 1.
Nouveau dans la version 3.6.
-
PyObject *
PyDateTime_DATE_GET_TZINFO
(PyDateTime_DateTime *o)¶ Return the tzinfo (which may be
None
).Nouveau dans la version 3.10.
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)¶ Renvoie l'heure, sous forme d'entier allant de 0 à 23.
-
int
PyDateTime_TIME_GET_MINUTE
(PyDateTime_Time *o)¶ Renvoie la minute, sous forme d'entier allant de 0 à 59.
-
int
PyDateTime_TIME_GET_SECOND
(PyDateTime_Time *o)¶ Renvoie la seconde, sous forme d'entier allant de 0 à 59.
-
int
PyDateTime_TIME_GET_MICROSECOND
(PyDateTime_Time *o)¶ Renvoie la microseconde, sous forme d'entier allant de 0 à 999999.
-
int
PyDateTime_TIME_GET_FOLD
(PyDateTime_Time *o)¶ Return the fold, as an int from 0 through 1.
Nouveau dans la version 3.6.
-
PyObject *
PyDateTime_TIME_GET_TZINFO
(PyDateTime_Time *o)¶ Return the tzinfo (which may be
None
).Nouveau dans la version 3.10.
Macros to extract fields from time delta objects. The argument must be an
instance of PyDateTime_Delta
, including subclasses. The argument must
not be NULL
, and the type is not checked:
-
int
PyDateTime_DELTA_GET_DAYS
(PyDateTime_Delta *o)¶ Renvoie le nombre de jours, sous forme d'entier allant de
-999999999
à999999999
.Nouveau dans la version 3.3.
-
int
PyDateTime_DELTA_GET_SECONDS
(PyDateTime_Delta *o)¶ Renvoie le nombre de secondes sous forme d'entier allant de 0 à 86399.
Nouveau dans la version 3.3.
-
int
PyDateTime_DELTA_GET_MICROSECONDS
(PyDateTime_Delta *o)¶ Renvoie le nombre de microsecondes, sous forme d'entier allant de 0 à 999999.
Nouveau dans la version 3.3.
Macros de confort pour les modules implémentant l'API DB :
-
PyObject *
PyDateTime_FromTimestamp
(PyObject *args)¶ - Return value: New reference.
Crée et renvoie un nouvel objet
datetime.datetime
à partir d'un n-uplet qui peut être passé àdatetime.datetime.fromtimestamp()
.
-
PyObject *
PyDate_FromTimestamp
(PyObject *args)¶ - Return value: New reference.
Crée et renvoie un nouvel objet
datetime.date
à partir d'un n-uplet qui peut être passé àdatetime.date.fromtimestamp()
.