Pandas中pd.to_datetime
的用法及示例
pd.to_datetime
是 Pandas 库中用于将字符串、整数或列表转换为日期时间(datetime
)对象的核心函数。它在处理时间序列数据时至关重要,能够灵活解析多种日期格式并统一为标准时间类型。以下是其核心用法及示例:
1. 基本用法
将字符串或列表直接转换为日期时间格式:
Python复制
import pandas as pd
# 示例 1:单个日期字符串转换
date_str = "2024-03-08"
date = pd.to_datetime(date_str)
print(date) # 输出:2024-03-08 00:00:00
# 示例 2:列表转换
dates_list = ["2024-01-01", "2024-02-01", "2024-03-01"]
dates = pd.to_datetime(dates_list)
print(dates)
# 输出:
# DatetimeIndex(['2024-01-01', '2024-02-01', '2024-03-01'], dtype='datetime64[ns]', freq=None)
引用:[[5]][[9]]
2. 处理多格式日期字符串
支持多种日期格式(如 YYYY-MM-DD
、MM/DD/YYYY
、Jan 01, 2024
等)的自动解析:
Python复制
dates = ["2024-03-08", "03/08/2024", "Mar 08, 2024", "2024.03.08"]
converted = pd.to_datetime(dates)
print(converted)
# 输出:
# DatetimeIndex(['2024-03-08', '2024-03-08', '2024-03-08', '2024-03-08'], dtype='datetime64[ns]', freq=None)
引用:[[2]][[8]]
3. 自定义日期格式
通过 format
参数显式指定日期格式(提升解析效率):
Python复制
date_str = "08-03-2024" # 格式为 DD-MM-YYYY
date = pd.to_datetime(date_str, format="%d-%m-%Y")
print(date) # 输出:2024-03-08 00:00:00
引用:[[3]][[5]]
4. 处理无效日期
通过 errors
参数控制无法解析值的处理方式:
-
errors='raise'
:报错(默认)。 -
errors='coerce'
:转换为NaT
(Not a Time)。 -
errors='ignore'
:保留原始值。
Python复制
invalid_dates = ["2024-02-30", "2024-13-01", "invalid"]
# 强制转换为 NaT
converted = pd.to_datetime(invalid_dates, errors='coerce')
print(converted)
# 输出:[NaT NaT NaT]
引用:[[4]][[9]]
5. 从 DataFrame 列转换
将数据框中的字符串列转换为日期时间类型:
Python复制
import pandas as pd
data = {
"日期": ["2024-01-01", "2024-02-01", "2024-03-01"],
"销售额": [100, 200, 300]
}
df = pd.DataFrame(data)
# 转换为 datetime 类型
df["日期"] = pd.to_datetime(df["日期"])
print(df.dtypes)
# 输出:
# 日期 datetime64[ns]
# 销售额 int64
# dtype: object
引用:[[8]][[10]]
6. 提取时间属性
转换后可通过 .dt
访问器提取年、月、日等属性:
Python复制
df["年份"] = df["日期"].dt.year
df["月份"] = df["日期"].dt.month
df["日"] = df["日期"].dt.day
print(df)
# 输出:
# 日期 销售额 年份 月份 日
# 0 2024-01-01 100 2024 1 1
# 1 2024-02-01 200 2024 2 1
# 2 2024-03-01 300 2024 3 1
引用:[[5]][[9]]
7. 应用场景
-
数据清洗:统一日期格式,处理缺失或异常值。
-
时间序列分析:按年/月/日聚合数据。
-
特征工程:提取时间特征(如季度、星期几)用于机器学习。
8. 注意事项
-
性能优化:处理大规模数据时,显式指定
format
参数可加速解析 [[3]]。 -
时区处理:通过
utc=True
转换为 UTC 时间,或使用tz_localize
设置时区 [[8]]。 -
兼容性:支持 NumPy 的
datetime64
类型,可与其他时间序列工具(如 Matplotlib)无缝衔接 [[10]]。
通过 pd.to_datetime
,Pandas 提供了高效且灵活的日期时间处理能力,是数据分析中不可或缺的工具。