【JavaScript ECMAScript】Temporal::Temporal.ZonedDateTime.prototype.startOfDayインスタンスメソッドの使い方

Temporal.ZonedDateTime.prototype.startOfDay()メソッドは、特定のタイムゾーンにおける日付と時刻情報を持つTemporal.ZonedDateTimeオブジェクトに対し、その日の開始時刻を設定した新しいオブジェクトを生成するメソッドです。このメソッドを呼び出すと、元のZonedDateTimeオブジェクトが保持する日付はそのままに、時刻部分がそのタイムゾーンにおけるその日の午前0時0分0秒（0ミリ秒、0マイクロ秒、0ナノ秒）に設定されます。

このメソッドは、元のTemporal.ZonedDateTimeオブジェクト自体を変更するのではなく、その変更を適用した新しいTemporal.ZonedDateTimeオブジェクトを返します。これにより、予測可能で安全な日付時刻操作が可能となり、プログラムの堅牢性が向上します。タイムゾーンの情報やカレンダーシステムは、元のオブジェクトから新しいオブジェクトに正確に引き継がれます。

システムエンジニアを目指す方にとって、このメソッドは、特定の日付の始まりを基準として処理を行いたい場合に非常に役立ちます。例えば、ある日付の全期間にわたるデータ集計を開始したい場合や、タイムゾーンを考慮したレポート作成で一日の区切りを明確に定義したい場合などに利用されます。Temporal APIは、JavaScriptにおける複雑な日付と時刻の操作をより直感的かつ正確に行うための新しい標準であり、startOfDay()はその日付の境界を正確に扱うための基本的ながらも重要な機能の一つです。

Copy
1const zonedDateTime = Temporal.ZonedDateTime.from('2023-10-27T10:30:00+09:00[Asia/Tokyo]');
2const startOfThatDay = zonedDateTime.startOfDay();

引数なし

引数はありません

Temporal.ZonedDateTime

このメソッドは、元の Temporal.ZonedDateTime オブジェクトと同じ日付、時刻を午前0時0分0秒に設定した新しい Temporal.ZonedDateTime オブジェクトを返します。