DateTime-objekt

Olika datum- och tidsobjekt tillhandahålls av modulen datetime. Innan du använder någon av dessa funktioner måste header-filen datetime.h inkluderas i din källkod (observera att den inte inkluderas av Python.h), och makrot PyDateTime_IMPORT måste anropas, vanligtvis som en del av modulens initialiseringsfunktion. Makrot placerar en pekare till en C-struktur i en statisk variabel, PyDateTimeAPI, som används av följande makron.

type PyDateTime_Date

Denna subtyp av PyObject representerar ett Python-datumobjekt.

type PyDateTime_DateTime

Denna subtyp av PyObject representerar ett Python datetime-objekt.

type PyDateTime_Time

Denna subtyp av PyObject representerar ett Python-tidsobjekt.

type PyDateTime_Delta

Denna subtyp av PyObject representerar skillnaden mellan två datetime-värden.

PyTypeObject PyDateTime_DateType

Denna instans av PyTypeObject representerar Pythons datumtyp; det är samma objekt som datetime.date i Python-lagret.

PyTypeObject PyDateTime_DateTimeType

Denna instans av PyTypeObject representerar Python-typen datetime; det är samma objekt som datetime.datetime i Python-lagret.

PyTypeObject PyDateTime_TimeType

Denna instans av PyTypeObject representerar Pythons tidstyp; det är samma objekt som datetime.time i Python-lagret.

PyTypeObject PyDateTime_DeltaType

Denna instans av PyTypeObject representerar Python-typen för skillnaden mellan två datetime-värden; det är samma objekt som datetime.timedelta i Python-lagret.

PyTypeObject PyDateTime_TZInfoType

Denna instans av PyTypeObject representerar Python-typen tidszoninfo; det är samma objekt som datetime.tzinfo i Python-lagret.

Makro för åtkomst till UTC-singleton:

PyObject *PyDateTime_TimeZone_UTC

Returnerar tidszonens singleton som representerar UTC, samma objekt som datetime.timezone.utc.

Tillagd i version 3.7.

Typkontrollera makron:

int PyDate_Check(PyObject *ob)

Returnerar true om ob är av typen PyDateTime_DateType eller en subtyp av PyDateTime_DateType. ob får inte vara NULL. Denna funktion lyckas alltid.

int PyDate_CheckExact(PyObject *ob)

Returnerar true om ob är av typen PyDateTime_DateType. ob får inte vara NULL. Denna funktion lyckas alltid.

int PyDateTime_Check(PyObject *ob)

Returnerar true om ob är av typen PyDateTime_DateTimeType eller en subtyp av PyDateTime_DateTimeType. ob får inte vara NULL. Denna funktion lyckas alltid.

int PyDateTime_CheckExact(PyObject *ob)

Returnerar true om ob är av typen PyDateTime_DateTimeType. ob får inte vara NULL. Denna funktion lyckas alltid.

int PyTime_Check(PyObject *ob)

Returnerar true om ob är av typen PyDateTime_TimeType eller en subtyp av PyDateTime_TimeType. ob får inte vara NULL. Denna funktion lyckas alltid.

int PyTime_CheckExact(PyObject *ob)

Returnerar true om ob är av typen PyDateTime_TimeType. ob får inte vara NULL. Denna funktion lyckas alltid.

int PyDelta_Check(PyObject *ob)

Returnerar true om ob är av typen PyDateTime_DeltaType eller en subtyp av PyDateTime_DeltaType. ob får inte vara NULL. Denna funktion lyckas alltid.

int PyDelta_CheckExact(PyObject *ob)

Returnerar true om ob är av typen PyDateTime_DeltaType. ob får inte vara NULL. Denna funktion lyckas alltid.

int PyTZInfo_Check(PyObject *ob)

Returnerar true om ob är av typen PyDateTime_TZInfoType eller en subtyp av PyDateTime_TZInfoType. ob får inte vara NULL. Denna funktion lyckas alltid.

int PyTZInfo_CheckExact(PyObject *ob)

Returnerar true om ob är av typen PyDateTime_TZInfoType. ob får inte vara NULL. Denna funktion lyckas alltid.

Makron för att skapa objekt:

PyObject *PyDate_FromDate(int year, int month, int day)

Returnera värde: Ny referens.

Returnerar ett datetime.date-objekt med angivet år, månad och dag.

PyObject *PyDateTime_FromDateAndTime(int year, int month, int day, int hour, int minute, int second, int usecond)

Returnera värde: Ny referens.

Returnerar ett datetime.datetime-objekt med angivet år, månad, dag, timme, minut, sekund och mikrosekund.

PyObject *PyDateTime_FromDateAndTimeAndFold(int year, int month, int day, int hour, int minute, int second, int usecond, int fold)

Returnera värde: Ny referens.

Returnera ett datetime.datetime-objekt med angivet år, månad, dag, timme, minut, sekund, mikrosekund och vikning.

Tillagd i version 3.6.

PyObject *PyTime_FromTime(int hour, int minute, int second, int usecond)

Returnera värde: Ny referens.

Returnerar ett datetime.time-objekt med angiven timme, minut, sekund och mikrosekund.

PyObject *PyTime_FromTimeAndFold(int hour, int minute, int second, int usecond, int fold)

