Pandas pd.to_datetime() 时区信息全解

该文章已生成可运行项目,

pd.to_datetime() 默认生成的时间戳是 不带时区信息 的(即 naive 时间戳),表示的是 本地时间UTC 时间,具体取决于输入数据的上下文。

默认行为

  • 如果你传入的是一个整数(如 Unix 时间戳),pd.to_datetime() 会将其解释为 UTC 时间,但生成的结果仍然是 不带时区信息Timestamp 对象。
  • 如果你传入的是一个字符串(如 "2023-10-01 12:00:00"),pd.to_datetime() 会将其解释为 本地时间,但同样不会附加时区信息。

示例

import pandas as pd

# 整数时间戳(Unix 时间戳,单位为秒)
timestamp_int = 1633072800  # 2021-10-01 12:00:00 UTC

# 转换为 Timestamp 对象
timestamp = pd.to_datetime(timestamp_int, unit='s')
print(timestamp)  # 输出:2021-10-01 12:00:00

在这个例子中,2021-10-01 12:00:00 是 UTC 时间,但 timestamp 对象本身没有时区信息。


如何附加时区信息

如果你需要为时间戳附加时区信息,可以使用 tz_localizetz_convert 方法。

1. 使用 tz_localize 附加时区

tz_localize 可以为不带时区信息的时间戳附加时区。

# 附加时区信息(例如 UTC)
timestamp_utc = timestamp.tz_localize('UTC')
print(timestamp_utc)  # 输出:2021-10-01 12:00:00+00:00
2. 使用 tz_convert 转换时区

tz_convert 可以将带时区信息的时间戳转换为其他时区。

# 转换为其他时区(例如 'Asia/Shanghai')
timestamp_shanghai = timestamp_utc.tz_convert('Asia/Shanghai')
print(timestamp_shanghai)  # 输出:2021-10-01 20:00:00+08:00

直接在 pd.to_datetime 中指定时区

你也可以在调用 pd.to_datetime 时直接指定时区,生成带时区信息的时间戳。

# 直接生成带时区信息的时间戳
timestamp_with_tz = pd.to_datetime(timestamp_int, unit='s', utc=True)
print(timestamp_with_tz)  # 输出:2021-10-01 12:00:00+00:00

总结

  • 默认情况下,pd.to_datetime() 生成的时间戳是 不带时区信息 的。
  • 如果输入是整数时间戳,默认解释为 UTC 时间
  • 如果需要时区信息,可以使用 tz_localize 附加时区,或直接在 pd.to_datetime 中设置 utc=True
  • 如果需要转换时区,可以使用 tz_convert
本文章已经生成可运行项目
在 `pandas` 中使用 `pd.to_datetime` 转换时间戳或字符串为 `datetime` 类型时,**设置时区(timezone)** 是非常常见的需求,尤其是在处理跨时区的数据时。默认情况下,`pd.to_datetime` 生成的是**naive datetime(无时区信息)**,如果你需要指定或转换时区,可以使用 `tz_localize()` 和 `tz_convert()` 方法。 --- ## ✅ 示例 1:将 naive datetime 设置为指定时区(如北京时间) ```python import pandas as pd # 示例字符串时间(naive) df = pd.DataFrame({ 'time_str': ['2024-06-01 12:33:23', '2024-06-02 14:45:00'] }) # 转换为 datetime 设置时区为北京时间 df['time'] = pd.to_datetime(df['time_str']) df['time_with_tz'] = df['time'].dt.tz_localize('Asia/Shanghai') print(df) ``` 📌 输出: ``` time_str time time_with_tz 0 2024-06-01 12:33:23 2024-06-01 12:33:23 2024-06-01 12:33:23+08:00 1 2024-06-02 14:45:00 2024-06-02 14:45:00 2024-06-02 14:45:00+08:00 ``` --- ## ✅ 示例 2:将时间戳转换为带时区datetime(如 UTC 转换为北京时间) ```python # 示例时间戳) df = pd.DataFrame({ 'timestamp': [1717029203, 1717115603] }) # 转换为 UTC 时间 df['utc_time'] = pd.to_datetime(df['timestamp'], unit='s', utc=True) # 转换为北京时间 df['bj_time'] = df['utc_time'].dt.tz_convert('Asia/Shanghai') print(df) ``` 📌 输出: ``` timestamp utc_time bj_time 0 1717029203 2024-06-01 04:33:23+00:00 2024-06-01 12:33:23+08:00 1 1717115603 2024-06-02 04:33:23+00:00 2024-06-02 12:33:23+08:00 ``` --- ## ✅ 示例 3:将 naive datetime 设置为 UTC 时区 ```python df = pd.DataFrame({ 'time_str': ['2024-06-01 12:33:23', '2024-06-02 14:45:00'] }) df['time'] = pd.to_datetime(df['time_str']) df['utc_time'] = df['time'].dt.tz_localize('UTC') print(df) ``` 📌 输出: ``` time_str time utc_time 0 2024-06-01 12:33:23 2024-06-01 12:33:23 2024-06-01 12:33:23+00:00 1 2024-06-02 14:45:00 2024-06-02 14:45:00 2024-06-02 14:45:00+00:00 ``` --- ## ✅ 示例 4:将时间戳直接设置时区(毫级) ```python df = pd.DataFrame({ 'timestamp_ms': [1717029203000, 1717115603000] }) df['time'] = pd.to_datetime(df['timestamp_ms'], unit='ms', utc=True) df['bj_time'] = df['time'].dt.tz_convert('Asia/Shanghai') print(df) ``` --- ## 🔍 小贴士 | 操作 | 方法 | |------|------| | 设置本地时区 | `.dt.tz_localize('Asia/Shanghai')` | | 转换时区 | `.dt.tz_convert('America/New_York')` | | 时间戳设置为 UTC | `pd.to_datetime(..., utc=True)` | | Naive datetime 转带时区 | `.dt.tz_localize()` | | 带时区 datetime 转换为其他时区 | `.dt.tz_convert()` | ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值