# python-dateutil と ciso8601 のISO日時読み込み実測

依頼 req-20261022-065 / 題材 dateutil-ciso8601-local-hikaku / 測定日 2026-11-20（Asia/Tokyo）。
開始・終了のUTC日時は raw.json の started_utc / ended_utc に記録。

## 実測の可否

このMacのworkspace-write砂場で、両ライブラリをCPUだけで実行できた。
同じISO 8601文字列を読み込み、日時の一致・UTCと時差付きの日時・処理時間の3軸を実測した。
wheel取得だけ公開PyPIを使用し、測定処理はローカルで実行した。外のベンチマーク値を転載していない。
鍵・秘密鍵ファイル・ログイン・有料API・買い物は利用していない。
砂場の権限拡張・GPU・Metal・マイク・スピーカー・say・Bluetoothは使用していない。
公開・X投稿・git commit・デプロイは実行していない。public/measurements/ は保存先。

## 環境とAPI

macOS 27.2.1 arm64 / 論理CPU12 / CPython 3.14.10（GIL有効）。
python-dateutil 2.9.0.post0、ciso8601 2.4.1、six 1.17.0を固定した。
これは固定版同士の比較で、最新版同士の比較や版の推奨ではない。
公開wheelのURL・サイズ・実SHA256・取得UTCはdependencies.jsonに保存した。
pipなしの一時venvに展開し、システムのパッケージを変更せず実行した。

使用APIは `dateutil.parser.isoparse(text)` と `ciso8601.parse_datetime(text)`。
dateutilの汎用 `parse`、ciso8601の時差を捨てる `parse_datetime_as_naive` は使用しない。
どちらもCPU上の文字列処理であり、GPUを初期化する依存ライブラリやコードを読み込んでいない。
実機種名やCPU製品名は取得・推定していない。

## 人工入力と正解

replay.txt のmake_cases()で、6個の日付・時刻を5種類の時差表記にし、計30文字列を生成した。
外部の利用者データは使わない。入力全文と期待値はinputs.jsonとraw.jsonのcases[]にある。

- UTCの `Z` と `+00:00`、正の時差 `+09:00`、負の時差 `-05:30`、時差なし。
- `YYYY-MM-DDTHH:MM:SS` の拡張カレンダー形式。小数秒は無しか6桁。
- うるう日の2024-02-29、年末年始、マイクロ秒1・123456・999999などを含む。
- 時差なしはnaiveのまま扱い、ローカル時刻やUTCだと仮定していない。

期待値は両パーサーから作らず、明示した整数の年月日時分秒・マイクロ秒を
標準ライブラリの `datetime(..., tzinfo=timezone(timedelta(...)))` に渡して構築した。
文字列の生成手順と期待日時の構築手順を分けている。

計時前後のそれぞれで、全30入力・両ツールのdatetime型、年月日時分秒、マイクロ秒、
aware/naive、UTCオフセット秒、標準化したISO文字列を期待値と照合した。
時差付きは `astimezone(timezone.utc)` のUTC換算値も照合した。
両者間の実出力も比較し、全30入力で一致した。計時前後の全出力をraw.jsonに保存した。
`tzinfo` の具象クラスの一致は要求しない。任意のISO 8601入力の互換性を保証する結果ではない。

## 計時方法

各条件6文字列を同じ順で2,000周し、1バッチ12,000回解析する。
両ツールに同じPython strと同じ回数を与える。条件ごとに各ツール1バッチのwarmupを行い、
集計から除外。その後に各ツール9バッチ、5条件で合計90測定バッチを実行した。
条件ごとの開始ツールと試行ごとの実行順序を交互にした。実順序はorder_logに記録した。

`perf_counter_ns()`（mach_absolute_time）で整数nsを取得した。
各バッチ直前に循環GCを回収し、計時中だけ停止し、その後元に戻した。
含むもの: Pythonの二重ループ、API呼び出し、文字列解析、datetime生成、戻り値の参照カウントによる解放。
除くもの: wheel取得・展開、venv構築、import、入力生成、照合、ハッシュ、ファイルI/O。
解析結果を保存するコストは含まない。空ループの差し引きはしていない。

