pip install arrow

import arrow

# 獲取當(dāng)前時(shí)間（帶時(shí)區(qū)）
now = arrow.now()
print(f"當(dāng)前時(shí)間: {now}")  # 2023-07-20T14:30:45.123456+08:00

# 創(chuàng)建特定時(shí)間
birthday = arrow.get(1990, 5, 15, 14, 30)  # 年月日時(shí)分
print(f"生日: {birthday}")

# 從字符串解析（自動(dòng)識(shí)別格式）
meeting_time = arrow.get("2023-08-15 14:30:00")
print(f"會(huì)議時(shí)間: {meeting_time}")

# 從時(shí)間戳創(chuàng)建
timestamp = 1689840000  # Unix時(shí)間戳
launch_time = arrow.get(timestamp)
print(f"發(fā)布時(shí)間: {launch_time}")

# 格式化為字符串
print(now.format("YYYY年MM月DD日 HH:mm:ss"))  # 2023年07月20日 14:30:45

# 轉(zhuǎn)換為datetime對(duì)象
dt = now.datetime
print(type(dt))  # <class 'datetime.datetime'>

# 轉(zhuǎn)換為時(shí)間戳
print(now.timestamp())  # 1689841845.123456

# 人性化時(shí)間顯示
print(now.humanize())  # 幾秒前
print(now.shift(minutes=-15).humanize())  # 15分鐘前

# 時(shí)間偏移（鏈?zhǔn)秸{(diào)用）
tomorrow_9am = now.shift(days=1).replace(hour=9, minute=0, second=0)
print(f"明天9點(diǎn): {tomorrow_9am}")

# 時(shí)區(qū)轉(zhuǎn)換
utc_time = now.to('UTC')
print(f"UTC時(shí)間: {utc_time}")

ny_time = now.to('America/New_York')
print(f"紐約時(shí)間: {ny_time}")

# 時(shí)間差計(jì)算
future = arrow.get(2024, 1, 1)
days_left = (future - now).days
print(f"距離2024年還有 {days_left} 天")

# 獲取今天的時(shí)間范圍
start_of_day = now.floor('day')
end_of_day = now.ceil('day')
print(f"今日開始: {start_of_day}")
print(f"今日結(jié)束: {end_of_day}")

# 生成時(shí)間區(qū)間
start = arrow.get(2023, 1, 1)
end = arrow.get(2023, 1, 5)

# 按天生成范圍
for day in arrow.Arrow.range('day', start, end):
    print(day.format("MM/DD"))

# 按月生成范圍
for month_start, month_end in arrow.Arrow.span_range('month', start, end):
    print(f"{month_start.format('YYYY-MM')}: {month_start} 到 {month_end}")

# 獲取時(shí)間屬性
print(f"年: {now.year}, 月: {now.month}, 日: {now.day}")
print(f"時(shí): {now.hour}, 分: {now.minute}, 秒: {now.second}")
print(f"星期: {now.weekday()}")  # 0=周一, 6=周日

# 時(shí)間比較
if now > tomorrow_9am:
    print("已經(jīng)過了明天9點(diǎn)")
else:
    print("還沒到明天9點(diǎn)")

# 檢查是否為今天
if now.date() == arrow.now().date():
    print("這是今天的時(shí)間")

# 帶本地化的人性化時(shí)間
print(now.humanize(locale='zh'))  # 中文顯示: "幾秒前"
print(now.shift(days=-2).humanize(locale='fr'))  # 法語(yǔ): "il y a 2 jours"

# 指定粒度
print(now.shift(hours=3, minutes=15).humanize(
    granularity=["hour", "minute"],
    locale='zh'
))  # "3小時(shí)15分鐘內(nèi)"

