(year=2026, month=6, day=18, hour=9, minute=15, second=30,
 week_day=3, year_day=169, is_dst=0)

from datetime import date, time, datetime, timedelta

from datetime import date

# 方式一：指定年月日
d1 = date(2026, 6, 18)
print(d1)  # 2026-06-18

# 方式二：获取今天的日期
today = date.today()
print(today)  # 2026-06-18（取决于运行日期）

# 方式三：从时间戳转换
ts_date = date.fromtimestamp(1755000000)
print(ts_date)  # 对应的日期

d = date(2026, 6, 18)
print(d.year)    # 2026
print(d.month)   # 6
print(d.day)     # 18

d = date(2026, 6, 18)

# 星期几
print(d.weekday())     # 3 → 周一=0, 周日=6
print(d.isoweekday())  # 4 → 周一=1, 周日=7

# ISO 日历
print(d.isocalendar())  # (2026, 25, 4) → (ISO年, ISO周, ISO星期)

# 替换部分字段（返回新对象，原对象不变）
d2 = d.replace(year=2025)
print(d2)  # 2025-06-18

# 格式化输出
print(d.strftime('%Y/%m/%d'))  # 2026/06/18

# 比较运算
print(d > date(2025, 1, 1))  # True

# ❌ 错误认知：认为 replace 会修改原对象
d = date(2026, 6, 18)
d.replace(year=2025)  # 废弃了返回值！
print(d)  # 仍然是 2026-06-18（原对象不变）

# ✅ 正确做法：接收返回值
d_new = d.replace(year=2025)

from datetime import time

# 时分秒微秒
t1 = time(9, 15, 30)
print(t1)  # 09:15:30

# 带微秒
t2 = time(9, 15, 30, 123456)
print(t2)  # 09:15:30.123456

# 带时区信息
from datetime import timezone, timedelta
tz = timezone(timedelta(hours=8))
t3 = time(9, 15, tzinfo=tz)
print(t3)  # 09:15:00+08:00

t = time(14, 30, 45, 654321)
print(t.hour)         # 14
print(t.minute)       # 30
print(t.second)       # 45
print(t.microsecond)  # 654321
print(t.tzinfo)       # None（未设置时区）

from datetime import datetime

# 方式一：直接指定
dt1 = datetime(2026, 6, 18, 9, 15, 30)
print(dt1)  # 2026-06-18 09:15:30

# 方式二：获取当前时间
now = datetime.now()      # 本地时间
utc_now = datetime.utcnow()  # UTC 时间（naive）

# 方式三：从时间戳转换
ts = 1755000000
dt2 = datetime.fromtimestamp(ts)      # 转为本地时间
dt2_utc = datetime.utcfromtimestamp(ts)  # 转为 UTC

# 方式四：从字符串解析
dt3 = datetime.strptime('2026-06-18 09:15:30', '%Y-%m-%d %H:%M:%S')

# 方式五：组合 date 和 time
from datetime import date, time
d = date(2026, 6, 18)
t = time(9, 15)
combined = datetime.combine(d, t)

naive = datetime(2026, 6, 18, 9, 15)
print(naive.tzinfo)  # None

from datetime import timezone, timedelta
tz = timezone(timedelta(hours=8))
aware = datetime(2026, 6, 18, 9, 15, tzinfo=tz)
print(aware.tzinfo)  # UTC+08:00

# ❌ 错误：混合使用 naive 和 aware
naive = datetime(2026, 6, 18, 9, 15)
aware = datetime(2026, 6, 18, 9, 15, tzinfo=timezone.utc)
# naive - aware  → TypeError: can't subtract offset-naive and offset-aware datetimes

# ✅ 正确：先统一
aware2 = naive.replace(tzinfo=timezone.utc)  # 假设 naive 是 UTC
result = aware2 - aware  # 可行

from datetime import timedelta

td = timedelta(days=5, hours=3, minutes=30)
print(td)  # 5 days, 3:30:00

td = timedelta(hours=25, minutes=90)
print(td)             # 1 day, 2:30:00
print(td.days)        # 1
print(td.seconds)     # 9000 (= 2*3600 + 30*60)
print(td.microseconds) # 0
print(td.total_seconds())  # 90000.0

from datetime import datetime, timedelta

# 两个时间相减 → timedelta
start = datetime(2026, 6, 1, 9, 0)
end = datetime(2026, 6, 18, 9, 0)
delta = end - start
print(delta)              # 17 days, 0:00:00
print(delta.days)         # 17
print(delta.total_seconds())  # 1468800.0

