1. 安裝與基本用法

安裝 Arrow

pip install arrow

基本使用示例

import arrow# 獲取當前時間
now = arrow.now()
print(now)  # 輸出: 2023-07-15T14:30:45.123456+08:00# 創建特定時間
dt = arrow.get('2023-07-15 14:30:00', 'YYYY-MM-DD HH:mm:ss')
print(dt)  # 輸出: 2023-07-15T14:30:00+00:00

2. 核心功能

2.1 時間創建與解析

# 從字符串解析
dt1 = arrow.get('2023-07-15')
dt2 = arrow.get('July 15, 2023', 'MMMM D, YYYY')# 從時間戳創建
ts = arrow.get(1689408000)  # 時間戳# 指定時區
tz_aware = arrow.now('US/Pacific')

2.2 時間屬性訪問

dt = arrow.now()print(dt.year)    # 年
print(dt.month)   # 月
print(dt.day)     # 日
print(dt.hour)    # 時
print(dt.minute)  # 分
print(dt.second)  # 秒
print(dt.weekday())  # 星期幾 (0-6, 0是周一)

2.3 時間運算

# 時間加減
tomorrow = dt.shift(days=1)
last_week = dt.shift(weeks=-1)# 時間差計算
diff = tomorrow - last_week
print(diff.days)  # 輸出: 8

2.4 時間格式化

# 格式化為字符串
print(dt.format('YYYY-MM-DD HH:mm:ss'))  # 輸出: 2023-07-15 14:30:45
print(dt.format('dddd, MMMM D, YYYY'))   # 輸出: Saturday, July 15, 2023# 人性化顯示
print(dt.humanize())  # 輸出: "just now", "an hour ago" 等

3. 高級特性

3.1 時區處理

# 本地時間轉其他時區
utc_time = dt.to('UTC')
ny_time = dt.to('America/New_York')# 時區轉換鏈
print(dt.to('UTC').to('Asia/Tokyo').to('US/Pacific'))

3.2 時間范圍生成

# 生成時間范圍
start = arrow.get('2023-07-01')
end = arrow.get('2023-07-31')for day in arrow.Arrow.range('day', start, end):print(day.format('YYYY-MM-DD'))

3.3 時間替換

# 替換部分時間
new_dt = dt.replace(hour=8, minute=0, second=0)

4. 與標準庫對比

4.1 創建時間對象

# 標準庫方式
from datetime import datetime
dt_std = datetime(2023, 7, 15, 14, 30)# Arrow方式
dt_arrow = arrow.get('2023-07-15 14:30:00')

4.2 時區處理

# 標準庫時區處理 (需要pytz)
from datetime import datetime
import pytzdt_std = datetime(2023, 7, 15, tzinfo=pytz.timezone('Asia/Shanghai'))# Arrow時區處理
dt_arrow = arrow.now('Asia/Shanghai')

5. 實際應用示例

5.1 日志時間處理

import arrowlog_time = "2023-07-15T14:30:45.123Z"
dt = arrow.get(log_time)# 轉換為本地時間
local_dt = dt.to('local')
print(f"日志記錄于: {local_dt.humanize()} ({local_dt.format('YYYY-MM-DD HH:mm:ss')})")

5.2 時間區間統計

start = arrow.get('2023-07-01')
end = arrow.get('2023-07-31')# 計算7月有多少個周末
weekends = [day for day in arrow.Arrow.range('day', start, end) if day.weekday() in [5, 6]]
print(f"7月有 {len(weekends)} 個周末日")

5.3 API 時間參數處理

def parse_api_time(time_str, tz='UTC'):"""處理API返回的各種時間格式"""try:return arrow.get(time_str).to(tz)except arrow.parser.ParserError:return arrow.now(tz)

6. 性能考慮

• 解析性能：Arrow 的解析速度比純 Python 的 datetime.strptime 快
• 內存占用：Arrow 對象比 datetime 對象稍大
• 替代方案：對性能要求極高的場景可以考慮 pendulum 或 ciso8601

Arrow 提供了比標準庫更直觀、功能更豐富的日期時間操作接口，特別適合需要復雜時間處理、多時區轉換的應用場景。