pd.Series.dt.weekday与pd.Series.dt.dayofweek是否存在区别？

核心结论 #

二者完全等效，没有任何功能、返回值、计数规则上的区别。

具体依据 #

• Pandas源码层面直接将dayofweek定义为weekday的别名，二者底层调用完全相同的逻辑，返回结果完全一致。
• 官方文档标注「互为别名」就是官方给出的正式说明，不存在你遗漏的隐藏差异点。
• 二者的计数规则完全统一：周一返回0，周二返回1，周日返回6，没有任何规则上的偏差。

自行验证方法 #

你可以通过一段简单的代码直接确认二者的一致性：

import pandas as pd
# 生成覆盖周一到周日的测试时间序列
test_series = pd.Series(pd.date_range(start="2024-06-17", end="2024-06-23"))
# 分别调用两个方法
res1 = test_series.dt.weekday
res2 = test_series.dt.dayofweek
# 验证所有返回值完全相等
print((res1 == res2).all()) # 输出结果为True

补充背景 #

两个方法同时存在只是Pandas为了兼容不同用户的使用习惯做的设计，部分用户更习惯weekday的表述，另一部分用户更熟悉dayofweek的命名，二者从功能层面没有任何区分，日常使用任选其一即可。

内容的提问来源于stack exchange，提问作者GalacticPonderer