萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python time 模組核心函數速查與實戰避坑指南

模組定位

time 模組提供**底層時間戳、睡眠、格式化、解析**功能,基於 C 標準庫,精度與行為受平台影響。高階日期運算(時區、曆法、差值)請用 datetime;calendar 處理日曆相關。

核心函數速查表

函數說明返回類型典型用途
time()Unix 紀元秒數(浮點)float基準時間、簡易計時
perf_counter()高精度計時器(秒),含睡眠float**效能基準測試首選**(3.3+)
process_time()CPU 時間(秒),不含睡眠float算法複雜度分析
sleep(secs)阻塞當前線程None限流、輪詢間隔
gmtime([secs])UTC 時間元組struct_timeUTC 日誌、跨時區存儲
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
%H24制時14
%M分30
%S秒15
%f微秒(僅 datetime 支援)123456
%z時區偏移+0800
%Z時區名CST
%sUnix 時間戳(非標準,Linux/OSX 支援)1716187815

實戰避坑指南

1. 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

2. mktime 假設輸入為本地時間


# 錯誤:用 gmtime 結果餵給 mktime
ts = time.mktime(time.gmtime())  # 偏移雙倍時區
# 正確:用 calendar.timegm(gmtime) 或 datetime.timestamp()

3. 夏令時陷阱


# 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

4. 高併發日誌時間戳效能


# 慢:每行調用 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 庫交互、極簡腳本。

copyright © 萬盛學電腦網 all rights reserved