【JavaScript ECMAScript】Temporal::Temporal.Duration.prototype.monthsインスタンスアクセサプロパティの使い方
Temporal.Duration.prototype.monthsインスタンスアクセサプロパティの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Temporal.Duration.prototype.monthsプロパティは、JavaScriptのTemporal APIにおいて、時間の期間を表現するTemporal.Durationインスタンスが保持する「月数」の成分を保持するプロパティです。このプロパティは、特定の期間オブジェクトに設定されている月の量を数値として取得するために使用されます。
Temporal.Durationは、年、月、日、時間、分、秒などの時間の期間を正確に扱うためのオブジェクトであり、このmonthsプロパティは、その期間の構成要素のうち、月数に特化してアクセスすることを可能にします。プロパティにアクセスすると、符号付きの整数値が返されます。この値は、Temporal.Durationオブジェクトが表現する期間における月の数を示し、期間が負の場合は返される値も負の数となります。
例えば、Temporal.Duration.from({ months: 5, days: 10 })という期間オブジェクトのmonthsプロパティを参照すると、5という値が得られます。これは、この期間が純粋に5ヶ月であることを意味します。日付や時間の計算において、期間の月数部分をプログラムで正確に把握し、操作したい場合にこのプロパティは非常に有用です。他の期間コンポーネント（例えば年や日）の値に影響されることなく、独立して月数のみを取得できるため、複雑な時間計算のロジックを簡潔に記述するのに役立ちます。
構文(syntax)
1const duration = new Temporal.Duration(0, 3, 0, 0, 0, 0, 0, 0, 0, 0); 2const months = duration.months;
引数(parameters)
引数なし
引数はありません
戻り値(return)
number
このプロパティは、Temporal.Durationオブジェクトが表す期間の月数を数値で返します。