arrow下载 - arrow源码下载

arrow

Python

Version 1.3.0

下载

Arrow：Python 更好的日期和时间

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

Arrow 以时间之箭命名，深受 moment.js 和 requests 的启发。

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

Python 的标准库和其他一些低级模块具有近乎完整的日期、时间和时区功能，但从可用性角度来看效果不佳：

模块太多：datetime、time、calendar、dateutil、pytz 等
类型太多：日期、时间、datetime、tzinfo、timedelta、relativedelta 等。
时区和时间戳转换冗长且令人不快
时区天真是常态
功能差距：ISO 8601 解析、时间跨度、人性化

特征

完全实现的日期时间直接替代品
支持Python 3.8+
默认时区感知和 UTC
适用于许多常见输入场景的超级简单创建选项
支持相对偏移（包括周）的shift方法
自动格式化和解析字符串
对 ISO 8601 标准的广泛支持
时区转换
支持dateutil 、 pytz和ZoneInfo tzinfo 对象
生成从微秒到年的时间范围的时间跨度、范围、下限和上限
通过不断增加的贡献区域列表使日期和时间人性化
可扩展为您自己的 Arrow 派生类型
完全支持 PEP 484 风格的类型提示

快速入门

安装

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

$ pip install -U arrow

用法示例

 > >> import arrow
> >> arrow . get ( '2013-05-11T21:23:58.970460+07:00' )
< Arrow [ 2013 - 05 - 11 T21 : 23 : 58.970460 + 07 : 00 ] >

> >> utc = arrow . utcnow ()
> >> utc
< Arrow [ 2013 - 05 - 11 T21 : 23 : 58.970460 + 00 : 00 ] >

> >> utc = utc . shift ( hours = - 1 )
> >> utc
< Arrow [ 2013 - 05 - 11 T20 : 23 : 58.970460 + 00 : 00 ] >

> >> local = utc . to ( 'US/Pacific' )
> >> local
< Arrow [ 2013 - 05 - 11 T13 : 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 库及其功能。然后，开始贡献：

在问题跟踪器上查找要解决的问题或功能。标有“第一期好”标签的问题可能是一个很好的起点！
在 GitHub 上分叉此存储库并开始在分支中进行更改。
添加一些测试以确保错误已修复或功能按预期工作。
通过运行以下命令之一来运行整个测试套件并进行 linting 检查： tox && tox -e lint,docs （如果您安装了 tox）或make build39 && make test && make lint （如果您没有安装 Python 3.9，将build39替换为系统上最新的 Python 版本）。
提交拉取请求并等待反馈？。

如果您在此过程中有任何疑问，请随时在这里提问。