def working_days(start_date, end_date, holidays=None):
    """計(jì)算兩個(gè)日期之間的工作日天數(shù)"""
    if holidays is None:
        holidays = []
    
    start = arrow.get(start_date)
    end = arrow.get(end_date)
    
    # 確保開始日期在結(jié)束日期之前
    if start > end:
        start, end = end, start
    
    # 初始化計(jì)數(shù)器
    working_days_count = 0
    current = start
    
    # 遍歷日期范圍
    while current <= end:
        # 檢查是否為周末 (周一到周五為工作日)
        if current.weekday() < 5:
            # 檢查是否為節(jié)假日
            if current.format("YYYY-MM-DD") not in holidays:
                working_days_count += 1
        current = current.shift(days=1)
    
    return working_days_count

???????# 使用示例
holidays = ["2023-10-01", "2023-10-02", "2023-10-03"]  # 國(guó)慶假期
work_days = working_days("2023-10-01", "2023-10-07", holidays)
print(f"2023年國(guó)慶假期的工作日天數(shù): {work_days}")  # 輸出: 0

class BirthdayManager:
    def __init__(self):
        self.birthdays = {}
    
    def add_birthday(self, name, date):
        """添加生日日期 (格式: YYYY-MM-DD)"""
        self.birthdays[name] = arrow.get(date)
    
    def upcoming_birthdays(self, days=30):
        """獲取未來(lái)指定天數(shù)內(nèi)的生日"""
        today = arrow.now()
        upcoming = []
        
        for name, bday in self.birthdays.items():
            # 計(jì)算今年的生日
            next_bday = bday.replace(year=today.year)
            if next_bday < today:
                next_bday = next_bday.shift(years=1)
            
            # 檢查是否在指定天數(shù)內(nèi)
            days_left = (next_bday - today).days
            if 0 <= days_left <= days:
                upcoming.append((name, next_bday, days_left))
        
        # 按時(shí)間排序
        upcoming.sort(key=lambda x: x[1])
        return upcoming
    
    def age_on_birthday(self, name):
        """計(jì)算下次生日時(shí)的年齡"""
        bday = self.birthdays.get(name)
        if not bday:
            return None
            
        today = arrow.now()
        next_bday = bday.replace(year=today.year)
        if next_bday < today:
            next_bday = next_bday.shift(years=1)
        
        return next_bday.year - bday.year

# 使用示例
manager = BirthdayManager()
manager.add_birthday("Alice", "1990-05-15")
manager.add_birthday("Bob", "1985-12-03")
manager.add_birthday("Charlie", "2000-07-22")

???????print("\n未來(lái)30天內(nèi)的生日:")
for name, date, days_left in manager.upcoming_birthdays():
    print(f"{name}: {date.format('MM月DD日')} ({days_left}天后), 將滿 {manager.age_on_birthday(name)} 歲")

# 使用鏈?zhǔn)秸{(diào)用提高可讀性
next_monday_9am = (
    arrow.now()
    .shift(weeks=1)
    .replace(hour=9, minute=0, second=0)
    .ceil('week')  # 下周一開始
)

# Arrow可以解析各種格式的時(shí)間字符串
arrow.get("2023-06-15")  # ISO格式
arrow.get("June 15, 2023")  # 自然語(yǔ)言
arrow.get("15/06/23", "DD/MM/YY")  # 指定格式

# 獲取本季度的時(shí)間范圍
start_of_quarter = now.floor('quarter')
end_of_quarter = now.ceil('quarter')

# 創(chuàng)建帶有時(shí)區(qū)的時(shí)間
aware_time = arrow.get(2023, 6, 15, tzinfo='Asia/Shanghai')

# 不要使用naive時(shí)間
naive_time = arrow.get(2023, 6, 15)  # 不推薦，缺少時(shí)區(qū)信息

# 使用span_range高效處理時(shí)間范圍
for start, end in arrow.Arrow.span_range('month', start_date, end_date):
    process_month(start, end)

# 重用現(xiàn)有對(duì)象進(jìn)行時(shí)間操作
base = arrow.now()
times = [base.shift(hours=i) for i in range(24)]

# 比較時(shí)間戳比比較對(duì)象更快
if now.timestamp() > deadline.timestamp():
    print("已過期")