【JavaScript ECMAScript】Temporal::Temporal.PlainDateTimeコンストラクタの使い方

Temporal.PlainDateTime()クラスは、日付と時刻の情報をタイムゾーンやUTCオフセットから完全に独立させて表現するためのクラスです。このクラスは、特定の暦上の日付と時刻、例えば「2024年10月27日の午前9時00分」といった情報を、それが世界のどのタイムゾーンに存在するかにかかわらず、純粋な形として扱います。したがって、夏時間の適用や、特定の地域での時刻のずれ（UTCオフセット）といった複雑な要素を一切含みません。システムエンジニアを目指す方にとって、タイムゾーンに依存しない日付や時刻の計算、または表示が必要な場面で非常に有用です。例えば、ユーザーの場所に関係なく「毎日午前9時に実行される処理」のように、普遍的な時刻を定義したい場合に適しています。コンストラクタを使用すると、年、月、日、時、分、秒などの各要素を指定して、新しいPlainDateTimeオブジェクトを生成できます。これにより、タイムゾーンの考慮なしに、日付や時刻の加算・減算、または異なるPlainDateTimeオブジェクト間の比較といった操作を正確に行うことが可能です。このクラスは、JavaScriptの新しい日付/時刻APIであるTemporal APIの一部であり、従来のDateオブジェクトが抱える問題点を解決し、より堅牢で直感的な日付・時刻処理を実現するために設計されています。

Copy
1new Temporal.PlainDateTime(year, month, day, hour, minute, second);

isoYear, isoMonth, isoDay, isoHour = 0, isoMinute = 0, isoSecond = 0, isoMillisecond = 0, isoMicrosecond = 0, isoNanosecond = 0

• isoYear: Temporal.Year: 年を表す整数
• isoMonth: Temporal.Month: 月を表す整数
• isoDay: Temporal.Day: 日を表す整数
• isoHour: Temporal.Hour = 0: 時を表す整数 (デフォルト値: 0)
• isoMinute: Temporal.Minute = 0: 分を表す整数 (デフォルト値: 0)
• isoSecond: Temporal.Second = 0: 秒を表す整数 (デフォルト値: 0)
• isoMillisecond: Temporal.Millisecond = 0: ミリ秒を表す整数 (デフォルト値: 0)
• isoMicrosecond: Temporal.Microsecond = 0: マイクロ秒を表す整数 (デフォルト値: 0)
• isoNanosecond: Temporal.Nanosecond = 0: ナノ秒を表す整数 (デフォルト値: 0)

戻り値なし

戻り値はありません