isodatetime

Python ISO 8601 完整规范解析器和数据模型/操作工具。旨在与Python的datetime模块类似使用。

安装

从PyPI安装

$ pip install isodatetime

或自行构建

$ git clone https://github.com/metomi/isodatetime.git isodatetime
$ cd isodatetime
$ python setup.py install

使用方法

Python API

>>> import isodatetime.parsers as parse
>>> import isodatetime.dumpers as dump

# Dates and times
>>> date_time = parse.TimePointParser().parse('2000-01-01T00:00Z')
>>> date_time.month_of_year
1

# Durations
>>> duration = parse.DurationParser().parse('P1YT3H')
>>> duration.get_days_and_seconds()
(365.0, 10800.0)
>>> date_time + duration
2001-01-01T03:00:00Z

# Recurrences
>>> recurrence = parse.TimeRecurrenceParser().parse('R/1999/P1Y')
>>> recurrence.get_next(date_time)
2001-01-01T00:00:00Z

# Output
>>> dump.TimePointDumper().strftime(date_time, '%d/%M/%Y %H:%M:%S')
'01/00/2000 00:00:00'

命令行界面

$ isodatetime
2000-01-01T00:00:00Z
$ isodatetime 1066
1066
$ isodatetime 1066 --offset P1Y
1067
$ isodatetime R/2000/P1Y --max 3
2000-01-01T00:00:00Z
2001-01-01T00:00:00Z
2002-01-01T00:00:00Z

ISO8601

ISO8601 是记录日期/时间信息的国际标准。

这是表示日期/时间信息的正确、国际友好且可电脑排序的数字表示方法。

良好的阅读材料

• http://www.cl.cam.ac.uk/~mgk25/iso-time.html
• http://www.tondering.dk/claus/calendar.html

参考材料

• http://www.iso.org/iso/home/standards/iso8601.htm
• http://en.wikipedia.org/wiki/ISO_8601

日期和时间

我应该如何写下年份、月份和日呢？

关于写下年份、周和星期呢？

关于写下年份和日呢？

我应该如何只写下年份？

可以是：CCYY 或 +XCCYY

+X 表示一个正负符号（+ 或 -），后跟一个固定、约定的扩展年位数（X）。例如，如果我们约定有2个扩展年位数，我们可以表示从公元前999999年到公元999999年（公元前1000000年到公元999999年）。注意，公元前1年是公历格里历中ISO 8601使用的日历中的年份0。

例如，您可以将公元1995年写成：1995 或 +001995（使用2个扩展年位数）。

注意：如果只写下年份表示一个完整的日期，则意味着该年1月1日 - 1995 意味着 1995-01 => 1995-01-01 => 1995-01-01T00 => 1995-01-01T00:00 => 1995-01-01T00:00:00。

我应该如何只写下年份和月份？

可以是：CCYY-MM 或 +XCCYY-MM（这里的+代表一个正负符号+ 或 -）

不允许：CCYYMM 或 +XCCYYMM。

我应该如何写下公元9999年之后的日期和公元0000年之前的日期？

我应该如何单独写下时间信息？

我如何在ISO 8601中写下日期中的时间信息？

在日期后写下时间，用T分隔

关于日期中的小时和分钟呢？

关于日期中的小时呢？

关于小时、分钟或秒的小数部分呢？

使用逗号或点分隔小数部分，并不要包含任何更小的单位

我应该如何指定时区？

如果时区是UTC，使用“Z” - 否则，使用与UTC相差的小时和分钟数的数字表示。

请注意，这个差值是（时区 - UTC） - 因此，0度以东的经度通常有正值，而0度以西通常有负值。

持续时间

如何用X单位写下一定的时间段？

以"P"开头，后面跟单位数量（可选包括小数部分），然后跟表示单位的标识符

如果单位是小时、分钟或秒之一，您需要前面有一个" T"来分隔日期和时间

不允许将任何其他单位与周结合。

一种补充格式（需要在事先达成一致）是指定类似日期时间的持续时间（PCCYY-MM-DDThh:mm:ss），其中给出的年、月、日、小时、分钟和秒的数字按字面意思使用（P1995-00-00T00:10:00 = P1995YT10M）。

重复日期时间序列

1 - 根据起始日期和后续日期之间的差异重复，从起始日期开始

示例语法

2 - 根据给定的时间间隔重复，从上下文日期时间开始

（您必须在其他地方提供上下文）

3 - 从特定日期时间开始重复给定的时间间隔

4 - 从特定日期时间回溯给定的时间间隔