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即可。同樣快。
