【JavaScript ECMAScript】Temporal::Temporal.ZonedDateTime.prototype.minuteインスタンスアクセサプロパティの使い方

Temporal.ZonedDateTime.prototype.minuteプロパティは、JavaScriptのTemporal APIにおいて、Temporal.ZonedDateTimeオブジェクトが保持する日時情報のうち、「分」の値を保持するプロパティです。このプロパティは、特定のタイムゾーンにおける特定の時点の「分」を表します。Temporal.ZonedDateTimeインスタンスは、タイムゾーン情報とオフセットを考慮した特定の瞬間を表すため、minuteプロパティが返す値も、そのタイムゾーンの規則に基づいて正確に計算された分となります。この値は0から59までの整数範囲です。

このプロパティは読み取り専用のアクセサープロパティであり、Temporal.ZonedDateTimeオブジェクトが一度生成されるとその値は不変です。そのため、オブジェクトの生成後にminuteプロパティの値を直接変更することはできません。minuteプロパティを利用することで、システムはタイムゾーンに依存する複雑な日時計算を行う際に、対象の「分」を容易に抽出することが可能です。例えば、イベントの発生時刻の分を確認したり、特定の時間の範囲内で処理を分岐させたりする際の条件として使用できます。これは、従来の日付オブジェクトが抱えていた多くの課題を解決し、より堅牢で正確な日時処理を可能にするTemporal APIの重要な構成要素の一つです。正確な日時処理はシステム開発において不可欠な要素であり、このプロパティはその理解と利用の基礎となります。

Copy
1// Temporal.ZonedDateTime オブジェクトのインスタンスを仮定します
2// 例: const zonedDateTime = Temporal.ZonedDateTime.from('2023-10-27T10:35:00+09:00[Asia/Tokyo]');
3
4const zonedDateTimeInstance = {
5  // これは構文を示すための仮のオブジェクトです。
6  // 実際のTemporal.ZonedDateTimeインスタンスでは、minuteプロパティは自動的に提供されます。
7  minute: 35
8};
9
10const minuteValue = zonedDateTimeInstance.minute;
11console.log(minuteValue); // 出力例: 35

引数なし

引数はありません

number

このアクセサープロパティは、Temporal.ZonedDateTimeオブジェクトが表す日時の「分」を表す数値を返します。