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
|
from __future__ import annotations
import sys
from pendulum.tz.local_timezone import get_local_timezone
from pendulum.tz.local_timezone import set_local_timezone
from pendulum.tz.local_timezone import test_local_timezone
from pendulum.tz.timezone import UTC
from pendulum.tz.timezone import FixedTimezone
from pendulum.tz.timezone import Timezone
if sys.version_info >= (3, 9):
from importlib import resources
else:
import importlib_resources as resources
PRE_TRANSITION = "pre"
POST_TRANSITION = "post"
TRANSITION_ERROR = "error"
_timezones = None
_tz_cache: dict[int, FixedTimezone] = {}
def timezones() -> tuple[str, ...]:
global _timezones
if _timezones is None:
with resources.files("tzdata").joinpath("zones").open() as f:
_timezones = tuple(tz.strip() for tz in f.readlines())
return _timezones
def timezone(name: str | int) -> Timezone | FixedTimezone:
"""
Return a Timezone instance given its name.
"""
if isinstance(name, int):
return fixed_timezone(name)
if name.lower() == "utc":
return UTC
return Timezone(name)
def fixed_timezone(offset: int) -> FixedTimezone:
"""
Return a Timezone instance given its offset in seconds.
"""
if offset in _tz_cache:
return _tz_cache[offset]
tz = FixedTimezone(offset)
_tz_cache[offset] = tz
return tz
def local_timezone() -> Timezone | FixedTimezone:
"""
Return the local timezone.
"""
return get_local_timezone()
__all__ = [
"UTC",
"Timezone",
"FixedTimezone",
"set_local_timezone",
"get_local_timezone",
"test_local_timezone",
"timezone",
"fixed_timezone",
"local_timezone",
"timezones",
]
|