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

Temporal.ZonedDateTime.prototype.yearプロパティは、Temporal.ZonedDateTimeオブジェクトが保持する日付と時刻の情報の中から、特定のタイムゾーンにおける「年」の値を保持するプロパティです。

Temporal.ZonedDateTimeは、JavaScriptの新しい日時APIであるTemporalのコア機能の一つであり、特定のタイムゾーンとカレンダーシステムにおける正確な日付と時刻を表現するために利用されます。このyearプロパティは、そのTemporal.ZonedDateTimeインスタンスが表す日付の年成分を、数値として取得するために使用されます。

このプロパティにアクセスすると、インスタンスに設定されているタイムゾーンとカレンダーの規則に従って計算された年数が、整数値で返されます。例えば、new Temporal.ZonedDateTime( /* ... */ ).year のように使用することで、該当するオブジェクトの年数にアクセスできます。このプロパティは読み取り専用であり、その値を直接変更することはできません。

Temporal.ZonedDateTime.prototype.yearプロパティは、タイムゾーンを考慮した日時データから年数を正確に抽出したい場合に非常に有用です。国際的なシステムや、地域によって異なる日付ルールを扱うアプリケーションにおいて、特定の日時の年成分を正確に把握し、表示したり計算に利用したりする際に活用されます。

Copy
1const zonedDateTime = Temporal.ZonedDateTime.from('2023-10-27T10:00:00+09:00[Asia/Tokyo]');
2const year = zonedDateTime.year;
3console.log(year);

引数なし

引数はありません

number

このプロパティは、Temporal.ZonedDateTimeオブジェクトが表す日付の年を表す数値を返します。