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

Temporal.PlainDate.prototype.toPlainYearMonth()メソッドは、Temporal.PlainDateオブジェクトが保持する日付情報から、年と月のみを持つ新しいTemporal.PlainYearMonthオブジェクトを生成するメソッドです。このメソッドは、呼び出し元のPlainDateオブジェクトの年と月の情報を抽出し、日（day）の情報を破棄して、新しいTemporal.PlainYearMonthインスタンスを作成します。

具体的には、例えば「2023年10月26日」を表すPlainDateオブジェクトに対してこのメソッドを呼び出すと、「2023年10月」を表すPlainYearMonthオブジェクトが返されます。このように、特定の日付における年と月だけを抽出し、日情報を切り捨てて扱いたい場合に非常に便利です。

この機能は、月ごとの集計や、特定の日付に関係なく年と月でグルーピングを行いたい場合など、日単位の精度が不要なシナリオで活躍します。例えば、月ごとの売上データを管理する際に、個々の取引日付から月情報を取得し、それを基に集計を行うといった用途が考えられます。

返されるTemporal.PlainYearMonthオブジェクトは、元のTemporal.PlainDateオブジェクトとは独立しており、年と月の情報のみを厳密に表現します。JavaScriptの新しいTemporal APIの一部であり、日付と時刻の操作をより明確かつエラーが少なく行えるように設計されています。このメソッドを使用することで、日付情報の中から必要な年と月の部分だけを安全かつ意図的に取り出すことができます。

Copy
1plainDate.toPlainYearMonth()

options = {}

• options: object: オプションを指定するオブジェクト（省略可能）

Temporal.PlainYearMonth

このメソッドは、Temporal.PlainDateオブジェクトの年と月を表す新しいTemporal.PlainYearMonthオブジェクトを返します。