dateutil-对datetime的强大扩展

pypi version supported Python version licence

Join the chat at https://gitter.im/dateutil/dateutil Read the documentation at https://dateutil.readthedocs.io/en/latest/

travis build status appveyor build status azure pipelines build status Code coverage

这个 dateutil 模块提供了对标准的强大扩展 datetime 模块,在Python中可用。

安装

dateutil 可以使用从PyPI安装 pip (请注意,包名称与可导入名称不同)::

pip install python-dateutil

下载

dateutil在PyPI上可用https://pypi.org/project/python-dateutil/

文件寄存于:https://dateutil.readthedocs.io/en/stable/

代码

代码和问题跟踪程序托管在GitHub上:https://github.com/dateutil/dateutil/

特征

  • 计算相对增量(下个月、下一年、下周一、每月最后一周等);

  • 计算两个给定日期和/或日期时间对象之间的相对增量;

  • 基于非常灵活的递归规则计算日期,使用 iCalendar 规范。也支持解析RFC字符串。

  • 对几乎任何字符串格式的日期进行通用解析;

  • tzfile(5)格式文件(/etc/localtime,/usr/share/zoneinfo等)、TZ环境字符串(所有已知格式)、iCalendar格式文件、给定范围(在相对增量的帮助下)、本地计算机时区、固定偏移时区、UTC时区和基于Windows注册表的时区的实现。

  • 内部最新的世界时区信息基于奥尔森的数据库。

  • 任何一年的复活节或儒略正统算法;

  • 综合测试套件。

快速实例

下面是一个快照,只是想让您了解一下这个软件包的功能。有关更多文档,请参阅示例。

假设您想知道在下一个复活节之前还有多少时间,以年/月/日/天为单位,在8月13日星期五到来之前,您想从unix系统命令“date”中获取今天的日期。代码如下:

>>> from dateutil.relativedelta import *
>>> from dateutil.easter import *
>>> from dateutil.rrule import *
>>> from dateutil.parser import *
>>> from datetime import *
>>> now = parse("Sat Oct 11 17:13:46 UTC 2003")
>>> today = now.date()
>>> year = rrule(YEARLY,dtstart=now,bymonth=8,bymonthday=13,byweekday=FR)[0].year
>>> rdelta = relativedelta(easter(year), today)
>>> print("Today is: %s" % today)
Today is: 2003-10-11
>>> print("Year with next Aug 13th on a Friday is: %s" % year)
Year with next Aug 13th on a Friday is: 2004
>>> print("How far is the Easter of that year: %s" % rdelta)
How far is the Easter of that year: relativedelta(months=+6)
>>> print("And the Easter of that year is: %s" % (today+rdelta))
And the Easter of that year is: 2004-04-11

整整提前了6个月 真正地 巧合:)

贡献

我们欢迎许多类型的贡献-错误报告,拉请求(代码,基础设施或文档修复)。有关如何为项目作出贡献的更多信息,请参见 CONTRIBUTING.md 存储库中的文件。

作者

dateutil模块是由gustavoniemeyer编写的<gustavo@niemeyer.net>2003年。

由以下人员维护:

所有的版本至少都是由前一个版本的二进制密钥签名的。发布签名密钥表如下所示:

发行版

签名密钥指纹

2.4.1条-

6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB

联系

我们的邮件列表在 dateutil@python.org . 由于它是由PSF托管的,它受 PSF code of conduct .

许可

2017年12月1日后根据双重许可证发放的所有供款 Apache 2.0 LicenseBSD 3-Clause License . 2017年12月1日之前的供款(明确重新授权的除外)仅在BSD 3条款许可下发布。