09. tzinfo 与 timezone 概述 tzinfo是 datetime 模块中的时区信息基类 （抽象类），timezone是它的一个具体实现（Python 3.2+）。时区处理是国际化应用中的关键环节，正确使用时区可以避免时间混乱。
维度 内容 What 时区信息基类（tzinfo）和具体实现（timezone） Why 处理不同时区的时间，支持国际化 When 跨时区应用、UTC 时间转换、全球化部署 Where from datetime import tzinfo, timezoneWho 需要处理时区的开发者 How tz = timezone(timedelta(hours=8))
1. 时区基础概念 1.1 naive vs aware 类型 说明 是否含时区 示例 naive 不包含时区信息 ❌ datetime(2026, 4, 19, 14, 30)aware 包含时区信息 ✅ datetime(2026, 4, 19, 14, 30, tzinfo=timezone.utc)
from datetimeimport datetime, timezone# naive datetime（无时区） naive= datetime. now( ) print ( f"naive: { naive} " ) print ( f"tzinfo: { naive. tzinfo} " ) # None # aware datetime（有时区） aware= datetime. now( timezone. utc) print ( f"aware: { aware} " ) print ( f"tzinfo: { aware. tzinfo} " ) # UTC 1.2 UTC 和时区偏移 from datetimeimport datetime, timezone, timedelta# UTC 时区 utc= timezone. utcprint ( f"UTC: { utc} " ) # 东八区（北京时间） beijing_tz= timezone( timedelta( hours= 8 ) ) print ( f"北京时间: { beijing_tz} " ) # 纽约时间（西五区） ny_tz= timezone( timedelta( hours= - 5 ) ) print ( f"纽约时间: { ny_tz} " ) 2. timezone 类 2.1 创建 timezone 对象 from datetimeimport datetime, timezone, timedelta# UTC 时区 utc_tz= timezone. utcprint ( f"UTC: { utc_tz} " ) # 固定偏移时区 beijing_tz= timezone( timedelta( hours= 8 ) ) print ( f"北京时间: { beijing_tz} " ) # 带名称的时区 named_tz= timezone( timedelta( hours= 8 ) , name= "Asia/Shanghai" ) print ( f"命名时区: { named_tz} " ) 2.2 创建 aware datetime from datetimeimport datetime, timezone, timedelta# 方式1：创建时指定时区 dt= datetime( 2026 , 4 , 19 , 14 , 30 , 0 , tzinfo= timezone( timedelta( hours= 8 ) ) ) print ( dt) # 2026-04-19 14:30:00+08:00 # 方式2：使用 now() 指定时区 beijing_now= datetime. now( timezone( timedelta( hours= 8 ) ) ) print ( f"北京时间: { beijing_now} " ) # 方式3：UTC 时间 utc_now= datetime. now( timezone. utc) print ( f"UTC 时间: { utc_now} " ) # 方式4：naive → aware naive= datetime( 2026 , 4 , 19 , 14 , 30 , 0 ) aware= naive. replace( tzinfo= timezone( timedelta( hours= 8 ) ) ) print ( f"转换后: { aware} " ) 2.3 timezone 方法 from datetimeimport datetime, timezone, timedelta tz= timezone( timedelta( hours= 8 ) , name= "Asia/Shanghai" ) dt= datetime( 2026 , 4 , 19 , 14 , 30 , 0 , tzinfo= tz) # utcoffset() - UTC 偏移 print ( f"UTC 偏移: { tz. utcoffset( dt) } " ) # 8:00:00 # dst() - 夏令时（固定偏移时区返回 None） print ( f"夏令时: { tz. dst( dt) } " ) # None # tzname() - 时区名称 print ( f"时区名称: { tz. tzname( dt) } " ) # Asia/Shanghai # fromutc() - UTC 转本地时间 utc_dt= datetime( 2026 , 4 , 19 , 6 , 30 , 0 , tzinfo= timezone. utc) local_dt= tz. fromutc( utc_dt) print ( f"UTC 6:30 → 本地: { local_dt} " ) # 2026-04-19 14:30:00+08:00 3. 时区转换 3.1 astimezone() 方法 from datetimeimport datetime, timezone, timedelta# 创建 UTC 时间 utc_dt= datetime( 2026 , 4 , 19 , 6 , 30 , 0 , tzinfo= timezone. utc) print ( f"UTC: { utc_dt} " ) # 转换为北京时间 beijing_tz= timezone( timedelta( hours= 8 ) ) beijing_dt= utc_dt. astimezone( beijing_tz) print ( f"北京时间: { beijing_dt} " ) # 转换为纽约时间 ny_tz= timezone( timedelta( hours= - 5 ) ) ny_dt= utc_dt. astimezone( ny_tz) print ( f"纽约时间: { ny_dt} " ) # 转换为 UTC（不同时区之间转换） back_to_utc= beijing_dt. astimezone( timezone. utc) print ( f"转回 UTC: { back_to_utc} " ) 3.2 时区转换示例 from datetimeimport datetime, timezone, timedelta# 定义时区 UTC= timezone. utc CST= timezone( timedelta( hours= 8 ) ) # 中国标准时间 EST= timezone( timedelta( hours= - 5 ) ) # 美国东部时间 PST= timezone( timedelta( hours= - 8 ) ) # 美国太平洋时间 JST= timezone( timedelta( hours= 9 ) ) # 日本标准时间 # 北京时间 14:30 beijing_time= datetime( 2026 , 4 , 19 , 14 , 30 , 0 , tzinfo= CST) # 转换为其他时区 print ( f"北京时间: { beijing_time} " ) print ( f"UTC 时间: { beijing_time. astimezone( UTC) } " ) print ( f"纽约时间: { beijing_time. astimezone( EST) } " ) print ( f"洛杉矶时间: { beijing_time. astimezone( PST) } " ) print ( f"东京时间: { beijing_time. astimezone( JST) } " ) 4. 实用示例 4.1 判断是否同一时区 from datetimeimport datetime, timezone, timedeltadef same_timezone ( dt1, dt2) : """判断两个 datetime 是否在同一时区""" if dt1. tzinfois None or dt2. tzinfois None : return False return dt1. utcoffset( ) == dt2. utcoffset( ) # 示例 cst= timezone( timedelta( hours= 8 ) ) beijing1= datetime( 2026 , 4 , 19 , 14 , 30 , 0 , tzinfo= cst) beijing2= datetime( 2026 , 4 , 19 , 16 , 30 , 0 , tzinfo= cst) utc= datetime( 2026 , 4 , 19 , 6 , 30 , 0 , tzinfo= timezone. utc) print ( f"同一时区: { same_timezone( beijing1, beijing2) } " ) # True print ( f"不同时区: { same_timezone( beijing1, utc) } " ) # False 4.2 转换为本地时间 from datetimeimport datetime, timezone, timedeltaimport timedef to_local_time ( utc_dt) : """将 UTC 时间转换为本地时间""" # 获取本地时区偏移（秒） local_offset= - time. timezone local_tz= timezone( timedelta( seconds= local_offset) ) return utc_dt. astimezone( local_tz) # 示例 utc_now= datetime. now( timezone. utc) local_now= to_local_time( utc_now) print ( f"UTC: { utc_now} " ) print ( f"本地: { local_now} " ) 4.3 获取当前各时区时间 from datetimeimport datetime, timezone, timedelta# 常用时区 ZONES= { "UTC" : timezone. utc, "北京时间" : timezone( timedelta( hours= 8 ) ) , "东京时间" : timezone( timedelta( hours= 9 ) ) , "纽约时间" : timezone( timedelta( hours= - 5 ) ) , "伦敦时间" : timezone( timedelta( hours= 0 ) ) , "悉尼时间" : timezone( timedelta( hours= 11 ) ) , } print ( "世界各地当前时间：" ) print ( "=" * 40 ) for name, tzin ZONES. items( ) : now= datetime. now( tz) print ( f" { name: 8 } : { now. strftime( '%Y-%m-%d %H:%M:%S' ) } " ) 4.4 时间戳与时区 from datetimeimport datetime, timezone, timedelta# 时间戳是 UTC 时间 timestamp= 1745030000 # 转换为不同时区的 datetime utc_dt= datetime. fromtimestamp( timestamp, tz= timezone. utc) beijing_dt= datetime. fromtimestamp( timestamp, tz= timezone( timedelta( hours= 8 ) ) ) print ( f"时间戳: { timestamp} " ) print ( f"UTC 时间: { utc_dt} " ) print ( f"北京时间: { beijing_dt} " ) # datetime 转时间戳（注意：naive datetime 会被当作本地时间） naive_dt= datetime( 2026 , 4 , 19 , 14 , 30 , 0 ) aware_dt= naive_dt. replace( tzinfo= timezone( timedelta( hours= 8 ) ) ) print ( f"naive 时间戳: { naive_dt. timestamp( ) } " ) print ( f"aware 时间戳: { aware_dt. timestamp( ) } " ) 5. zoneinfo 模块（Python 3.9+） 5.1 ZoneInfo 基础 from datetimeimport datetimefrom zoneinfoimport ZoneInfo# 创建时区对象 shanghai_tz= ZoneInfo( "Asia/Shanghai" ) tokyo_tz= ZoneInfo( "Asia/Tokyo" ) newyork_tz= ZoneInfo( "America/New_York" ) london_tz= ZoneInfo( "Europe/London" ) # 创建 aware datetime now_shanghai= datetime. now( shanghai_tz) print ( f"上海: { now_shanghai} " ) # 时区转换 now_tokyo= now_shanghai. astimezone( tokyo_tz) print ( f"东京: { now_tokyo} " ) 5.2 可用时区列表 from zoneinfoimport ZoneInfo, available_timezones# 获取所有可用时区 all_zones= available_timezones( ) print ( f"总时区数: { len ( all_zones) } " ) # 搜索中国相关时区 china_zones= [ zfor zin all_zonesif z. startswith( "Asia/Shang" ) ] print ( f"中国时区: { china_zones} " ) # 搜索美国相关时区 us_zones= [ zfor zin all_zonesif z. startswith( "America/" ) ] [ : 10 ] print ( f"美国时区示例: { us_zones} " ) 6. 完整示例 from datetimeimport datetime, timezone, timedeltafrom zoneinfoimport ZoneInfoprint ( "=" * 50 ) print ( "时区处理综合示例" ) print ( "=" * 50 ) # 1. naive vs aware print ( "\n1. naive vs aware" ) naive= datetime. now( ) aware= datetime. now( timezone. utc) print ( f"naive: { naive} (tzinfo= { naive. tzinfo} )" ) print ( f"aware: { aware} (tzinfo= { aware. tzinfo} )" ) # 2. 创建 timezone print ( "\n2. 创建 timezone" ) beijing_tz= timezone( timedelta( hours= 8 ) ) tokyo_tz= timezone( timedelta( hours= 9 ) ) ny_tz= timezone( timedelta( hours= - 5 ) ) print ( f"北京时间: { beijing_tz} " ) print ( f"东京时间: { tokyo_tz} " ) print ( f"纽约时间: { ny_tz} " ) # 3. 时区转换 print ( "\n3. 时区转换" ) utc_time= datetime( 2026 , 4 , 19 , 6 , 30 , 0 , tzinfo= timezone. utc) beijing_time= utc_time. astimezone( beijing_tz) tokyo_time= utc_time. astimezone( tokyo_tz) ny_time= utc_time. astimezone( ny_tz) print ( f"UTC: { utc_time} " ) print ( f"北京: { beijing_time} " ) print ( f"东京: { tokyo_time} " ) print ( f"纽约: { ny_time} " ) # 4. ZoneInfo（Python 3.9+） print ( "\n4. ZoneInfo 示例" ) try : shanghai_tz= ZoneInfo( "Asia/Shanghai" ) now_shanghai= datetime. now( shanghai_tz) print ( f"上海时间: { now_shanghai} " ) except Exceptionas e: print ( f"ZoneInfo 不可用: { e} " ) # 5. 实用功能 print ( "\n5. 实用功能" ) # 判断夏令时 print ( f"北京时区是否有夏令时: { beijing_tz. dst( None ) } " ) print ( f"UTC 偏移: { beijing_tz. utcoffset( None ) } " ) 7. 常见陷阱 陷阱 说明 解决方案 naive 与 aware 比较 不同时区类型不能直接比较 统一转换为 aware 夏令时 timezone不支持夏令时使用zoneinfo.ZoneInfo utcnow() 废弃 Python 3.12+ 已废弃 使用datetime.now(timezone.utc) 时区名称 固定偏移没有标准名称 使用zoneinfo获取 IANA 名称
8. timezone vs zoneinfo 对比 特性 timezone zoneinfo Python 版本 3.2+ 3.9+ 夏令时支持 ❌ ✅ 历史时区数据 ❌ ✅ 时区名称 自定义 IANA 标准 使用难度 简单 中等 推荐场景 固定偏移时区 完整时区支持
9. 总结 类型 说明 创建方式 naive 无时区信息 datetime.now()aware 有时区信息 datetime.now(timezone.utc)timezone 固定偏移时区 timezone(timedelta(hours=8))ZoneInfo IANA 时区 ZoneInfo("Asia/Shanghai")转换 时区转换 dt.astimezone(new_tz)
