ローカル実測/日付処理

python-dateutilとciso8601のISO日時の読み込みを比較

この記事の料金・仕様は時点で各社の公式ページを確認したものです。

時計と文字列が二つの箱を通って日時に変わる、日時の読み込みを表す抽象イラスト

二つの部品に、UTCや時差付きを含む同じ日時文字列を読ませ、読み込んだ日時が合うかと、かかる時間を並べました。速さと、読める書き方の広さのどちらを重く見るかで選び方が変わります。

結論

大量の日時文字列を、とにかく速く読み込みたい人は
ciso8601が向いています。手元の測定記録では、五つの時差の条件すべてで、読み込み時間の中央値がpython-dateutilより短くなりました。
形式がそろっていない日付の文字列も読みたい人は
python-dateutilが向いています。公式ページは、ほとんどどんな形式の日付でも汎用的に読み込めることを特徴に挙げています。
自分のデータの書き方が、読める範囲に入るか心配な人は
ciso8601はISO形式の一部だけに対応します。使う前に、自分のデータの書き方が対応する一覧に入るかを確かめてください。

UTCを示す「Z」付きの日時を読むのに、ciso8601は0.0310μs、python-dateutilは2.6193μsでした。 μs(マイクロ秒)は、100万分の1秒です。

予想と違ったのは、同じUTCでも「Z」と「+00:00」で時間が変わり、どちらの部品でも「+09:00」が最も遅かった点です。

測った30件の読み込み結果は、どちらの部品でも期待した日時と全項目で一致しました。

この記事は、python-dateutilとciso8601に同じISO日時の文字列を読ませた測定記録の読み解きです。 ISO日時は、「2024-02-29T12:30:00+09:00」のように、日付と時刻を決まった順につなぐ書き方です。

読み込んだ日時の一致:30件すべてで、期待した日時と合いました

速さを比べる前に、読み込んだ結果が正しいかを確かめました。 どちらの部品も、30件すべてで期待した日時と全項目が一致しました。

確かめた項目は、日時の型、年月日と時分秒、マイクロ秒、時差の有無、時差の秒数です。 時差付きの日時は、UTCに換算した値も照合しています。

期待値は、両方の部品の出力から作らず、標準ライブラリで組み立てた日時から作りました。 文字列を作る手順と、期待する日時を作る手順も分けています。

条件python-dateutilの一致ciso8601の一致
UTCの「Z」6件6件
UTCの「+00:00」6件6件
正の時差「+09:00」6件6件
負の時差「-05:30」6件6件
時差なし6件6件

入力には、うるう日の2024-02-29、年末年始、マイクロ秒が1・123456・999999の日時を含めています。

時差の情報を持つ日時を aware、持たない日時を naive と呼びます。 時差なしの文字列は、時差を持たない日時のまま扱って照合しました。

出典: ciso8601 公式のGitHubページ(2026年11月20日確認)、測定記録(2026年11月20日)

UTCと時差付きの日時:どの時差でも日時は合い、時間は「+09:00」で最も長くなりました

UTCも時差付きも時差なしも、読み込んだ日時は期待どおりでした。 違いが出たのは、読み込みにかかる時間です。

ciso8601は、時差があれば時差付き(aware)、なければ時差なし(naive)の日時を返すと説明されています。 時差を無視して読むparse_datetime_as_naiveもあり、時差付きの文字列では速くなります。

測定には、時差を残すparse_datetimeを使いました。

時差が「+09:00」の6件は、python-dateutilが3.8740μs、ciso8601が0.0464μsで、5条件のうち最も遅くなりました。

「-05:30」は、python-dateutilが3.4282μs、ciso8601が0.0395μsでした。 「Z」と「+00:00」は、python-dateutilが2.6193μsと2.3997μs、ciso8601が0.0310μsと0.0312μsです。

時差なしは、python-dateutilが2.4258μs、ciso8601が0.0310μsでした。

日本時間の「+09:00」が両方で最も遅かったので、日本のデータを大量に読む処理では、この条件の値で時間を見積もるのが安全だと私は考えます。

出典: ciso8601 公式のGitHubページ(2026年11月20日確認)、測定記録(2026年11月20日)

処理時間:5条件のすべてで、ciso8601が桁違いに短く終わりました

中央値は、5条件のすべてでciso8601のほうが小さくなりました。 差は、小数点の位置が二つ近くずれるほどです。

1回の読み込みあたりの時間を、9回の測定の中央値で出しました。 1回の測定は、6個の日時を2000周し、合計12000回の読み込みをまとめて計ったものです。

条件文字列数python-dateutil(μs)ciso8601(μs)
UTCの「Z」62.61930.0310
UTCの「+00:00」62.39970.0312
正の時差「+09:00」63.87400.0464
負の時差「-05:30」63.42820.0395
時差なし62.42580.0310

python-dateutilは2.3997μsから3.8740μs、ciso8601は0.0310μsから0.0464μsの範囲でした。

計時には、Pythonのループ、関数の呼び出し、日時の生成、結果の解放が入っています。

私は、日時の文字列を何万件も読む処理なら、まずciso8601を試す価値があると考えます。 1回あたりが、2.6193μsと0.0310μsだったからです。

出典: 測定記録と生データ(2026年11月20日)

落とし穴:ciso8601が読める書き方は、ISO日時の一部です

ciso8601が読める書き方は、ISO日時のうちの一部です。 Python標準のfromisoformatが読める範囲よりは広く、RFC形式は全体を読めると説明されています。

時差の区切りに使えるマイナス記号は、通常のハイフンだけです。 マイクロ秒より細かい桁は、切り捨てられます。

