☰ Menu Python

☰ Menu

DateTime 객체

다양한 날짜와 시간 객체가 datetime 모듈에서 제공됩니다. 이 함수들을 사용하기 전에 헤더 파일 datetime.h 를 소스에 포함해야 하며(Python.h 에는 포함되지 않음), 일반적으로 모듈 초기화 함수의 일부로 PyDateTime_IMPORT 매크로를 호출해야 합니다. 이 매크로는 C 구조체 포인터를 다음 매크로에서 사용되는 정적 변수 PyDateTimeAPI 에 할당합니다.

PyDateTime_IMPORT()

datetime C API를 임포트합니다.

성공 시 PyDateTimeAPI 포인터를 채웁니다. 실패 시 PyDateTimeAPI 를 NULL 로 설정하고 예외를 발생시킵니다. 호출자는 PyErr_Occurred() 를 통해 오류 발생 여부를 확인해야 합니다.

PyDateTime_IMPORT;
if (PyErr_Occurred()) { /* 정리(cleanup) */ }

경고

이 기능은 서브 인터프리터와 호환되지 않습니다.

버전 3.15에서 변경: 이 매크로는 이제 스레드 세이프(thread safe)합니다.

type PyDateTime_CAPI

datetime C API를 위한 필드를 포함하는 구조체입니다.

이 구조체의 필드는 내부용(private)이며 변경될 수 있습니다.

이를 직접 사용하지 마십시오. 대신 PyDateTime_* API를 사용하는 것을 권장합니다.

PyDateTime_CAPI *PyDateTimeAPI

datetime C API를 포함하는 동적 할당 객체입니다.

이 변수는 PyDateTime_IMPORT 가 성공적으로 완료된 후에만 사용할 수 있습니다.

버전 3.15에서 변경: 이 변수는 직접 접근 시 스레드 세이프하지 않으므로 직접 액세스해서는 안 됩니다. 대신 PyDateTime_IMPORT() 를 사용하십시오.

type PyDateTime_Date

이 PyObject 의 하위 타입은 파이썬 날짜(date) 객체를 나타냅니다.

type PyDateTime_DateTime

이 PyObject 의 하위 타입은 파이썬 datetime 객체를 나타냅니다.

type PyDateTime_Time

이 PyObject 의 하위 타입은 파이썬 시간(time) 객체를 나타냅니다.

type PyDateTime_Delta

이 PyObject 의 하위 타입은 두 개의 datetime 값 사이의 차이를 나타냅니다.

PyTypeObject PyDateTime_DateType

이 PyTypeObject 인스턴스는 파이썬 날짜(date) 타입을 나타내며, 파이썬 계층의 datetime.date 와 동일한 객체입니다.

PyTypeObject PyDateTime_DateTimeType

이 PyTypeObject 인스턴스는 파이썬 datetime 타입을 나타내며, 파이썬 계층의 datetime.datetime 과 동일한 객체입니다.

PyTypeObject PyDateTime_TimeType

이 PyTypeObject 인스턴스는 파이썬 시간(time) 타입을 나타내며, 파이썬 계층의 datetime.time 과 동일한 객체입니다.

PyTypeObject PyDateTime_DeltaType

이 PyTypeObject 인스턴스는 두 datetime 값 사이의 차이에 대한 파이썬 타입을 나타내며, 파이썬 계층의 datetime.timedelta 와 동일한 객체입니다.

PyTypeObject PyDateTime_TZInfoType

이 PyTypeObject 인스턴스는 파이썬 시간대 정보(time zone info) 타입을 나타내며, 파이썬 계층의 datetime.tzinfo 와 동일한 객체입니다.

UTC 싱글톤에 액세스하기 위한 매크로:

PyObject *PyDateTime_TimeZone_UTC

UTC를 나타내는 시간대 싱글톤을 반환합니다, datetime.timezone.utc와 같은 객체입니다.

Added in version 3.7.

형 검사 매크로:

int PyDate_Check(PyObject *ob)

ob가 PyDateTime_DateType 형이거나 PyDateTime_DateType의 서브 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyDate_CheckExact(PyObject *ob)

ob가 PyDateTime_DateType 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyDateTime_Check(PyObject *ob)

ob가 PyDateTime_DateTimeType 형이거나 PyDateTime_DateTimeType의 서브 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyDateTime_CheckExact(PyObject *ob)

ob가 PyDateTime_DateTimeType 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyTime_Check(PyObject *ob)

ob가 PyDateTime_TimeType 형이거나 PyDateTime_TimeType의 서브 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyTime_CheckExact(PyObject *ob)

ob가 PyDateTime_TimeType 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyDelta_Check(PyObject *ob)

ob가 PyDateTime_DeltaType 형이거나 PyDateTime_DeltaType의 서브 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyDelta_CheckExact(PyObject *ob)

ob가 PyDateTime_DeltaType 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyTZInfo_Check(PyObject *ob)

ob가 PyDateTime_TZInfoType 형이거나 PyDateTime_TZInfoType의 서브 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

int PyTZInfo_CheckExact(PyObject *ob)

ob가 PyDateTime_TZInfoType 형이면 참을 돌려줍니다. ob는 NULL이 아니어야 합니다. 이 함수는 항상 성공합니다.

객체를 만드는 매크로:

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

반환값: 새 참조.

지정된 년, 월, 일의 datetime.date 객체를 반환합니다.

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

반환값: 새 참조.

지정된 년, 월, 일, 시, 분, 초 및 마이크로초의 datetime.datetime 객체를 반환합니다.

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

반환값: 새 참조.

지정된 년, 월, 일, 시, 분, 초, 마이크로초 및 fold의 datetime.datetime 객체를 반환합니다.

Added in version 3.6.

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

반환값: 새 참조.

