time.tzset() 根據環境變數 TZ 重新初始化時間轉換規則,影響 localtime()、strftime() 等函數的行為。本文詳細解析 TZ 格式規範、跨平台差異 (Unix vs Windows)、實戰代碼與現代替代方案。
import time, os
os.environ['TZ'] = '...' # 設置時區規則
time.tzset() # 生效
tzset)
std offset[dst[offset][,start[/time],end[/time]]]
| 字段 | 格式 | 說明 | 範例 |
|---|---|---|---|
std | 3+ 字母 | 標準時間縮寫 (存入 time.tzname[0]) | CST, EST, PST |
offset | [±]hh[:mm[:ss]] | UTC 偏移,正值=西區 (美洲),負值=東區 (亞洲) | +08, -05:00, +09:30 |
dst | 3+ 字母 | 夏令時縮寫 (存入 time.tzname[1]) | CDT, EDT |
dst_offset | hh[:mm[:ss]] | 夏令時額外偏移 (預設 +1 小時) | 01:00 |
start, end | 轉換規則 | 夏令時生效/結束規則 | M3.2.0, J365 |
Jn:儒略日 n (1-365,不含 2/29),如 J60=3/1n:零基儒略日 (0-365,含 2/29),如 59=2/29(閏年)Mm.w.d:第 m 月第 w 週第 d 天 (週日=0)
M3.2.0 = 3 月第 2 個週日/time:可選轉換時間 (預設 02:00:00),格式同 offset 但無正負號
import time, os
# 美東時間 (EST/EDT)
os.environ['TZ'] = 'EST+05EDT,M3.2.0,M11.1.0'
time.tzset()
print(time.strftime('%X %x %Z')) # 08:30:00 01/15/24 EST
# 台灣時間 (CST,無夏令時)
os.environ['TZ'] = 'CST-08'
time.tzset()
print(time.strftime('%X %x %Z')) # 21:30:00 01/15/24 CST
# 澳洲東部 (AEST/AEDT)
os.environ['TZ'] = 'AEST-10AEDT-11,M10.1.0,M4.1.0'
time.tzset()
print(time.strftime('%X %x %Z')) # 11:30:00 01/16/24 AEDT
| 平台 | tzset 可用 | TZ 變數生效 | 備註 |
|---|---|---|---|
| Linux/Unix/macOS | ✅ | ✅ | 標準 POSIX 行為 |
| Windows (CPython) | ❌ (AttributeError) | ❌ | 需用 _putenv + 重啟進程或 datetime/zoneinfo |
| Windows (MSYS2/Cygwin) | ✅ | ✅ | POSIX 模擬層 |
from datetime import datetime
from zoneinfo import ZoneInfo
# 任意時區轉換,無需修改環境變數
utc = datetime(2024, 1, 15, 6, 30, tzinfo=ZoneInfo("UTC"))
tw = utc.astimezone(ZoneInfo("Asia/Taipei"))
ny = utc.astimezone(ZoneInfo("America/New_York"))
print(tw.strftime("%H:%M %Z")) # 14:30 CST
print(ny.strftime("%H:%M %Z")) # 01:30 EST
from dateutil import tz
from datetime import datetime
local = tz.gettz() # 系統本地時區
eastern = tz.gettz('US/Eastern')
dt = datetime(2024, 1, 15, 14, 30, tzinfo=local)
print(dt.astimezone(eastern))
datetime + zoneinfo 明確處理時區tzset()freezegun 或手動設 os.environ['TZ'] + time.tzset() (僅 Unix)ENV TZ=Asia/Taipei,基礎鏡像需安裝 tzdatatzset() 是 Unix 時代的產物,雖具歷史意義,但在現代跨平台 Python 開發中,zoneinfo 提供了更安全、更明確、無副作用的時區處理方式。理解其機制有助於維護舊系統,但新專案請擁抱現代標準庫。