1 /*  datetime.h
2  */
3 #ifndef Py_LIMITED_API
4 #ifndef DATETIME_H
5 #define DATETIME_H
6 #ifdef __cplusplus
7 extern "C" {
8 #endif
9 
10 /* Fields are packed into successive bytes, each viewed as unsigned and
11  * big-endian, unless otherwise noted:
12  *
13  * byte offset
14  *  0           year     2 bytes, 1-9999
15  *  2           month    1 byte, 1-12
16  *  3           day      1 byte, 1-31
17  *  4           hour     1 byte, 0-23
18  *  5           minute   1 byte, 0-59
19  *  6           second   1 byte, 0-59
20  *  7           usecond  3 bytes, 0-999999
21  * 10
22  */
23 
24 /* # of bytes for year, month, and day. */
25 #define _PyDateTime_DATE_DATASIZE 4
26 
27 /* # of bytes for hour, minute, second, and usecond. */
28 #define _PyDateTime_TIME_DATASIZE 6
29 
30 /* # of bytes for year, month, day, hour, minute, second, and usecond. */
31 #define _PyDateTime_DATETIME_DATASIZE 10
32 
33 
34 typedef struct
35 {
36     PyObject_HEAD
37     Py_hash_t hashcode;         /* -1 when unknown */
38     int days;                   /* -MAX_DELTA_DAYS <= days <= MAX_DELTA_DAYS */
39     int seconds;                /* 0 <= seconds < 24*3600 is invariant */
40     int microseconds;           /* 0 <= microseconds < 1000000 is invariant */
41 } PyDateTime_Delta;
42 
43 typedef struct
44 {
45     PyObject_HEAD               /* a pure abstract base class */
46 } PyDateTime_TZInfo;
47 
48 
49 /* The datetime and time types have hashcodes, and an optional tzinfo member,
50  * present if and only if hastzinfo is true.
51  */
52 #define _PyTZINFO_HEAD          \
53     PyObject_HEAD               \
54     Py_hash_t hashcode;         \
55     char hastzinfo;             /* boolean flag */
56 
57 /* No _PyDateTime_BaseTZInfo is allocated; it's just to have something
58  * convenient to cast to, when getting at the hastzinfo member of objects
59  * starting with _PyTZINFO_HEAD.
60  */
61 typedef struct
62 {
63     _PyTZINFO_HEAD
64 } _PyDateTime_BaseTZInfo;
65 
66 /* All time objects are of PyDateTime_TimeType, but that can be allocated
67  * in two ways, with or without a tzinfo member.  Without is the same as
68  * tzinfo == None, but consumes less memory.  _PyDateTime_BaseTime is an
69  * internal struct used to allocate the right amount of space for the
70  * "without" case.
71  */
72 #define _PyDateTime_TIMEHEAD    \
73     _PyTZINFO_HEAD              \
74     unsigned char data[_PyDateTime_TIME_DATASIZE];
75 
76 typedef struct
77 {
78     _PyDateTime_TIMEHEAD
79 } _PyDateTime_BaseTime;         /* hastzinfo false */
80 
81 typedef struct
82 {
83     _PyDateTime_TIMEHEAD
84     unsigned char fold;
85     PyObject *tzinfo;
86 } PyDateTime_Time;              /* hastzinfo true */
87 
88 
89 /* All datetime objects are of PyDateTime_DateTimeType, but that can be
90  * allocated in two ways too, just like for time objects above.  In addition,
91  * the plain date type is a base class for datetime, so it must also have
92  * a hastzinfo member (although it's unused there).
93  */
94 typedef struct
95 {
96     _PyTZINFO_HEAD
97     unsigned char data[_PyDateTime_DATE_DATASIZE];
98 } PyDateTime_Date;
99 
100 #define _PyDateTime_DATETIMEHEAD        \
101     _PyTZINFO_HEAD                      \
102     unsigned char data[_PyDateTime_DATETIME_DATASIZE];
103 
104 typedef struct
105 {
106     _PyDateTime_DATETIMEHEAD
107 } _PyDateTime_BaseDateTime;     /* hastzinfo false */
108 
109 typedef struct
110 {
111     _PyDateTime_DATETIMEHEAD
112     unsigned char fold;
113     PyObject *tzinfo;
114 } PyDateTime_DateTime;          /* hastzinfo true */
115 
116 
117 /* Apply for date and datetime instances. */
118 #define PyDateTime_GET_YEAR(o)     ((((PyDateTime_Date*)o)->data[0] << 8) | \
119                      ((PyDateTime_Date*)o)->data[1])
120 #define PyDateTime_GET_MONTH(o)    (((PyDateTime_Date*)o)->data[2])
121 #define PyDateTime_GET_DAY(o)      (((PyDateTime_Date*)o)->data[3])
122 
123 #define PyDateTime_DATE_GET_HOUR(o)        (((PyDateTime_DateTime*)o)->data[4])
124 #define PyDateTime_DATE_GET_MINUTE(o)      (((PyDateTime_DateTime*)o)->data[5])
125 #define PyDateTime_DATE_GET_SECOND(o)      (((PyDateTime_DateTime*)o)->data[6])
126 #define PyDateTime_DATE_GET_MICROSECOND(o)              \
127     ((((PyDateTime_DateTime*)o)->data[7] << 16) |       \
128      (((PyDateTime_DateTime*)o)->data[8] << 8)  |       \
129       ((PyDateTime_DateTime*)o)->data[9])
130 #define PyDateTime_DATE_GET_FOLD(o)        (((PyDateTime_DateTime*)o)->fold)
131 
132 /* Apply for time instances. */
133 #define PyDateTime_TIME_GET_HOUR(o)        (((PyDateTime_Time*)o)->data[0])
134 #define PyDateTime_TIME_GET_MINUTE(o)      (((PyDateTime_Time*)o)->data[1])
135 #define PyDateTime_TIME_GET_SECOND(o)      (((PyDateTime_Time*)o)->data[2])
136 #define PyDateTime_TIME_GET_MICROSECOND(o)              \
137     ((((PyDateTime_Time*)o)->data[3] << 16) |           \
138      (((PyDateTime_Time*)o)->data[4] << 8)  |           \
139       ((PyDateTime_Time*)o)->data[5])
140 #define PyDateTime_TIME_GET_FOLD(o)        (((PyDateTime_Time*)o)->fold)
141 
142 /* Apply for time delta instances */
143 #define PyDateTime_DELTA_GET_DAYS(o)         (((PyDateTime_Delta*)o)->days)
144 #define PyDateTime_DELTA_GET_SECONDS(o)      (((PyDateTime_Delta*)o)->seconds)
145 #define PyDateTime_DELTA_GET_MICROSECONDS(o)            \
146     (((PyDateTime_Delta*)o)->microseconds)
147 
148 
149 /* Define structure for C API. */
150 typedef struct {
151     /* type objects */
152     PyTypeObject *DateType;
153     PyTypeObject *DateTimeType;
154     PyTypeObject *TimeType;
155     PyTypeObject *DeltaType;
156     PyTypeObject *TZInfoType;
157 
158     /* constructors */
159     PyObject *(*Date_FromDate)(int, int, int, PyTypeObject*);
160     PyObject *(*DateTime_FromDateAndTime)(int, int, int, int, int, int, int,
161         PyObject*, PyTypeObject*);
162     PyObject *(*Time_FromTime)(int, int, int, int, PyObject*, PyTypeObject*);
163     PyObject *(*Delta_FromDelta)(int, int, int, int, PyTypeObject*);
164 
165     /* constructors for the DB API */
166     PyObject *(*DateTime_FromTimestamp)(PyObject*, PyObject*, PyObject*);
167     PyObject *(*Date_FromTimestamp)(PyObject*, PyObject*);
168 
169     /* PEP 495 constructors */
170     PyObject *(*DateTime_FromDateAndTimeAndFold)(int, int, int, int, int, int, int,
171         PyObject*, int, PyTypeObject*);
172     PyObject *(*Time_FromTimeAndFold)(int, int, int, int, PyObject*, int, PyTypeObject*);
173 
174 } PyDateTime_CAPI;
175 
176 #define PyDateTime_CAPSULE_NAME "datetime.datetime_CAPI"
177 
178 
179 #ifdef Py_BUILD_CORE
180 
181 /* Macros for type checking when building the Python core. */
182 #define PyDate_Check(op) PyObject_TypeCheck(op, &PyDateTime_DateType)
183 #define PyDate_CheckExact(op) (Py_TYPE(op) == &PyDateTime_DateType)
184 
185 #define PyDateTime_Check(op) PyObject_TypeCheck(op, &PyDateTime_DateTimeType)
186 #define PyDateTime_CheckExact(op) (Py_TYPE(op) == &PyDateTime_DateTimeType)
187 
188 #define PyTime_Check(op) PyObject_TypeCheck(op, &PyDateTime_TimeType)
189 #define PyTime_CheckExact(op) (Py_TYPE(op) == &PyDateTime_TimeType)
190 
191 #define PyDelta_Check(op) PyObject_TypeCheck(op, &PyDateTime_DeltaType)
192 #define PyDelta_CheckExact(op) (Py_TYPE(op) == &PyDateTime_DeltaType)
193 
194 #define PyTZInfo_Check(op) PyObject_TypeCheck(op, &PyDateTime_TZInfoType)
195 #define PyTZInfo_CheckExact(op) (Py_TYPE(op) == &PyDateTime_TZInfoType)
196 
197 #else
198 
199 /* Define global variable for the C API and a macro for setting it. */
200 static PyDateTime_CAPI *PyDateTimeAPI = NULL;
201 
202 #define PyDateTime_IMPORT \
203     PyDateTimeAPI = (PyDateTime_CAPI *)PyCapsule_Import(PyDateTime_CAPSULE_NAME, 0)
204 
205 /* Macros for type checking when not building the Python core. */
206 #define PyDate_Check(op) PyObject_TypeCheck(op, PyDateTimeAPI->DateType)
207 #define PyDate_CheckExact(op) (Py_TYPE(op) == PyDateTimeAPI->DateType)
208 
209 #define PyDateTime_Check(op) PyObject_TypeCheck(op, PyDateTimeAPI->DateTimeType)
210 #define PyDateTime_CheckExact(op) (Py_TYPE(op) == PyDateTimeAPI->DateTimeType)
211 
212 #define PyTime_Check(op) PyObject_TypeCheck(op, PyDateTimeAPI->TimeType)
213 #define PyTime_CheckExact(op) (Py_TYPE(op) == PyDateTimeAPI->TimeType)
214 
215 #define PyDelta_Check(op) PyObject_TypeCheck(op, PyDateTimeAPI->DeltaType)
216 #define PyDelta_CheckExact(op) (Py_TYPE(op) == PyDateTimeAPI->DeltaType)
217 
218 #define PyTZInfo_Check(op) PyObject_TypeCheck(op, PyDateTimeAPI->TZInfoType)
219 #define PyTZInfo_CheckExact(op) (Py_TYPE(op) == PyDateTimeAPI->TZInfoType)
220 
221 /* Macros for accessing constructors in a simplified fashion. */
222 #define PyDate_FromDate(year, month, day) \
223     PyDateTimeAPI->Date_FromDate(year, month, day, PyDateTimeAPI->DateType)
224 
225 #define PyDateTime_FromDateAndTime(year, month, day, hour, min, sec, usec) \
226     PyDateTimeAPI->DateTime_FromDateAndTime(year, month, day, hour, \
227         min, sec, usec, Py_None, PyDateTimeAPI->DateTimeType)
228 
229 #define PyDateTime_FromDateAndTimeAndFold(year, month, day, hour, min, sec, usec, fold) \
230     PyDateTimeAPI->DateTime_FromDateAndTimeAndFold(year, month, day, hour, \
231         min, sec, usec, Py_None, fold, PyDateTimeAPI->DateTimeType)
232 
233 #define PyTime_FromTime(hour, minute, second, usecond) \
234     PyDateTimeAPI->Time_FromTime(hour, minute, second, usecond, \
235         Py_None, PyDateTimeAPI->TimeType)
236 
237 #define PyTime_FromTimeAndFold(hour, minute, second, usecond, fold) \
238     PyDateTimeAPI->Time_FromTimeAndFold(hour, minute, second, usecond, \
239         Py_None, fold, PyDateTimeAPI->TimeType)
240 
241 #define PyDelta_FromDSU(days, seconds, useconds) \
242     PyDateTimeAPI->Delta_FromDelta(days, seconds, useconds, 1, \
243         PyDateTimeAPI->DeltaType)
244 
245 /* Macros supporting the DB API. */
246 #define PyDateTime_FromTimestamp(args) \
247     PyDateTimeAPI->DateTime_FromTimestamp( \
248         (PyObject*) (PyDateTimeAPI->DateTimeType), args, NULL)
249 
250 #define PyDate_FromTimestamp(args) \
251     PyDateTimeAPI->Date_FromTimestamp( \
252         (PyObject*) (PyDateTimeAPI->DateType), args)
253 
254 #endif  /* Py_BUILD_CORE */
255 
256 #ifdef __cplusplus
257 }
258 #endif
259 #endif
260 #endif /* !Py_LIMITED_API */
261