ciso8601
v2.3.2
ciso8601将ISO 8601或RFC 3339转换为Python DateTime对象。
由于它被写成C模块，因此比其他Python库要快得多。用CPYTHON 2.7、3.4、3.5、3.6、3.7、3.8、3.9、3.10、3.11、3.12、3.13测试。
（有兴趣从事这样的项目吗？关闭是否正在寻找优秀的工程师加入我们的团队）
内容
ciso8601 ？% pip install ciso8601 In [ 1 ]: import ciso8601
In [ 2 ]: ciso8601 . parse_datetime ( '2014-12-05T12:30:45.123456-05:30' )
Out [ 2 ]: datetime . datetime ( 2014 , 12 , 5 , 12 , 30 , 45 , 123456 , tzinfo = pytz . FixedOffset ( 330 ))
In [ 3 ]: ciso8601 . parse_datetime ( '20141205T123045' )
Out [ 3 ]: datetime . datetime ( 2014 , 12 , 5 , 12 , 30 , 45 ) ciso8601的2.0.0版更改了核心实现。这并不是完全兼容的，因此在迁移时应注意迁移指南的Changelog。
ciso8601 ？ ciso8601不一定是每个用例的最佳解决方案（尤其是自Python 3.11以来）。看到我应该使用CISO8601吗？
从v2.0.0开始， ciso8601在解析字符串时提供了强大的保证。
parse_datetime(dt: String): datetime是一个符合字符串的函数，并且要么：
ValueError ，并描述了字符串不符合ISO 8601的支持子集的原因如果提供了时区信息，则将返回一个Aware DateTime对象。否则，返回了幼稚的日期。
在没有时区信息的情况下解析时间戳（例如， 2014-01-09T21:48:00 ）：
| 模块 | Python 3.13 | Python 3.12 | Python 3.11 | Python 3.10 | 相对放缓（与CISO8601，最新python） | … | Python 3.9 | Python 3.8 |
|---|---|---|---|---|---|---|---|---|
| CISO8601 | 64.8 NSEC | 62.8 NSEC | 60.1 NSEC | 91.7 NSEC | N/A。 | … | 86 NSEC | 92.9 NSEC |
| backports.datetime_fromisoformat | N/A。 | N/A。 | N/A。 | 73.6 NSEC | 0.8倍 | … | 70 NSEC | 75.9 NSEC |
| DateTime（内置） | 147 NSEC | 138 NSEC | 123 NSEC | N/A。 | 2.3倍 | … | N/A。 | N/A。 |
| 摆 | 171 NSEC | 181 NSEC | 175 NSEC | 214 NSEC | 2.6倍 | … | 179 NSEC | 180 NSEC |
| UDATETIME | 542 NSEC | 563 NSEC | 525 NSEC | 555 NSEC | 8.4倍 | … | 551 NSEC | 553 NSEC |
| str2date | 3.29 USEC | 3.53 USEC | 3.52 USEC | 3.85 USEC | 50.8x | … | 3.72 USEC | 3.9 USEC |
| ISO8601utils | N/A。 | N/A。 | N/A。 | N/A。 | 56.9倍 | … | 4.89 USEC | 4.89 USEC |
| ISO8601 | 5.1 USEC | 5.4 USEC | 5.18 USEC | 5.38 USEC | 78.8倍 | … | 5.36 USEC | 5.55 USEC |
| iSodate | 5.76 USEC | 5.85 USEC | 5.21 USEC | 5.91 USEC | 89.0x | … | 5.97 USEC | 6.07 USEC |
| PYSO8601 | 10 USEC | 11.5 USEC | 7.99 USEC | 10.9 USEC | 155.0x | … | 9.83 USEC | 9.81 USEC |
| Aniso8601 | 12.1 USEC | 12.5 USEC | 11.1 USEC | 15.1 USEC | 186.9倍 | … | 15.4 USEC | 15.6 USEC |
| 祖鲁 | 12.3 USEC | 13.6 USEC | 12.6 USEC | 14.2 USEC | 189.4倍 | … | 14.5 USEC | 14.2 USEC |
| 玛雅 | 35.9 USEC | N/A。 | 40.6 USEC | 46.7 USEC | 554.3x | … | 45.4 USEC | 46.3 USEC |
| python-dateutil | 36.2 USEC | 36.9 USEC | 36.1 USEC | 44 USEC | 558.5x | … | 46.4 USEC | 45.2 USEC |
| 箭 | 42.9 USEC | 43.8 USEC | 41.2 USEC | 48.8 USEC | 662.7倍 | … | 50.7 USEC | 50.1 USEC |
| metomi-isodateTime | 828 USEC | 822 USEC | 791 USEC | 1.09毫秒 | 12781.0x | … | 1.1毫秒 | 1.11毫秒 |
| 片刻 | 1.28毫秒 | 1.32毫秒 | 1.29毫秒 | 1.36毫秒 | 19696.9倍 | … | 1.37毫秒 | 1.34毫秒 |
CISO8601服用64.8 NSEC，比DateTime（内置）快2.3倍，在此比较中，下一个最快的Python 3.13解析器。
通过时区信息解析时间戳（例如， 2014-01-09T21:48:00-05:30 ）：
| 模块 | Python 3.13 | Python 3.12 | Python 3.11 | Python 3.10 | 相对放缓（与CISO8601，最新python） | … | Python 3.9 | Python 3.8 |
|---|---|---|---|---|---|---|---|---|
| CISO8601 | 73.9 NSEC | 71 NSEC | 65.6 NSEC | 97.5 NSEC | N/A。 | … | 92.9 NSEC | 96.6 NSEC |
| backports.datetime_fromisoformat | N/A。 | N/A。 | N/A。 | 99.2 NSEC | 1.0x | … | 93 NSEC | 99.4 NSEC |
| DateTime（内置） | 205 NSEC | 198 NSEC | 178 NSEC | N/A。 | 2.8倍 | … | N/A。 | N/A。 |
| 摆 | 251 NSEC | 259 NSEC | 251 NSEC | 262 NSEC | 3.4倍 | … | 264 NSEC | 264 NSEC |
| UDATETIME | 684 NSEC | 700 NSEC | 646 NSEC | 684 NSEC | 9.3x | … | 688 NSEC | 676 NSEC |
| str2date | 5.95 USEC | 4.34 USEC | 4.11 USEC | 4.58 USEC | 80.5x | … | 4.6 USEC | 4.82 USEC |
| ISO8601 | 7.68 USEC | 8.56 USEC | 7.62 USEC | 7.99 USEC | 103.9倍 | … | 7.83 USEC | 8.16 USEC |
| iSodate | 7.77 USEC | 8.53 USEC | 7.54 USEC | 7.88 USEC | 105.0x | … | 8.12 USEC | 8.4 USEC |
| ISO8601utils | N/A。 | N/A。 | N/A。 | N/A。 | 152.2x | … | 14.1 USEC | 14.6 USEC |
| 祖鲁 | 17.8 USEC | 16.9 USEC | 15.7 USEC | 17.3 USEC | 241.3x | … | 17.3 USEC | 17.6 USEC |
| Aniso8601 | 18 USEC | 18.7 USEC | 16.4 USEC | 21.5 USEC | 243.1x | … | 22.5 USEC | 22.8 USEC |
| PYSO8601 | 18.3 USEC | 16.6 USEC | 14.3 USEC | 15.8 USEC | 247.5x | … | 16.2 USEC | 16.4 USEC |
| 玛雅 | 46.2 USEC | N/A。 | 41 USEC | 47.5 USEC | 625.0x | … | 45.2 USEC | 47 USEC |
| python-dateutil | 47.1 USEC | 48.2 USEC | 47.1 USEC | 57.3 USEC | 636.5x | … | 60.4 USEC | 58.9 USEC |
| 箭 | 57.7 USEC | 53.8 USEC | 50.8 USEC | 60.2 USEC | 780.2x | … | 59.4 USEC | 60.1 USEC |
| metomi-isodateTime | 876 USEC | 823 USEC | 795 USEC | 1.09毫秒 | 11846.4x | … | 1.09毫秒 | 1.13毫秒 |
| 片刻 | 2070678.8x | … |
CISO8601服用73.9 NSEC，比DateTime（内置）快2.8倍，在此比较中，下一个最快的Python 3.13解析器。
使用以下模块在Linux 6.11.5-orbstack-00280-G96D99C92A42B上测试：
aniso8601 == 9.0 . 1
arrow == 1.3 . 0
backports . datetime_fromisoformat == 2.0 . 2
ciso8601 == 2.3 . 1
iso8601 == 2.1 . 0
iso8601utils == 0.1 . 2
isodate == 0.7 . 2
maya == 0.6 . 1
metomi - isodatetime == 1 ! 3.1 . 0
moment == 0.12 . 1
pendulum == 3.0 . 0
PySO8601 == 0.2 . 0
python - dateutil == 2.9 . 0. post0
str2date == 0.905
udatetime == 0.0 . 17
zulu == 2.0 . 1有关完整的基准测试详细信息（或自己运行基准），请参见基准/readme.rst
ciso8601仅支持ISO 8601的子集，但支持Python本身（ datetime.fromisoformat ）支持的超集，并支持RFC 3339规范的全部。
支持以下日期格式：
| 格式 | 例子 | 支持 |
|---|---|---|
YYYY-MM-DD （扩展） | 2018-04-29 | ✅ |
YYYY-MM （扩展） | 2018-04 | ✅ |
YYYYMMDD （基本） | 20180429 | ✅ |
YYYY-Www-D （周日期） | 2009-W01-1 | ✅ |
YYYY-Www （周期） | 2009-W01 | ✅ |
YYYYWwwD （周日期） | 2009W011 | ✅ |
YYYYWww （周期） | 2009W01 | ✅ |
YYYY-DDD （序数日期） | 1981-095 | ✅ |
YYYYDDD （序数日） | 1981095 | ✅ |
不罕见的ISO 8601日期格式不支持：
| 格式 | 例子 | 支持 |
|---|---|---|
--MM-DD （省略年） | --04-29 | |
--MMDD （省略年） | --0429 | |
±YYYYY-MM （> 4位年份） | +10000-04 | |
+YYYY-MM （领先 +） | +2018-04 | |
-YYYY-MM （负 - ） | -2018-04 |
时间是可选的，并且从日期T分开。
与RFC 3339一致， ciso8601还允许使用空间字符或下案例t代替T 。
支持以下时间格式：
| 格式 | 例子 | 支持 |
|---|---|---|
hh | 11 | ✅ |
hhmm | 1130 | ✅ |
hh:mm | 11:30 | ✅ |
hhmmss | 113059 | ✅ |
hh:mm:ss | 11:30:59 | ✅ |
hhmmss.ssssss | 113059.123456 | ✅ |
hh:mm:ss.ssssss | 11:30:59.123456 | ✅ |
hhmmss,ssssss | 113059,123456 | ✅ |
hh:mm:ss,ssssss | 11:30:59,123456 | ✅ |
| 午夜（特殊情况） | 24:00:00 | ✅ |
hh.hhh （分数小时） | 11.5 | |
hh:mm.mmm （分数分钟） | 11:30.5 |
注意： Python DateTime对象仅具有微秒精度（6位数字）。任何其他精度将被截断。
时区信息可以以以下格式之一提供：
| 格式 | 例子 | 支持 |
|---|---|---|
Z | Z | ✅ |
z | z | ✅ |
±hh | +11 | ✅ |
±hhmm | +1130 | ✅ |
±hh:mm | +11:30 | ✅ |
虽然ISO 8601规范允许在时区分离器中使用负符号（U+2212），但ciso8601仅支持使用连字符Minus（U+002D）字符。
与RFC 3339一致， ciso8601还允许使用低箱z代替Z
ciso8601 PARSES ISO 8601 DATETIMES，可以将其视为RFC 3339的超集（大致）。如果您可能想要严格的RFC 3339解析， ciso8601提供parse_rfc3339方法，其行为与parse_datetime相似：
parse_rfc3339(dt: String): datetime是一个符合字符串的函数，要么：
ValueError ，并描述了字符串不符合RFC 3339的原因。 用时区信息解析时间戳需要更多的时间，尤其是如果它们不在UTC中。但是，有时候您不关心时区信息，而是希望产生幼稚的数据。例如，如果您确定您的程序只能从单个时区解析时间戳，则可能需要剥离时区信息，而只输出幼稚的数据。
在这些有限的情况下，提供了第二个功能。 parse_datetime_as_naive将忽略其找到的任何时区信息，因此，对于包含时区信息的时间戳而言，更快。
In [ 1 ]: import ciso8601
In [ 2 ]: ciso8601 . parse_datetime_as_naive ( '2014-12-05T12:30:45.123456-05:30' )
Out [ 2 ]: datetime . datetime ( 2014 , 12 , 5 , 12 , 30 , 45 , 123456 )注意： parse_datetime_as_naive仅在时间戳具有时区信息的情况下才有用，但是您想忽略它。这有些不寻常。如果您的时间戳没有时区信息（即天真），只需使用parse_datetime即可。同样快。
