`pd.date_range()` 在生成日期序列时，其结束点（`stop`）的包含性并非总是直观一致，这主要取决于 `end` 参数的解析方式以及 `freq` 参数所定义的频率锚点（如月末或月初）。本文将深入探讨这一行为背后的机制，特别是针对月度频率（`'m'` vs `'ms'`）的差异，并通过示例代码提供清晰的解释和解决方案，帮助用户精确控制日期范围的生成。

理解 pd.date_range() 的基本用法

pd.date_range() 是 Pandas 中用于生成固定频率日期时间索引（DatetimeIndex）的强大工具。它接受 start、end 和 freq 等参数来定义日期范围。通常情况下，当我们指定一个明确的开始日期和结束日期，并使用像 'D'（天）这样的频率时，其行为是符合直觉的，即包含 start 和 end 所指定的日期。

例如，生成从1999年8月1日到2000年7月1日的每日日期序列：

import pandas as pd

# 每日频率，包含结束日期
daily_range = pd.date_range(start='1999-08-01', end='2000-07-01', freq='D')
print("每日频率范围的起始和结束日期：")
print(daily_range[[0, -1]])
# 输出: DatetimeIndex(['1999-08-01', '2000-07-01'], dtype='datetime64[ns]', freq='D')

在此示例中，2000-07-01 被明确包含在生成的序列中。

月度频率的特殊行为：'M' 与 stop 的非包含性

然而，当使用月度频率（'M'，表示月末）并提供一个模糊的结束日期字符串时，pd.date_range() 的行为可能会出乎意料，导致结束月份不被包含。

考虑以下示例：

# 月末频率，结束月份可能不被包含
monthly_range_M = pd.date_range(start='1999-08', end='2000-07', freq='M')
print("\n月末频率范围的起始和结束日期（'M'）：")
print(monthly_range_M[[0, -1]])
# 输出: DatetimeIndex(['1999-08-31', '2000-06-30'], dtype='datetime64[ns]', freq='M')
print("序列长度：", len(monthly_range_M)) # 长度为11

观察上述输出，尽管我们指定 end='2000-07'，但生成的序列却在 2000-06-30 结束，并未包含2000年7月的任何日期。

原因分析：

PictoGraphic

AI驱动的矢量插图库和插图生成平台

133 查看详情

1. end 参数的解析： 当 end 参数被指定为 'YYYY-MM' 格式时（如 '2000-07'），Pandas 默认将其解析为该月份的第一天，即 2000-07-01。
2. freq='M' 的含义： 'M' 频率表示“月末”。pd.date_range() 在生成日期时，会创建一系列每个月的最后一天。
3. 包含性判断： pd.date_range() 的核心逻辑是生成一系列日期点，直到这些日期点不晚于 end 参数所指定的日期。
   • 对于 start='1999-08'，第一个日期是 1999-08-31。
   • 后续日期依次为 1999-09-30, 1999-10-31, ..., 2000-06-30。
   • 下一个月末日期是 2000-07-31。
   • 由于 2000-07-31 晚于 end 参数解析出的 2000-07-01，因此 2000-07-31 被排除在外。

解决方案：使用 freq='MS' (月初频率)

为了在月度频率下包含指定的结束月份，我们可以利用 freq='MS'（表示月初）这个频率别名。

# 月初频率，包含结束月份
monthly_range_MS = pd.date_range(start='1999-08', end='2000-07', freq='MS')
print("\n月初频率范围的起始和结束日期（'MS'）：")
print(monthly_range_MS[[0, -1]])
# 输出: DatetimeIndex(['1999-08-01', '2000-07-01'], dtype='datetime64[ns]', freq='MS')
print("序列长度：", len(monthly_range_MS)) # 长度为12

通过将频率改为 'MS'，序列的起始日期变为 1999-08-01，而结束日期则成功包含 2000-07-01。这是因为 freq='MS' 生成的是每个月的第一天，而 end='2000-07' 被解析为 2000-07-01。由于 2000-07-01 不晚于 end 参数解析出的 2000-07-01，它被包含在序列中。

与 pd.period_range() 的对比

值得一提的是，pd.period_range() 在处理周期（Period）时，其行为可能更符合直觉。Period 对象代表的是一个时间区间，而不是一个时间点。

# 使用 pd.period_range() 生成月度周期
period_range_M = pd.period_range(start='1999-08', end='2000-07', freq='M')
print("\n使用 pd.period_range() 的月度周期范围：")
print(period_range_M[[0, -1]])
# 输出: PeriodIndex(['1999-08', '2000-07'], dtype='period[M]')
print("序列长度：", len(period_range_M)) # 长度为12

pd.period_range() 在这种情况下会包含 2000-07 整个月份作为一个周期，这与 pd.date_range(freq='MS') 达到了类似的效果，但其底层数据类型和语义不同。

关键注意事项与最佳实践