# datetime ± timedelta → 新的 datetime
future = start + timedelta(days=7)
past = start - timedelta(hours=3)
print(future)  # 2026-06-08 09:00:00
print(past)    # 2026-06-01 06:00:00

# timedelta 之间的运算
td1 = timedelta(days=3)
td2 = timedelta(hours=12)
print(td1 + td2)  # 3 days, 12:00:00
print(td1 * 2)    # 6 days, 0:00:00
print(td1 / 2)    # 1 day, 12:00:00

# 所有参数都是可选的，默认值为 0
td = timedelta(
    days=0,
    seconds=0,
    microseconds=0,
    milliseconds=0,     # 自动转微秒
    minutes=0,          # 自动转秒
    hours=0,            # 自动转秒
    weeks=0             # 自动转天
)

from datetime import datetime, timedelta

# ❌ 错误：没有 timedelta(months=1) 的概念
# timedelta(months=1) → TypeError

# 因为"一个月"的天数是不确定的（28-31天）
# 加一个月需要通过第三方库如 dateutil
from dateutil.relativedelta import relativedelta

dt = datetime(2026, 1, 31)
# 加一个月 → 应该得到 2026-02-28（2月最后一天）
# relativedelta 会帮你处理好
new_dt = dt + relativedelta(months=1)
print(new_dt)  # 2026-02-28 00:00:00

# 国际标准格式
fmt_iso = '%Y-%m-%d'              # 2026-06-18
fmt_iso_full = '%Y-%m-%d %H:%M:%S'  # 2026-06-18 09:15:30

# 中文格式
fmt_cn = '%Y年%m月%d日 %H:%M'    # 2026年06月18日 09:15

# 美国风格
fmt_us = '%m/%d/%Y'               # 06/18/2026

# 日志格式
fmt_log = '%d/%b/%Y:%H:%M:%S %z'  # 18/Jun/2026:09:15:30 +0800

# 紧凑格式
fmt_compact = '%Y%m%d_%H%M%S'    # 20260618_091530（适合文件名）

# ⚠️ 坑 1：%Y 不能匹配 2 位年份
# datetime.strptime('26-06-18', '%y-%m-%d') ✅ 可以
# datetime.strptime('26-06-18', '%Y-%m-%d') ❌ %Y 要求 4 位

# ⚠️ 坑 2：月份和日期必须匹配
# datetime.strptime('2026-02-30', '%Y-%m-%d') → ValueError
# 因为 2 月只有 28/29 天

# ⚠️ 坑 3：%f 是 6 位微秒，但可能只有 1-6 位
from datetime import datetime
dt = datetime.strptime('2026-06-18 09:15:30.123', '%Y-%m-%d %H:%M:%S.%f')
print(dt.microsecond)  # 123000（自动补 0）
dt2 = datetime.strptime('2026-06-18 09:15:30.123456', '%Y-%m-%d %H:%M:%S.%f')
print(dt2.microsecond)  # 123456

# ⚠️ 坑 4：%z 的格式问题
# Python 3.6 之前不支持 %z 的可选冒号
# Python 3.7+ 支持 -05:00 和 -0500 两种格式

import time

# 当前时间戳
ts = time.time()
print(ts)  # 1755000000.123456

# 结构化时间（本地）
local_time = time.localtime()        # 当前本地时间
local_ts = time.localtime(ts)        # 时间戳 → 结构化时间

# 结构化时间（UTC）
utc_time = time.gmtime()             # 当前 UTC 时间
utc_ts = time.gmtime(ts)             # 时间戳 → UTC 结构化时间

# 结构化时间 → 时间戳
ts_back = time.mktime(local_time)

# 结构化时间 → 字符串
str_time = time.asctime(local_time)  # 'Thu Jun 18 09:15:30 2026'
str_ts = time.ctime(ts)              # 同上，直接从时间戳转

# 格式化（类似 strftime）
formatted = time.strftime('%Y-%m-%d %H:%M:%S', local_time)

# 解析（类似 strptime）
parsed = time.strptime('2026-06-18', '%Y-%m-%d')

import time

# time.perf_counter() — 高精度性能计数器
# 适合测量代码块执行时间
start = time.perf_counter()
# ... 执行代码 ...
end = time.perf_counter()
print(f"执行耗时: {end - start:.6f} 秒")

# time.process_time() — CPU 时间
# 只统计当前进程实际占用的 CPU 时间
cpu_start = time.process_time()
# ... 执行 CPU 密集型操作 ...
cpu_end = time.process_time()
print(f"CPU 时间: {cpu_end - cpu_start:.6f} 秒")

