【JavaScript ECMAScript】Temporal::Temporal.PlainYearMonth.prototype.toPlainDateインスタンスメソッドの使い方
Temporal.PlainYearMonth.prototype.toPlainDate()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Temporal.PlainYearMonth.prototype.toPlainDate()メソッドは、JavaScriptの新しい日付/時刻APIであるTemporalの一部であり、年と月の情報のみを持つPlainYearMonthオブジェクトを、年・月・日の情報を持つPlainDateオブジェクトに変換するメソッドです。
このメソッドは、既存のPlainYearMonthインスタンスが持つ年と月の情報に、特定の日を組み合わせて、新しいPlainDateオブジェクトを生成します。元のPlainYearMonthオブジェクト自体は変更されず、常に新しいPlainDateオブジェクトが返されるため、データの不変性が保たれ、意図しない変更を防ぎます。
システム開発において、例えばユーザーが選択した年月から特定の日付オブジェクトを生成したい場合や、月次で集計するデータの日付基準を月初や月末などに設定したい場合など、年月情報に日を追加して正確な日付として扱いたい状況でこのメソッドは非常に有用です。これにより、日付の曖昧さをなくし、堅牢で予測可能な日付処理を実装することが可能になります。
構文(syntax)
1const plainYearMonth = Temporal.PlainYearMonth.from('2023-10'); 2const plainDate = plainYearMonth.toPlainDate({ day: 26 });
引数(parameters)
day
- day: number: 平日（日付）を指定する数値
戻り値(return)
Temporal.PlainDate
このメソッドは、呼び出した PlainYearMonth オブジェクトの年と月を元に、指定された日（デフォルトは1日）を持つ新しい PlainDate オブジェクトを生成して返します。