今回の表のpython-dateutilは、ISO日時専用のisoparseの値です。 ほとんどどんな形式の日付でも読む汎用の読み込みは、別の関数にあたります。

ciso8601のページにも、どんな使い方にも最良とは限らず、特にPythonの新しい版でその傾向がある、という断りがあります。

自分のデータにこの一覧へ入らない書き方が混ざる時は、速さより先に、読めるかどうかを確かめてください。

出典: ciso8601 公式のGitHubページ・python-dateutil 公式のGitHubページ(ともに2026年11月20日確認)、測定記録(2026年11月20日)

どちらを選ぶか:大量に読むならciso8601、書き方の広さならpython-dateutilです

大量の日時文字列を読むなら、ciso8601です。 読める書き方の広さを重く見るなら、python-dateutilです。

  1. 速さを優先するなら、ciso8601です。「+09:00」の1回あたりは、ciso8601が0.0464μs、python-dateutilが3.8740μsでした。
  2. 形式のそろっていない日付の文字列も読みたいなら、python-dateutilです。汎用的に読めることが特徴に挙げられています。
  3. 30件の測定で一致に差はなかったので、決め手は読める書き方と時間です。

下の図で、二つの部品を一言ずつ見比べてください。

二つの部品の一言まとめ

python-dateutil

Python標準のdatetimeを拡張する部品です。ほとんどどんな形式の日付も汎用的に読める点が特徴です。

ciso8601

Cで書かれた、ISO形式とRFC形式の日時専用の部品です。手元の測定では全条件で時間が短く、読める書き方は一部です。

出典: 各社の公式ページ(2026年11月20日確認)
項目python-dateutilciso8601
紹介の言葉標準のdatetimeを拡張する強力な機能の部品ISO形式とRFC形式の日時を読む、Cで書かれた高速な部品
読める書き方ほとんどどんな形式の日付も汎用的に読めるISO形式の一部とRFC形式の全体
時差の扱い今回の測定ではUTC・正負の時差・時差なしを一致して読めた時差があれば時差付き、なければ時差なしの日時を返す
手元の測定全条件で中央値が長い全条件で中央値が短い

向かない人も書いておきます。 多数の日時を読む処理にpython-dateutilのISO専用の読み込みを選ぶと、今回の表の差がそのまま時間に効きます。 読める書き方が決まっていないデータにciso8601を選ぶと、読めない文字列に当たる場合があります。

次の図は、質問に答えていくと選べる流れです。

python-dateutilとciso8601の選び方

  1. 1. 読みたい日時の文字列は、ISO形式の決まった書き方にそろっていますか?
    はい → 次は質問2です。いいえ → python-dateutilを選びます。ほとんどどんな形式でも汎用的に読めます。
  2. 2. 時差の区切りは通常のハイフンで、細かい桁はマイクロ秒までで足りますか?
    はい → 次は質問3です。いいえ → python-dateutilを選びます。ciso8601は一部の書き方だけに対応します。
  3. 3. 大量の文字列を読むため、読み込み時間を最優先にしますか?
    はい → ciso8601を選びます。手元の測定では全条件で中央値が短くなりました。いいえ → どちらでも足ります。読める書き方が広いpython-dateutilから始めて構いません。
出典: 各社の公式ページ(2026年11月20日確認)

出典: python-dateutil 公式のGitHubページ・ciso8601 公式のGitHubページ(ともに2026年11月20日確認)、測定記録(2026年11月20日)

測定と比較の範囲

測定記録は2026年11月20日(日本時間)に、このMac1台で取ったものです。 macOS 27.2.1、arm64、論理CPU 12、CPython 3.14.10(通常のGIL版)で、CPUだけを使っています。

python-dateutil 2.9.0.post0、ciso8601 2.4.1、six 1.17.0に版を固定しました。 固定した版同士の比較で、最新版同士の比較や、版の推奨ではありません。

入力は人工の30件です。 6個の日時を、「Z」「+00:00」「+09:00」「-05:30」と時差なしの5通りに書き分けました。外部のデータは使っていません。

使った関数は、python-dateutilがisoparse、ciso8601がparse_datetimeです。 python-dateutilの汎用の読み込みと、ciso8601の時差を捨てるparse_datetime_as_naiveは使っていません。

各条件で、1回分の準備運動のあと、9回の測定を2つの部品で順番を入れ替えながら取りました。 循環ごみ集めは計時の間だけ止め、時間は整数のナノ秒で取っています。

計時に入れなかったものは、部品の導入、import、入力の生成、結果の照合、ファイルの読み書きです。

比べていないものを並べます。

  • 不正な入力を断る動き、ISO形式の全体、日付だけの書き方、週や通し日の書き方
  • 短縮した書き方、24時ちょうど、うるう秒、マイクロ秒より細かい小数秒
  • 地域名つきのタイムゾーン、夏時間、あいまいな時刻、安全性
  • メモリ、起動やimportの時間、並列実行、別のOS・CPU・Python・別の版

同じ入力を使い回した、起動後の状態での結果です。 他の処理の負荷、温度、CPUの周波数は固定していません。

9回の中央値で比べたもので、統計的に有意な差かどうかは調べていません。 日時を扱う処理全体の速さを示すものではなく、このMac・この版・この設定・この人工データでの結果に限ります。

出典

公式ページ(すべて2026年11月20日に確認)

自前の測定(2026年11月20日実施)

変更履歴

日付内容
2026-11-20初版公開。同じISO日時の文字列で、日時の一致とUTC・時差付きの読み込み時間を比べた

このサイトで測った元データ

更新履歴

  1. 初版。同じISO日時の文字列を読み込ませ、日時の一致とUTC・時差付きの読み込み時間を掲載した

    一次ソース

関連記事