import time

# 暂停执行
time.sleep(2)        # 暂停 2 秒
time.sleep(0.5)      # 暂停 500 毫秒
time.sleep(0.001)    # 暂停 1 毫秒

# ⚠️ sleep 的精度取决于操作系统
# Windows: ~15ms 精度
# Linux: ~1μs 精度
# 高精度定时需要用 select 或 threading.Timer

from zoneinfo import ZoneInfo
from datetime import datetime, timezone, timedelta

# 创建时区对象
beijing = ZoneInfo('Asia/Shanghai')
new_york = ZoneInfo('America/New_York')
utc = timezone.utc

# 创建带时区的 datetime
dt_beijing = datetime(2026, 6, 18, 9, 15, tzinfo=beijing)
print(dt_beijing)  # 2026-06-18 09:15:00+08:00

# 时区转换
dt_utc = dt_beijing.astimezone(utc)
print(dt_utc)  # 2026-06-18 01:15:00+00:00

dt_ny = dt_beijing.astimezone(new_york)
print(dt_ny)  # 2026-06-17 21:15:00-04:00（夏令时）

import pytz
from datetime import datetime

beijing = pytz.timezone('Asia/Shanghai')
new_york = pytz.timezone('America/New_York')

# ⚠️ pytz 的特殊用法：不要直接传 tzinfo
# ❌ 错误
# dt = datetime(2026, 6, 18, 9, 15, tzinfo=beijing)

# ✅ 正确：使用 localize
dt_naive = datetime(2026, 6, 18, 9, 15)
dt_beijing = beijing.localize(dt_naive)

# 转换时区
dt_ny = dt_beijing.astimezone(new_york)
print(dt_beijing)  # 2026-06-18 09:15:00+08:00
print(dt_ny)       # 2026-06-17 21:15:00-04:00

from datetime import datetime, date, time
from zoneinfo import ZoneInfo

def convert_meeting_time(
    local_date: date,
    local_time: time,
    local_tz: str,
    target_tz: str
) -> datetime:
    """
    将某个时区的会议时间转换到目标时区
    
    示例：北京下午3点的会议，纽约是几点？
    """
    local_dt = datetime.combine(
        local_date,
        local_time,
        tzinfo=ZoneInfo(local_tz)
    )
    target_dt = local_dt.astimezone(ZoneInfo(target_tz))
    return target_dt

# 使用示例
result = convert_meeting_time(
    local_date=date(2026, 6, 18),
    local_time=time(15, 0),
    local_tz='Asia/Shanghai',
    target_tz='America/New_York'
)
print(f"北京 15:00 → 纽约 {result.strftime('%Y-%m-%d %H:%M %Z')}")
# 北京 15:00 → 纽约 2026-06-18 03:00 EDT（夏令时，纽约慢12小时）

# 如果要显示所有参会者时间
meeting = datetime(2026, 6, 18, 15, 0, tzinfo=ZoneInfo('Asia/Shanghai'))
cities = {
    '北京': 'Asia/Shanghai',
    '东京': 'Asia/Tokyo',
    '纽约': 'America/New_York',
    '伦敦': 'Europe/London',
    '悉尼': 'Australia/Sydney',
}
for city, tz_name in cities.items():
    local_time = meeting.astimezone(ZoneInfo(tz_name))
    print(f"{city}: {local_time.strftime('%Y-%m-%d %H:%M %Z')}")

from datetime import datetime

log_time = '18/Jun/2026:09:15:30 +0800'
fmt = '%d/%b/%Y:%H:%M:%S %z'
dt = datetime.strptime(log_time, fmt)
print(dt)  # 2026-06-18 09:15:30+08:00

from datetime import date, timedelta

def business_days(start: date, end: date) -> list[date]:
    """计算两个日期之间的所有工作日（排除周末）"""
    days = []
    current = start
    while current <= end:
        if current.weekday() < 5:  # 周一=0, 周五=4
            days.append(current)
        current += timedelta(days=1)
    return days

# 使用
start = date(2026, 6, 1)
end = date(2026, 6, 30)
work_days = business_days(start, end)
print(f"6月工作日: {len(work_days)} 天")
# 6月工作日: 22 天

from datetime import datetime, timezone

