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

Temporal.PlainDate()メソッドは、日付のみを表す新しいTemporal.PlainDateオブジェクトを生成するコンストラクタメソッドです。このメソッドは、年、月、日という3つの情報に基づいて日付オブジェクトを作成します。時刻やタイムゾーン、夏時間といった時間に関する要素は一切含まれず、純粋にカレンダー上の日付を表現することに特化しています。

このTemporal.PlainDate()メソッドを使用することで、タイムゾーンの概念に左右されずに、特定の誕生日やイベント開催日など、日付そのものの意味を持つ情報を正確かつ堅牢に管理できます。システム内で日付に関するロジックを実装する際に、意図しない時間帯の影響を排除し、一貫した日付処理を実現するために非常に有用です。

新しいTemporal.PlainDateオブジェクトを作成するには、通常、newキーワードとともにこのメソッドを呼び出します。例えば、new Temporal.PlainDate(2023, 10, 26)のように記述することで、2023年10月26日を表すTemporal.PlainDateインスタンスが生成されます。引数として不正な日付（例えば存在しない月日）が与えられた場合にはエラーを発生させ、データの整合性を保つ設計になっています。

生成されたTemporal.PlainDateオブジェクトは、日付の加算、減算、比較など、日付を操作するための様々なメソッドを提供しており、日付間の期間計算や順序付けといった処理を容易に行うことができます。

Copy
1new Temporal.PlainDate(year, month, day);

year, month, day, calendar = 'iso8601'

• year: number: 年を表す整数
• month: number: 月を表す整数
• day: number: 日を表す整数
• calendar: string = 'iso8601': 使用するカレンダーシステムを指定する文字列。デフォルトは 'iso8601'

戻り値なし

戻り値はありません