なぜ数十年にわたるDateのバグがあなたのせいではなかったのか
数十年にわたり、JavaScript開発者はネイティブのDateオブジェクトと格闘してきました。それはスキルの欠如ではなく、根本的な設計上の欠陥によるものです。その「ミュータビリティ（可変性）」により、Dateを渡すと元の値が密かに変更されてしまい、追跡困難な副作用や予期せぬ動作を引き起こしていました。また、月が0から始まるインデックス（1月は0、12月は11）であることも、直感に反するシステムであり、経験豊富なプログラマーでさえも困惑させる「オフバイワンエラー」を絶えず引き起こしていました。
さらに困難だったのは、Dateがユーザーのローカルシステムタイムゾーンに依存していたことです。これはグローバルなアプリケーションにとって地雷原のようなもので、「午前9時」のイベントが地域をまたぐと予測不能に数時間や数日ずれることがあり、特に「サマータイム（DST）」への切り替え時には顕著でした。このような暗黙の前提により、外部ライブラリの助けなしに異なる場所間で一貫した時間を計算したり、固定された時点を保存したりすることは、ほぼ不可能な作業となっていました。
こうした複雑さに直面し、開発者はMoment.jsやLuxonといった「絆創膏のようなライブラリ」の広大なエコシステムを採用しました。これらのツールは、より堅牢な日付と時刻の操作を提供し、切望されていた救済をもたらしました。しかし、それらはバンドルサイズの増加、複雑な依存関係の管理、抽象化の追加といった独自のオーバーヘッドをもたらしました。これは、ネイティブのDateオブジェクトの不十分さを反映したものであり、開発者の能力不足によるものではありません。
タイムスタンプだけでなく、時間で考える
Temporalは、明確で不変なオブジェクトを概念ごとに分けるという根本的な設計哲学を採用することで、JavaScriptの日付の悩みを解決します。このアプローチにより明確さが強制され、元のDateオブジェクトがすべてを一度に処理しようとした際に発生していた、密かな副作用や混乱を防ぎます。関数が予期せず日付を変更したかどうかを推測する必要はもうありません。
単一の過負荷なオブジェクトの代わりに、Temporalは時間の特定の側面を処理する専門的な型を提供します。この明確な分離により、設計段階でエラーを防ぎ、目的に合った適切なツールを使用できるようになります。
- Temporal.PlainDate: 日付やタイムゾーンを含まないカレンダー上の日付を表します。
- Temporal.PlainTime: 日付とは独立した、時計の時刻を捉えます。
- Temporal.Instant: Unixエポックからのナノ秒単位で計測される、普遍的で曖昧さのない時点を表します。
- Temporal.ZonedDateTime: 特定のタイムゾーンに固定された完全な日付と時刻であり、サマータイムのような複雑な要素を完全に理解しています。
さらに、Temporal.Durationは日付の算術演算に革命をもたらします。エラーが発生しやすい手動のミリ秒計算を、人間が読みやすい操作に置き換え、date.add({ months: 2, days: 10 })のように期間を流動的に加算・減算できるようになります。この精度と可読性により、サマータイムの切り替えをまたぐような複雑な時間計算が、驚くほど単純かつ信頼性の高いものになります。
Temporalがサマータイムを克服する方法
10月24日（土）の午後8時（ニューヨーク時間）にニューヨークを出発し、7時間のフライトでロンドンへ向かう便を想像してください。単純な計算では、ニューヨーク時間で午前3時に到着し、時差5時間を考慮するとロンドン時間で午前8時になると思われます。しかし、その夜、ロンドンの時計はサマータイムのために1時間戻ります。
単純な日付計算では、誤った午前8時という到着時刻が算出されてしまいます。Temporal.ZonedDateTimeはこの重要な詳細を理解しており、自動的に正しい到着時刻である午前7時を算出します。特定の地理的地域における時間を正確にモデル化し、複雑な切り替えに関する推測を排除します。
Temporalは、内部で IANA time zone database を活用することでこの精度を実現しています。オペレーティングシステムやサーバーでも使用されているこの世界的に認められたデータベースは、すべてのタイムゾーンと、その過去および将来のDST（夏時間）変更に関する正確で最新の情報を提供します。これは堅牢なソリューションであり、開発者が複雑なタイムゾーンルールを自ら管理する必要をなくします。Temporalの機能の詳細については、Temporal - JavaScript - MDN Web Docs を参照してください。
Temporalは強力な検査ツールも提供します。開発者は getTimeZoneTransition を使用して、夏時間の変更がいつ発生するかを明示的にクエリでき、ロジックの完全な透明性を確保できます。この機能により、複雑な時間ベースのシナリオのデバッグが大幅に容易になります。
この記事が気に入ったら、毎朝同じようなものをメールで受け取れます。
1日1通 · 2クリックで解除 · サードパーティのトラッキングなし
今日からTemporalを使い始めることができます
Temporalはもはや遠い夢ではなく、開発者がすぐに利用できる安定した完成された機能です。成熟度の最高レベルである TC39 Stage 4 ステータスに到達しており、完成度が高く、ECMAScript標準への組み込み準備が整っていることを示しています。Temporalは ECMAScript 2027 の一部として正式にリリースされる予定であり、その堅牢な設計と幅広い合意が証明されています。つまり、将来を見据えたAPIを採用することになります。
Temporalのネイティブサポートは、主要なブラウザやランタイムですでに広がっています。Chrome、Firefox、Edgeはネイティブで実装しており、シームレスな体験を提供します。Node.jsもTemporalをサポートしていますが、現時点では実験的なフラグが必要です。Safariは完全に統合される最後の主要ブラウザですが、Safari Technology Previewでその機能を今すぐ試すことができます。
すべての環境で完全なネイティブサポートを待つ必要はありません。公式の @js-temporal/polyfill をインストールして、今日から使い始めましょう。このポリフィルにより、コードはすべての環境で一貫して動作し、レガシーな Date オブジェクトの頭痛の種から解放されます。今すぐ明確で不変な時間概念を取り入れ、アプリケーションを将来にわたって活用できるようにしましょう。
よくある質問
JavaScriptのTemporal APIとは何ですか？
Temporalは、レガシーなDateオブジェクトに代わるモダンで堅牢なものとして設計された、新しい組み込みのJavaScript APIです。タイムゾーンを第一級市民としてサポートし、日付と時刻を扱うための包括的なツールセットを提供します。
なぜTemporal APIは古いDateオブジェクトよりも優れているのですか？
Temporalは、いくつかの重要な点でDateオブジェクトを改善しています。オブジェクトは不変（イミュータブル）であるため偶発的なバグを防ぐことができ、概念ごとに個別の型（例：PlainDate、PlainTime）を使用し、タイムゾーンと夏時間を明示的かつ確実にサポートしています。
TemporalはMoment.jsやLuxonのようなライブラリを置き換えるものですか？
多くの一般的なユースケースでは、その通りです。Temporalは、以前はサードパーティライブラリを必要としていた日付と時刻の操作に対して、ネイティブで標準化されたソリューションを提供し、追加の依存関係を不要にしてバンドルサイズを削減します。
Temporal APIはいつすべてのブラウザで利用可能になりますか？
TemporalはES2027標準の一部であり、Chrome、Firefox、Edgeではすでにネイティブでサポートされています。Safariでの完全なネイティブサポートを待つ間、開発者は公式の @js-temporal/polyfill を使用して、今日からすべての環境で使い始めることができます。