1. 明确指定日期： 避免使用模糊的日期字符串（如 'YYYY-MM'），尽可能使用完整的 YYYY-MM-DD 格式来明确 start 和 end 的具体日期点，以减少歧义。
2. 理解频率别名： 深入理解 Pandas 时间序列频率别名（'M' 代表月末，'MS' 代表月初，'W' 代表周末，'W-MON' 代表周一等）的精确含义是至关重要的。
3. 测试边界条件： 在实际应用中，尤其是在处理时间序列的开始和结束时，务必通过打印或检查序列的第一个和最后一个元素来验证生成的日期范围是否符合预期。
4. 根据需求选择工具： 如果你的任务是生成一系列时间点，pd.date_range() 是首选；如果你的任务是处理一系列时间区间（如月份、季度），pd.period_range() 可能更合适。

总结

pd.date_range() 在处理日期范围时，其端点包含性并非一成不变，而是与 end 参数的解析和 freq 参数所定义的锚点紧密相关。特别是对于月度频率，'M'（月末）可能导致指定结束月份被排除，而 'MS'（月初）则能有效解决这一问题。通过理解这些细微差别并遵循最佳实践，开发者可以更精确、更可靠地生成所需的日期时间序列。

以上就是Pandas pd.date_range() 日期范围生成：频率与端点行为解析的详细内容，更多请关注其它相关文章！

相关文章： Yandex浏览器官方网页版入口 Yandex浏览器最新版官网  铁路12306官网网页端快速入口 铁路12306官方首页登录教程  谷歌google账号注册详细步骤 谷歌账号注册官方教程  自定义Bag-of-Words实现：处理带负号的词汇权重  抖音小游戏合成大西瓜免费秒玩入口链接 抖音小游戏热门合集秒玩网站  优酷会员付费后没到账怎么办_优酷会员充值异常及解决方法  在Qt QML中通过Python字典动态更新TextEdit内容的教程  响应式CSS Grid布局：优化网格项在小屏幕下的堆叠与宽度适配  响应式图片在网页设计中的正确实现方法  C#使用XPath查询节点时出错？ 常见语法错误与调试技巧  在Blazor WebAssembly应用中动态注入客户端特定指标代码的策略  没有大陆身份证/银行卡如何实名微信？ 亲测有效的几种方法分享  MAC的“快捷指令”怎么同步到iPhone_MAC利用iCloud同步所有设备的自动化指令  解决J*aScript中重复选择项的确认对话框显示问题  漫蛙2(台版)官方入口地址 漫蛙2(台版)正版漫画网页端  LocoySpider如何部署到云服务器_LocoySpider云部署的远程配置  j*a toString()的覆盖  一加手机拍照效果不好怎么办 一加哈苏影像调校与专业模式使用教程【高手篇】  c++如何实现一个简单的ECS框架_c++数据驱动设计与游戏开发  J*a应用程序首次运行自动创建文件与目录的最佳实践  html两个JS只运行一个怎么办_让双JS在html中都运行方法【技巧】  怎样把文件彻底粉碎无法恢复_Windows下安全删除敏感数据【隐私保护】  HuggingFaceEmbeddings中向量嵌入维度调整的限制与理解  JUnit5/Mockito：优雅测试内部依赖与异常处理的实践  腾讯视频怎么举报不良内容_腾讯视频内容举报流程与违规信息处理方法  mcjs网页版在线存档 mcjs云存档登录入口  sublime如何处理大型CSV文件的列对齐_sublime高级表格编辑插件指南  一加 Nord 5 隐私权限异常_一加 Nord 5 系统安全优化  如何修改开机登录密码_Windows账户安全设置超详细教程【必学】  mysql如何分析事务日志_mysql事务日志分析方法  美团外卖商家服务中心入口 美团商家版官网入口  Python异步编程实践：使用Binance API构建实时交易数据流  高德地图总提示网络异常怎么办 高德地图离线导航设置与网络排查方法  ArrayList与LinkedList核心操作的Big-O复杂度分析  qq游戏手机版下载安装_qq游戏移动端入口  163邮箱网页版入口导航平台 163邮箱网页版登录入口官网导航  J*aScript中安全有效地处理localStorage字符串数据  解决Tabulator日期时间排序问题的专业指南  “在文档元素之后找到了标记”是什么错误？ 检查并修复XML中多个根元素的3个方法  在J*a里如何理解依赖关系的方向_依赖方向在模块结构中的作用  Composer的 "check-platform-reqs" 命令有什么用_在部署前检查生产环境是否满足Composer依赖需求  期待已久：小米17 Ultra、小米首款NAS本月登场  AO3中文官网链接_AO3网页版稳定镜像站  树莓派传感器触发：通过Twilio API发送WhatsApp消息教程  Lar*el开发：如何在编辑界面正确预选数据库中的多选标签  解决macOS Tkinter应用双击启动崩溃：PyInstaller打包指南  J*aScript数据结构转换：将对象数组按类别分组  TypeScript/J*aScript：高效查找数组中首个唯一ID对象  TikTok国际版官网直达_TikTok国际版官网直达进入在线观看  整合Supabase认证与Django模型：跨模式迁移的解决方案