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

Temporal.PlainDate.prototype.toPlainMonthDay()メソッドは、Temporal.PlainDateオブジェクトから、年情報を含まない月と日だけの情報を持つTemporal.PlainMonthDayオブジェクトを生成するメソッドです。

このメソッドは、指定されたTemporal.PlainDateオブジェクトが持つ年、月、日のうち、月と日の情報のみを取り出し、年情報を除去した形で新しいTemporal.PlainMonthDayオブジェクトを作成します。例えば、ある日付が「2023年10月26日」である場合、このメソッドを実行すると「10月26日」という情報を持つTemporal.PlainMonthDayオブジェクトが得られます。この変換により、特定の年に依存しない「月日」という概念を表現することが可能になります。

Temporal.PlainMonthDayオブジェクトは、誕生日や記念日、毎年の祝日、定期的に開催されるイベントなど、年が変わっても繰り返される日付の管理に特に有用です。年を考慮する必要がないため、より柔軟かつ簡潔に日付ロジックを記述できます。元のTemporal.PlainDateオブジェクトは変更されることなく、新しいTemporal.PlainMonthDayオブジェクトが返されるため、データの一貫性を保ちながら安全に操作を進めることができます。この機能は、JavaScriptの新しい日付時刻APIであるTemporalの一部として提供され、より明確で堅牢な日付処理を支援します。

Copy
1const plainDate = new Temporal.PlainDate(2023, 10, 26);
2const plainMonthDay = plainDate.toPlainMonthDay();

options

• options: PlainMonthDay オブジェクトの生成方法を制御するオプションオブジェクト

Temporal.PlainMonthDay

Temporal.PlainDate.prototype.toPlainMonthDay() は、元の Temporal.PlainDate オブジェクトから、年を除いた月と日を表す Temporal.PlainMonthDay オブジェクトを生成して返します。