Arrow：Python更好的日期和时间

Arrow是一个Python库，它为创建、操作、格式化和转换日期、时间和时间戳提供了一种明智且人性化的方法。它实现并更新了DateTime类型，填补了功能上的空白，并提供了支持许多常见创建场景的智能模块API。简单地说，它帮助您使用更少的导入和更少的代码来处理日期和时间

Arrow以arrow of time在很大程度上受到了moment.js和requests

为什么要使用Arrow而不是内置模块？

Python的标准库和其他一些低级模块具有近乎完整的日期、时间和时区功能，但从可用性的角度来看，它们工作得不是很好：

• 模块太多：DateTime、Time、Calendar、Dateutil、pytz等等
• 类型太多：Date、Time、DateTime、tzinfo、Time Delta、Relativedelta等
• 时区和时间戳转换既冗长又令人不快
• 时区天真是常态
• 功能差距：ISO 8601解析、时间跨度、人性化

功能

• DateTime的完全实现的插入式替代
• 支持Python 3.6+
• 默认情况下支持时区和UTC
• 针对许多常见输入方案的超简单创建选项
• shift支持相对偏移量(包括周)的方法
• 自动格式化和解析字符串
• 广泛支持ISO 8601标准
• 时区转换
• 支持dateutil，pytz，以及ZoneInfotzinfo对象
• 为从微秒到一年的时间范围生成时间跨度、范围、下限和上限
• 通过不断增加的区域设置列表，使日期和时间人性化
• 可扩展到您自己的Arrow派生类型
• 完全支持PEP 484样式的类型提示

快速入门

安装

要安装Arrow，请使用pip或pipenv：

$ pip install -U arrow

用法示例

>>> import arrow >>> arrow.get('2013-05-11T21:23:58.970460+07:00')
<Arrow [2013-05-11T21:23:58.970460+07:00]> >>> utc = arrow.utcnow()
>>> utc <Arrow [2013-05-11T21:23:58.970460+00:00]> >>> utc = utc.shift(hours=-1)
>>> utc <Arrow [2013-05-11T20:23:58.970460+00:00]> >>> local = utc.to('US/Pacific')
>>> local <Arrow [2013-05-11T13:23:58.970460-07:00]> >>> local.timestamp()
1368303838.970460 >>> local.format()
'2013-05-11 13:23:58 -07:00' >>> local.format('YYYY-MM-DD HH:mm:ss ZZ')
'2013-05-11 13:23:58 -07:00' >>> local.humanize()
'an hour ago' >>> local.humanize(locale='ko-kr')
'한시간 전'

文档

有关完整文档，请访问arrow.readthedocs.io

贡献

代码和本地化(添加和更新区域设置)都欢迎贡献。首先熟悉Arrow库及其功能。然后，开始投身于贡献吧：

1. 在撞击上查找问题或功能issue tracker标记为“good first issue” label可能是一个很好的起点！
2. 叉子this repository在GitHub上，并开始在分支机构中进行更改
3. 添加一些测试以确保错误已修复或功能按预期工作
4. 通过运行以下命令之一运行整个测试套件和linting检查：tox && tox -e lint,docs(如果您有tox已安装)或make build39 && make test && make lint(如果未安装Python 3.9，请替换build39在您的系统上安装最新的Python版本)
5. 提交拉取请求并等待反馈😃

如果你在路上有什么问题，尽管问。here

支撑箭头

Open Collective是一个在线融资平台，提供工具来筹集资金，并在完全透明的情况下分享您的财务。它是个人和公司直接向该项目进行一次性或经常性捐款的首选平台。如果您有兴趣捐款，请浏览Arrow collective