HN 日本語サマリー

← 一覧へ戻る
プログラミング

0年の2月のグリッチ

A glitch in February of the year 0 (28times.com)

6 pointsby lukasgelbmann0 コメント

要約

28times社が過去のタイムスタンプに対応する際、0000年2月の特定の日付でタイムスタンプが誤って処理されるバグを発見しました。調査の結果、PHPのDateTimeImmutableクラスでUnixタイムスタンプをDateTimeImmutableオブジェクトに変換する際、特定の記述方法において1日分のずれが生じることが判明。この問題はPHPの内部ライブラリtimelibに起因しており、筆者は修正を提案し、現在はワークアラウンドで対応しています。

全文翻訳

西暦0年の2月に発生したグリッチ

[画像: 28times icon][画像: 28times logo](https://28times.com/)

Blog > Post

私たちが発見し修正した、稀な正しさの問題に関する技術レポート。

最近、遠い過去のタイムスタンプのサポートを追加していたところ、チームメンバーがテスト中に一部のタイムスタンプが正しく処理されていないことに気づきました。この問題は、タイムスタンプ 0000-02-03 04:00 Europe/Oslo で簡単に再現できました。

最初の調査では、この問題はすべてのタイムゾーンに影響を与えましたが、西暦0年の2月(および1月最後の数日間)のみであることがわかりました。

ほとんどの時系列データには、2千年紀も前のタイムスタンプはありません。しかし、もちろん、私たちはサポートされている範囲内のすべてのタイムスタンプを、たとえ古代に遡る稀なケースであっても、正しく解析したいと考えています。

バグハンティングの時間

私たちはバグを探し始めました。当然、それは自分たちのコードにあるだろうと仮定しました。私たちはPHPランタイム(DateTimeImmutableクラス)が提供するカレンダーロジックを使用していますが、それでもタイムスタンプに関するいくつかの複雑な処理を行っています。タイムゾーンの遷移によって曖昧になるタイムスタンプを処理するために、内部的にUnixタイムスタンプを計算し、それをPHPのDateTimeImmutableに変換しています。

西暦0年は、2つの点で少し外れ値です。第一に、歴史家が使用する伝統的なユリウス暦には存在しません(彼らは代わりに1 BCと呼ぶでしょう)。第二に、天文年数法(28timesで使用しているカレンダー)によるプロレプティック・グレゴリオ暦では、世紀の閏年です。世紀の閏年とは、例外の中の例外です。100で割り切れる年は閏年ではありませんが、西暦0年のように400で割り切れる場合は例外となります。

これにより、西暦0年がなぜバグの影響を受ける可能性があるのか、漠然とした考えを得ました。しかし、他の世紀の閏年(例えば2000年)は影響を受けていなかったため、これだけでは完全な説明にはなりませんでした。

そこで、コードをステップバイステップで確認し、問題を発見しました。驚いたことに、それは私たちのコードにはありませんでした。問題は、UnixタイムスタンプをDateTimeImmutableオブジェクトに変換するために使用したイディオムに関連していました。

原因

以下は、PHPでUnixタイムスタンプをDateTimeImmutableに変換する3つの方法です。

  1. \DateTimeImmutable::createFromFormat('U', '-62164356180')
  2. (new \DateTimeImmutable('@0'))->setTimestamp(-62164356180)
  3. new \DateTimeImmutable('@-62164356180') **// 不正な戻り値**

これら3つは完全に等価であるはずです。そして、ほとんどのタイムスタンプではそうなっています。しかし、最初の2つとは異なり、最後のバリアントは西暦0年の2月において1日ずれた結果を返します。執筆時点では、これは最近のPHPリリースすべてで発生しています。運が悪いことに、最後のメソッドは私たちのコードで使用していたものでした。

(これらの3つのスニペットでDateTimeをDateTimeImmutableに置き換えることもできます。DateTimeも最後のバリアントで同じ問題を抱えています。)

問題の修正

私たち自身の目的のためには、修正は単に最初の2つの方法のいずれかを使用することでした。これは、DateTimeまたはDateTimeImmutableを使用している他のPHPプログラマーにも推奨するものです。

また、PHPのDateTimeImmutableが内部的に使用している日付/時刻機能を提供するライブラリtimelibのバグを修正するために、プルリクエストを開きました。

この問題は、timelibがUnixタイムスタンプからプロレプティック・グレゴリオ暦の日付への変換に2つの実装を持っていることに起因していました。そのうちの1つには範囲チェックがあり、その日付が間違っています。それは、世紀の閏日の約1ヶ月前、つまりその後の日付ではなく、西暦0年の1月の日付になってしまいます。これにより、世紀の閏日より前のすべての結果が1日ずれてしまいます。私は、すべての呼び出し元が正しいアルゴリズムを使用するようにすることで、これを修正することを提案しました。

この問題は、今後のtimelibおよびPHPのリリースで修正されることが期待されます。確かに、満足のいくバグ修正となりました。私たちはクリーンな回避策を持ち、timelibとPHPを改善することは良いボーナスです。