지정된 시, 분, 초 및 마이크로초의 datetime.time 객체를 반환합니다.

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

반환값: 새 참조.

지정된 시, 분, 초, 마이크로초 및 fold의 datetime.time 객체를 반환합니다.

Added in version 3.6.

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

반환값: 새 참조.

지정된 일, 초 및 마이크로초 수를 나타내는 datetime.timedelta 객체를 반환합니다. 결과 마이크로초와 초가 datetime.timedelta 객체에 관해 설명된 범위에 있도록 정규화가 수행됩니다.

PyObject *PyTimeZone_FromOffset(PyObject *offset)

반환값: 새 참조.

offset 인자로 나타내지는 이름이 없는 고정 오프셋의 datetime.timezone 객체를 돌려줍니다.

Added in version 3.7.

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

반환값: 새 참조.

offset 인자와 tzname name으로 나타내지는 고정 오프셋의 datetime.timezone 객체를 돌려줍니다.

Added in version 3.7.

날짜 객체에서 필드를 추출하는 매크로. 인자는 서브 클래스(가령 PyDateTime_DateTime)를 포함하여 PyDateTime_Date의 인스턴스여야 합니다. 인자는 NULL이 아니어야 하며, 형은 검사하지 않습니다:

int PyDateTime_GET_YEAR(PyDateTime_Date *o)

양의 int로, 년을 반환합니다.

int PyDateTime_GET_MONTH(PyDateTime_Date *o)

1에서 12까지의 int로, 월을 반환합니다.

int PyDateTime_GET_DAY(PyDateTime_Date *o)

1에서 31까지의 int로, 일을 반환합니다.

날짜 시간 객체에서 필드를 추출하는 매크로. 인자는 서브 클래스를 포함하여 PyDateTime_DateTime의 인스턴스여야 합니다. 인자는 NULL이 아니어야 하며, 형은 검사하지 않습니다.:

int PyDateTime_DATE_GET_HOUR(PyDateTime_DateTime *o)

0부터 23까지의 int로, 시를 반환합니다.

int PyDateTime_DATE_GET_MINUTE(PyDateTime_DateTime *o)

0부터 59까지의 int로, 분을 반환합니다.

int PyDateTime_DATE_GET_SECOND(PyDateTime_DateTime *o)

0부터 59까지의 int로, 초를 반환합니다.

int PyDateTime_DATE_GET_MICROSECOND(PyDateTime_DateTime *o)

0부터 999999까지의 int로, 마이크로초를 반환합니다.

int PyDateTime_DATE_GET_FOLD(PyDateTime_DateTime *o)

0에서 1까지의 int로, 폴드를 반환합니다.

Added in version 3.6.

PyObject *PyDateTime_DATE_GET_TZINFO(PyDateTime_DateTime *o)

tzinfo를 반환합니다( None 일 수 있음).

Added in version 3.10.

시간 객체에서 필드를 추출하는 매크로. 인자는 서브 클래스를 포함하여 PyDateTime_Time의 인스턴스여야 합니다. 인자는 NULL이 아니어야 하며 형은 검사하지 않습니다:

int PyDateTime_TIME_GET_HOUR(PyDateTime_Time *o)

0부터 23까지의 int로, 시를 반환합니다.

int PyDateTime_TIME_GET_MINUTE(PyDateTime_Time *o)

0부터 59까지의 int로, 분을 반환합니다.

int PyDateTime_TIME_GET_SECOND(PyDateTime_Time *o)

0부터 59까지의 int로, 초를 반환합니다.

int PyDateTime_TIME_GET_MICROSECOND(PyDateTime_Time *o)

0부터 999999까지의 int로, 마이크로초를 반환합니다.

int PyDateTime_TIME_GET_FOLD(PyDateTime_Time *o)

0에서 1까지의 int로, 폴드를 반환합니다.

Added in version 3.6.

PyObject *PyDateTime_TIME_GET_TZINFO(PyDateTime_Time *o)

tzinfo를 반환합니다( None 일 수 있음).

Added in version 3.10.

시간 델타 객체에서 필드를 추출하는 매크로. 인자는 서브 클래스를 포함하여 PyDateTime_Delta의 인스턴스여야 합니다. 인자는 NULL이 아니어야 하며 형은 검사하지 않습니다.:

int PyDateTime_DELTA_GET_DAYS(PyDateTime_Delta *o)

-999999999에서 999999999까지의 int로, 일 수를 반환합니다.

Added in version 3.3.

int PyDateTime_DELTA_GET_SECONDS(PyDateTime_Delta *o)

0부터 86399까지의 int로, 초 수를 반환합니다.

Added in version 3.3.

int PyDateTime_DELTA_GET_MICROSECONDS(PyDateTime_Delta *o)

0에서 999999까지의 int로, 마이크로초 수를 반환합니다.

Added in version 3.3.

DB API를 구현하는 모듈의 편의를 위한 매크로:

PyObject *PyDateTime_FromTimestamp(PyObject *args)

반환값: 새 참조.

datetime.datetime.fromtimestamp()에 전달하는 데 적합한 인자 튜플로 새 datetime.datetime 객체를 만들고 반환합니다.

PyObject *PyDate_FromTimestamp(PyObject *args)

반환값: 새 참조.

datetime.date.fromtimestamp()에 전달하는 데 적합한 인자 튜플로 새 datetime.date 객체를 만들고 반환합니다.

내부 데이터

다음 기호들은 C API에 노출되어 있지만 내부 전용으로 간주해야 합니다.

PyDateTime_CAPSULE_NAME

PyCapsule_Import() 에 전달할 datetime 캡슐의 이름입니다.

내부용으로만 사용됩니다. 대신 PyDateTime_IMPORT 를 사용하십시오.

분실물 보관소