中央値は各バッチの `elapsed_ns / 12000 / 1000` によるμs/解析を9個集計した値。
単発レイテンシーの中央値ではなく、バッチで平均化した1解析当たりの時間の中央値である。

| 条件 | 文字列数 | dateutil 中央値 μs/解析 | ciso8601 中央値 μs/解析 |
|---|---:|---:|---:|
| utc_z | 6 | 2.6193 | 0.0310 |
| utc_offset | 6 | 2.3997 | 0.0312 |
| positive_offset | 6 | 3.8740 | 0.0464 |
| negative_offset | 6 | 3.4282 | 0.0395 |
| naive | 6 | 2.4258 | 0.0310 |

今回の5条件ではciso8601の中央値が小さかった。このMac・版・人工入力・設定での観測に限る。
両側を実際に同条件で計時しており、片側だけの値による速度比較ではない。
整数ns、解析回数、各バッチの1解析当たりμsをraw.jsonのresults[].trials[]に保存した。
中央値は台帳からその配列をmedianで再計算し、rounding=4、tolerance=0.00005で照合する。
各条件の期待値一致件数はidentity、rounding=0、tolerance=0で照合する。

## 測定範囲と限界

外部推論・AIの出力品質は測っていない。合成した有効日時30文字列の一致と処理時間に限った評価。
不正入力の拒否、ISO 8601全形式、日付だけ、週日付、順序日付、短縮表記、24:00、うるう秒、
6桁超の小数秒、地域名付きタイムゾーン、DST、あいまいな時刻、安全性は未評価。
I/O、メモリ、import・起動・導入時間、並列性、別OS・CPU・Python・他版も測っていない。
同一プロセスのwarm状態で、入力は再利用している。一般の日時処理全体の性能を示すものではない。
他プロセス負荷・温度・CPU周波数は固定していない。開始・終了のload averageはenvironmentに記録した。
CPUコアの固定、統計的有意差、複数プロセス・複数マシンでの再現性は未評価。

## 再実行

```sh
python3 measurements/dateutil-ciso8601-local-2026-11-20-req065-a1-replay.txt --output-dir /tmp/dateutil-ciso8601-new-run
```

固定したC拡張wheelのため、GIL版CPython 3.14・macOS arm64を対象とする。
出力先は存在しない新しいディレクトリを指定する。既存出力は拒否する。
公開固定URLからwheelを取得し、サイズとSHA256が一致した場合だけ実行する。
ネットワーク不調は導入失敗として例外終了し、測定成功として保存しない。
venv・wheel・測定ステージは作業コピーの外の `/tmp` 配下に
`tempfile.TemporaryDirectory` で置き、成功・失敗とも終了時に削除する。
入力はそのワーカープロセスのメモリ内で生成し、成功時の証拠としてinputs.jsonにも保存する。
スクリプトは成功結果だけを新規出力先へ書き出し、README・台帳は更新しない。
再測定すれば時間は変動する。入力生成・期待値・測定・依存導入の完全なコードをTXTに保存した。

## 保存物と台帳

raw.json、inputs.json、dependencies.json、run-log.txt、replay.txt、本READMEの計6ファイル。
measurements/とpublic/measurements/へ同じバイトで新規保存した。
台帳はtopics.dateutil-ciso8601-local-hikakuのみを追加し、public側6ファイルの実SHA256を登録する。
記事、topics.json、検査コード・条件、blocked台帳は変更していない。

## 公式資料

2026-11-20確認。APIの確認だけに使い、掲載ベンチマークは実測値に転用していない。

- [dateutil公式リポジトリ](https://github.com/dateutil/dateutil)
- [dateutil公式isoparse API](https://dateutil.readthedocs.io/en/stable/parser.html#dateutil.parser.isoparse)
- [ciso8601公式README](https://github.com/closeio/ciso8601#ciso8601)
