time 模組提供**底層時間戳、睡眠、格式化、解析**功能,基於 C 標準庫,精度與行為受平台影響。高階日期運算(時區、曆法、差值)請用 datetime;calendar 處理日曆相關。
| 函數 | 說明 | 返回類型 | 典型用途 |
|---|---|---|---|
time() | Unix 紀元秒數(浮點) | float | 基準時間、簡易計時 |
perf_counter() | 高精度計時器(秒),含睡眠 | float | **效能基準測試首選**(3.3+) |
process_time() | CPU 時間(秒),不含睡眠 | float | 算法複雜度分析 |
sleep(secs) | 阻塞當前線程 | None | 限流、輪詢間隔 |
gmtime([secs]) | UTC 時間元組 | struct_time | UTC 日誌、跨時區存儲 |
localtime([secs]) | 本地時間元組 | struct_time | 用戶顯示、本地業務 |
mktime(struct_time) | 本地時間元組 → 時間戳 | float | 構造時間戳 |
strftime(fmt, [struct_time]) | 格式化為字串 | str | 日誌、顯示、文件名 |
strptime(str, fmt) | 解析字串為時間元組 | struct_time | 配置解析、日誌分析 |
monotonic() | 單調時鐘(不受系統時間調整影響) | float | 超時判斷、間隔測量(3.3+) |
time() vs perf_counter() vs monotonic()
import time
# 1. time() - 系統牆鐘時間,受 NTP/手動修改影響,不可用於測量間隔
t1 = time.time()
time.sleep(1)
t2 = time.time()
print(f"time(): {t2-t1:.3f}s") # 可能 ≠ 1.0
# 2. perf_counter() - 最高精度,包含睡眠,適合基準測試
t1 = time.perf_counter()
time.sleep(1)
t2 = time.perf_counter()
print(f"perf_counter(): {t2-t1:.3f}s") # ≈ 1.000
# 3. monotonic() - 單調遞增,不受系統時間回撥影響,適合超時邏輯
t1 = time.monotonic()
time.sleep(1)
t2 = time.monotonic()
print(f"monotonic(): {t2-t1:.3f}s") # ≈ 1.000
原則:測量間隔用 perf_counter;超時/截止時間用 monotonic;存儲/傳輸/跨系統用 time()(UTC)。
struct_time 結構
tm_year, tm_mon, tm_mday, tm_hour, tm_min, tm_sec, tm_wday, tm_yday, tm_isdst
# 2024, 5, 20, 14, 30, 15, 0, 141, 0
# tm_wday: 0=Mon ... 6=Sun
# tm_yday: 1~366
# tm_isdst: 1=夏令時, 0=非, -1=未知
import time
t = time.localtime()
print(time.strftime("%Y-%m-%d %H:%M:%S", t)) # 2024-05-20 14:30:15
print(time.strftime("%Y%m%d_%H%M%S", t)) # 20240520_143015 文件名安全
print(time.strftime("%a, %d %b %Y %H:%M:%S GMT", time.gmtime())) # HTTP 日期
| 代碼 | 含義 | 範例 |
|---|---|---|
| %Y | 四位年 | 2024 |
| %m | 零填充月 | 05 |
| %d | 零填充日 | 20 |
| %H | 24制時 | 14 |
| %M | 分 | 30 |
| %S | 秒 | 15 |
| %f | 微秒(僅 datetime 支援) | 123456 |
| %z | 時區偏移 | +0800 |
| %Z | 時區名 | CST |
| %s | Unix 時間戳(非標準,Linux/OSX 支援) | 1716187815 |
strptime 無時區感知
# 解析帶時區字串需手動處理
from datetime import datetime
dt = datetime.strptime("2024-05-20T14:30:15+08:00", "%Y-%m-%dT%H:%M:%S%z")
# time.strptime 不支援 %z
mktime 假設輸入為本地時間
# 錯誤:用 gmtime 結果餵給 mktime
ts = time.mktime(time.gmtime()) # 偏移雙倍時區
# 正確:用 calendar.timegm(gmtime) 或 datetime.timestamp()
# 2024-03-10 02:00 不存在(美東春季調快)
t = time.strptime("2024-03-10 02:30", "%Y-%m-%d %H:%M")
ts = time.mktime(t) # 可能報錯或返回錯誤值
# 解決:用 datetime + pytz/zoneinfo
# 慢:每行調用 strftime
logger.info(time.strftime("%Y-%m-%d %H:%M:%S") + " msg")
# 快:Formatter 內部緩存,或用 logging.Formatter(converter=time.gmtime)
logging.Formatter(fmt="%(asctime)s %(message)s", datefmt="%Y-%m-%d %H:%M:%S")
time 模組是底層時間操作的基石,掌握 perf_counter/monotonic 區別、struct_time 結構、格式化字串、夏令時陷阱,能避開 90% 的時間相關 Bug。現代代碼**首選 datetime 處理業務邏輯**,time 僅用於高精度計時、與 C 庫交互、極簡腳本。