def timestamp_converter(ts: float = None, to_tz: str = 'local'):
    """
    时间戳全能转换器
    - 不传参数：显示当前时间
    - 传时间戳：显示对应时间
    """
    if ts is None:
        ts = datetime.now().timestamp()
    
    dt_utc = datetime.fromtimestamp(ts, tz=timezone.utc)
    
    result = {
        'timestamp': ts,
        'utc_time': dt_utc.strftime('%Y-%m-%d %H:%M:%S UTC'),
        'iso_format': dt_utc.isoformat(),
        'readable': dt_utc.strftime('%A, %B %d, %Y %H:%M:%S UTC'),
    }
    
    if to_tz == 'local':
        dt_local = datetime.fromtimestamp(ts)
        result['local_time'] = dt_local.strftime('%Y-%m-%d %H:%M:%S %Z')
    
    return result

from datetime import datetime, timedelta
from typing import Generator

def time_series(
    start: datetime,
    end: datetime,
    step: timedelta
) -> Generator[datetime, None, None]:
    """生成从 start 到 end 的时间序列，步长为 step"""
    current = start
    while current <= end:
        yield current
        current += step

# 生成 2026-06-18 每半小时的时间点
start = datetime(2026, 6, 18, 0, 0)
end = datetime(2026, 6, 18, 23, 59)
for dt in time_series(start, end, timedelta(minutes=30)):
    print(dt.strftime('%H:%M'), end=' ')
# 00:00 00:30 01:00 ... 23:30

from datetime import datetime, timezone, timedelta

naive = datetime(2026, 6, 18, 9, 0)
aware = datetime(2026, 6, 18, 9, 0, tzinfo=timezone.utc)

# 💥 TypeError
# result = aware - naive

# ✅ 解决方案：统一为一种类型
# 方案A：给 naive 加上时区
naive_aware = naive.replace(tzinfo=timezone.utc)
result = aware - naive_aware  # ✅

# 方案B：去掉 aware 的时区
aware_naive = aware.replace(tzinfo=None)
result = aware_naive - naive  # ✅

# datetime 是不可变的，可以作为字典键
events = {
    datetime(2026, 6, 18, 9, 0): '晨会',
    datetime(2026, 6, 18, 14, 0): '技术分享',
}

# ✅ 可以正常使用
print(events[datetime(2026, 6, 18, 9, 0)])  # '晨会'

# ❌ timedelta 虽然大多不可变但行为不同
# 不过通常没人用 timedelta 做字典键

from datetime import datetime

# ✅ 英文系统
dt = datetime.strptime('18-Jun-2026', '%d-%b-%Y')

# ❌ 中文系统可能报错
# ValueError: time data '18-Jun-2026' does not match format '%d-%b-%Y'

# ✅ 解决方案：临时设置 locale
import locale
locale.setlocale(locale.LC_TIME, 'en_US.UTF-8')  # Unix
# 或 'en_US' (Linux), 'en_GB' (某些系统)
dt = datetime.strptime('18-Jun-2026', '%d-%b-%Y')

import time

# 想要精确等待 100 毫秒
time.sleep(0.1)

# ⚠️ 实际等待时间可能远大于 100ms
# Windows: 通常 ~15ms 精度，即可能等待 112-115ms
# Linux: 通常 ~1μs 精度，误差很小

# ✅ 高精度方案
import select
# select.select([], [], [], 0.1)  # 更精确

from datetime import datetime

# ❌ 错误：utcnow() 返回 naive datetime
# 你以为存的是 UTC，但其实没有时区信息
utc_naive = datetime.utcnow()  # ⚠️ 不推荐

# ✅ 正确：显式指定 UTC
from datetime import timezone
utc_aware = datetime.now(timezone.utc)  # ✅ 带时区

# 或者用 datetime.now(timezone.utc) 获取 aware 对象

from datetime import datetime, timedelta

# 加一天的安全做法
dt = datetime(2026, 2, 28)
next_day = dt + timedelta(days=1)
print(next_day)  # 2026-03-01（正确处理了闰年）

# 但如果想加一个月，不能直接用 timedelta
# ❌ timedelta(months=1) 不存在

# ✅ 使用 dateutil
from dateutil.relativedelta import relativedelta
dt = datetime(2026, 1, 31)
next_month = dt + relativedelta(months=1)
print(next_month)  # 2026-02-28（自动处理月末）

import time

# ❌ 不要用 time() 测量性能
start = time.time()
# ... 代码 ...
end = time.time()
# 问题：如果系统时间被 NTP 调整，结果可能是负数！

# ✅ 用 perf_counter()
start = time.perf_counter()
# ... 代码 ...
end = time.perf_counter()
print(f"耗时: {end - start:.6f}s")