Python 日期時間處理涉及 datetime、date、time、timestamp、struct_time、字串等多種表達。本文以 datetime 為核心,整理轉換關係圖與常用實用函數,涵蓋大多數業務場景。
datetime ←→ string (strftime/strptime)
↑ ↓
timestamp ←→ struct_time (time.localtime/gmtime)
↑ ↓
date
import datetime, time, calendar
# 1. 當前 datetime
now = datetime.datetime.now()
# 2. 當天 date
today = datetime.date.today()
# 3. 明天 / N 天前後
tomorrow = today + datetime.timedelta(days=1)
three_days_ago = now - datetime.timedelta(days=3)
# 4. 當天起始/結束 (00:00:00 / 23:59:59.999999)
day_start = datetime.datetime.combine(today, datetime.time.min)
day_end = datetime.datetime.combine(today, datetime.time.max)
# 5. 兩 datetime 差值 (秒數)
diff_sec = (datetime.datetime(2025,1,1) - now).total_seconds()
# 6. 本週最後一天 (週日)
sunday = today + datetime.timedelta(days=(6 - today.weekday()))
# 7. 本月最後一天
_, last_day = calendar.monthrange(today.year, today.month)
month_end = datetime.date(today.year, today.month, last_day)
# 8. 上月最後一天 (跨年安全)
first_this_month = datetime.date(today.year, today.month, 1)
last_month_end = first_this_month - datetime.timedelta(days=1)
# datetime → string
now.strftime("%Y-%m-%d %H:%M:%S") # '2025-01-15 14:30:00'
# string → datetime
dt = datetime.datetime.strptime("2024-12-31 18:20:10", "%Y-%m-%d %H:%M:%S")
| 代碼 | 含義 | 範例 |
|---|---|---|
| %Y | 四位年份 | 2025 |
| %m | 月份 01-12 | 01 |
| %d | 日期 01-31 | 15 |
| %H | 24小時 00-23 | 14 |
| %M | 分鐘 00-59 | 30 |
| %S | 秒數 00-59 | 00 |
| %f | 微秒 000000-999999 | 123456 |
| %z | 時區偏移 | +0800 |
# datetime → timestamp (float 秒)
ts = time.mktime(now.timetuple()) # 本地時間
ts = now.timestamp() # Python 3.3+, 感知時區
# timestamp → datetime
dt = datetime.datetime.fromtimestamp(ts) # 本地時間
dt = datetime.datetime.utcfromtimestamp(ts) # UTC
# datetime → struct_time
st = now.timetuple()
# struct_time → datetime (經由 timestamp)
ts = time.mktime(st)
dt = datetime.datetime.fromtimestamp(ts)
datetime 為主,只在輸入/輸出 (API、DB、UI) 做轉換。zoneinfo,舊版用 pytz;儲存統一用 UTC。datetime/date 後用 timedelta。datetime.strptime 較慢,可考慮 dateutil.parser.parse 或預編譯正則。收藏此表,日期時間處理不再查文件。