在社群動態、留言系統、日誌顯示等場景,常需將儲存的 datetime 物件轉換為人類易讀的相對時間字串(如「3 天前」、「45 分鐘前」)。
from datetime import datetime
def time_passed(value: datetime) -> str:
"""回傳 value 距現在的相對時間字串"""
now = datetime.now()
diff = now - value
if diff.days:
return f"{diff.days} 天前"
minutes = diff.seconds // 60
if minutes < 60:
return f"{minutes} 分鐘前"
hours = minutes // 60
return f"{hours} 小時前"
>>> from datetime import datetime, timedelta
>>> time_passed(datetime.now() - timedelta(days=2, hours=3))
'2 天前'
>>> time_passed(datetime.now() - timedelta(minutes=30))
'30 分鐘前'
>>> time_passed(datetime.now() - timedelta(hours=5))
'5 小時前'
humanize 或 arrow 套件獲得更豐富的多語系支援此函式以簡潔邏輯涵蓋最常見的相對時間顯示需求,適合直接嵌入專案或作為教學範例。