1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
|
from __future__ import annotations
import datetime as datetime_
from abc import ABC
from abc import abstractmethod
from typing import cast
from pendulum.tz.exceptions import AmbiguousTime
from pendulum.tz.exceptions import InvalidTimezone
from pendulum.tz.exceptions import NonExistingTime
from pendulum.utils._compat import zoneinfo
POST_TRANSITION = "post"
PRE_TRANSITION = "pre"
TRANSITION_ERROR = "error"
class PendulumTimezone(ABC):
@property
@abstractmethod
def name(self) -> str:
raise NotImplementedError
@abstractmethod
def convert(
self, dt: datetime_.datetime, raise_on_unknown_times: bool = False
) -> datetime_.datetime:
raise NotImplementedError
@abstractmethod
def datetime(
self,
year: int,
month: int,
day: int,
hour: int = 0,
minute: int = 0,
second: int = 0,
microsecond: int = 0,
) -> datetime_.datetime:
raise NotImplementedError
class Timezone(zoneinfo.ZoneInfo, PendulumTimezone): # type: ignore[misc]
"""
Represents a named timezone.
The accepted names are those provided by the IANA time zone database.
>>> from pendulum.tz.timezone import Timezone
>>> tz = Timezone('Europe/Paris')
"""
def __new__(cls, key: str) -> Timezone:
try:
return cast(Timezone, super().__new__(cls, key))
except zoneinfo.ZoneInfoNotFoundError:
raise InvalidTimezone(key)
@property
def name(self) -> str:
return cast(str, self.key)
def convert(
self, dt: datetime_.datetime, raise_on_unknown_times: bool = False
) -> datetime_.datetime:
"""
Converts a datetime in the current timezone.
If the datetime is naive, it will be normalized.
>>> from datetime import datetime
>>> from pendulum import timezone
>>> paris = timezone('Europe/Paris')
>>> dt = datetime(2013, 3, 31, 2, 30, fold=1)
>>> in_paris = paris.convert(dt)
>>> in_paris.isoformat()
'2013-03-31T03:30:00+02:00'
If the datetime is aware, it will be properly converted.
>>> new_york = timezone('America/New_York')
>>> in_new_york = new_york.convert(in_paris)
>>> in_new_york.isoformat()
'2013-03-30T21:30:00-04:00'
"""
if dt.tzinfo is None:
offset_before = (
self.utcoffset(dt.replace(fold=0)) if dt.fold else self.utcoffset(dt)
)
offset_after = (
self.utcoffset(dt) if dt.fold else self.utcoffset(dt.replace(fold=1))
)
if offset_after > offset_before:
# Skipped time
if raise_on_unknown_times:
raise NonExistingTime(dt)
dt += (
(offset_after - offset_before)
if dt.fold
else (offset_before - offset_after)
)
elif offset_before > offset_after and raise_on_unknown_times:
# Repeated time
raise AmbiguousTime(dt)
return dt.replace(tzinfo=self)
return dt.astimezone(self)
def datetime(
self,
year: int,
month: int,
day: int,
hour: int = 0,
minute: int = 0,
second: int = 0,
microsecond: int = 0,
) -> datetime_.datetime:
"""
Return a normalized datetime for the current timezone.
"""
return self.convert(
datetime_.datetime(
year, month, day, hour, minute, second, microsecond, fold=1
)
)
def __repr__(self) -> str:
return f"{self.__class__.__name__}('{self.name}')"
class FixedTimezone(datetime_.tzinfo, PendulumTimezone):
def __init__(self, offset: int, name: str | None = None) -> None:
sign = "-" if offset < 0 else "+"
minutes = offset / 60
hour, minute = divmod(abs(int(minutes)), 60)
if not name:
name = f"{sign}{hour:02d}:{minute:02d}"
self._name = name
self._offset = offset
self._utcoffset = datetime_.timedelta(seconds=offset)
@property
def name(self) -> str:
return self._name
def convert(
self, dt: datetime_.datetime, raise_on_unknown_times: bool = False
) -> datetime_.datetime:
if dt.tzinfo is None:
return dt.__class__(
dt.year,
dt.month,
dt.day,
dt.hour,
dt.minute,
dt.second,
dt.microsecond,
tzinfo=self,
fold=0,
)
return dt.astimezone(self)
def datetime(
self,
year: int,
month: int,
day: int,
hour: int = 0,
minute: int = 0,
second: int = 0,
microsecond: int = 0,
) -> datetime_.datetime:
return self.convert(
datetime_.datetime(
year, month, day, hour, minute, second, microsecond, fold=1
)
)
@property
def offset(self) -> int:
return self._offset
def utcoffset(self, dt: datetime_.datetime | None) -> datetime_.timedelta:
return self._utcoffset
def dst(self, dt: datetime_.datetime | None) -> datetime_.timedelta:
return datetime_.timedelta()
def fromutc(self, dt: datetime_.datetime) -> datetime_.datetime:
# Use the stdlib datetime's add method to avoid infinite recursion
return (datetime_.datetime.__add__(dt, self._utcoffset)).replace(tzinfo=self)
def tzname(self, dt: datetime_.datetime | None) -> str | None:
return self._name
def __getinitargs__(self) -> tuple[int, str]:
return self._offset, self._name
def __repr__(self) -> str:
name = ""
if self._name:
name = f', name="{self._name}"'
return f"{self.__class__.__name__}({self._offset}{name})"
UTC = Timezone("UTC")
|