Returnera värde: Ny referens.

Returnerar ett datetime.time-objekt med angiven timme, minut, sekund, mikrosekund och vikning.

Tillagd i version 3.6.

PyObject *PyDelta_FromDSU(int days, int seconds, int useconds)

Returnera värde: Ny referens.

Returnerar ett datetime.timedelta-objekt som representerar det givna antalet dagar, sekunder och mikrosekunder. Normalisering utförs så att det resulterande antalet mikrosekunder och sekunder ligger inom de intervall som dokumenterats för datetime.timedelta-objekt.

PyObject *PyTimeZone_FromOffset(PyObject *offset)

Returnera värde: Ny referens.

Returnerar ett datetime.timezone-objekt med en icke namngiven fast offset som representeras av argumentet offset.

Tillagd i version 3.7.

PyObject *PyTimeZone_FromOffsetAndName(PyObject *offset, PyObject *name)

Returnera värde: Ny referens.

Returnerar ett datetime.timezone-objekt med en fast offset som representeras av argumentet offset och med tzname name.

Tillagd i version 3.7.

Makron för att extrahera fält från datumobjekt. Argumentet måste vara en instans av PyDateTime_Date, inklusive underklasser (t.ex. PyDateTime_DateTime). Argumentet får inte vara NULL, och typen kontrolleras inte:

int PyDateTime_GET_YEAR(PyDateTime_Date *o)

Returnerar året som en positiv int.

int PyDateTime_GET_MONTH(PyDateTime_Date *o)

Returnerar månaden, som ett int från 1 till 12.

int PyDateTime_GET_DAY(PyDateTime_Date *o)

Returnera dagen, som ett int från 1 till 31.

Makron för att extrahera fält från datetime-objekt. Argumentet måste vara en instans av PyDateTime_DateTime, inklusive underklasser. Argumentet får inte vara NULL, och typen kontrolleras inte:

int PyDateTime_DATE_GET_HOUR(PyDateTime_DateTime *o)

Returnerar timmen som ett int från 0 till 23.

int PyDateTime_DATE_GET_MINUTE(PyDateTime_DateTime *o)

Returnera minuten som ett int från 0 till 59.

int PyDateTime_DATE_GET_SECOND(PyDateTime_DateTime *o)

Returnera den andra, som ett int från 0 till 59.

int PyDateTime_DATE_GET_MICROSECOND(PyDateTime_DateTime *o)

Returnerar mikrosekunden, som ett int från 0 till 999999.

int PyDateTime_DATE_GET_FOLD(PyDateTime_DateTime *o)

Returnera vikningen, som ett int från 0 till 1.

Tillagd i version 3.6.

PyObject *PyDateTime_DATE_GET_TZINFO(PyDateTime_DateTime *o)

Returnerar tzinfo (som kan vara None).

Tillagd i version 3.10.

Makron för att extrahera fält från tidsobjekt. Argumentet måste vara en instans av PyDateTime_Time, inklusive underklasser. Argumentet får inte vara NULL, och typen kontrolleras inte:

int PyDateTime_TIME_GET_HOUR(PyDateTime_Time *o)

Returnerar timmen som ett int från 0 till 23.

int PyDateTime_TIME_GET_MINUTE(PyDateTime_Time *o)

Returnera minuten som ett int från 0 till 59.

int PyDateTime_TIME_GET_SECOND(PyDateTime_Time *o)

Returnera den andra, som ett int från 0 till 59.

int PyDateTime_TIME_GET_MICROSECOND(PyDateTime_Time *o)

Returnerar mikrosekunden, som ett int från 0 till 999999.

int PyDateTime_TIME_GET_FOLD(PyDateTime_Time *o)

Returnera vikningen, som ett int från 0 till 1.

Tillagd i version 3.6.

PyObject *PyDateTime_TIME_GET_TZINFO(PyDateTime_Time *o)

Returnerar tzinfo (som kan vara None).

Tillagd i version 3.10.

Makron för att extrahera fält från tidsdeltaobjekt. Argumentet måste vara en instans av PyDateTime_Delta, inklusive underklasser. Argumentet får inte vara NULL, och typen kontrolleras inte:

int PyDateTime_DELTA_GET_DAYS(PyDateTime_Delta *o)

Returnera antalet dagar, som ett int från -999999999 till 999999999.

Tillagd i version 3.3.

int PyDateTime_DELTA_GET_SECONDS(PyDateTime_Delta *o)

Returnerar antalet sekunder, som ett int från 0 till 86399.

Tillagd i version 3.3.

int PyDateTime_DELTA_GET_MICROSECONDS(PyDateTime_Delta *o)

Returnerar antalet mikrosekunder, som ett int från 0 till 999999.

Tillagd i version 3.3.

Makron för att underlätta för moduler som implementerar DB API:

PyObject *PyDateTime_FromTimestamp(PyObject *args)

Returnera värde: Ny referens.

Skapa och returnera ett nytt datetime.datetime-objekt med en argumenttupel som är lämplig att skicka till datetime.datetime.fromtimestamp().

PyObject *PyDate_FromTimestamp(PyObject *args)

Returnera värde: Ny referens.

Skapar och returnerar ett nytt datetime.date-objekt med en argumenttupel som kan skickas till datetime.date.fromtimestamp().