Temporal.ZonedDateTime.prototype.year
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The year accessor property of Temporal.ZonedDateTime instances returns an integer representing the number of years of this date relative to the start of a calendar-specific epoch year. It is calendar-dependent.
The set accessor of year is undefined. You cannot change this property directly. Use the with() method to create a new Temporal.ZonedDateTime object with the desired new value.
For general information and more examples, see Temporal.PlainDate.prototype.year.
Examples
Using year
js
const dt = Temporal.ZonedDateTime.from("2021-07-01[America/New_York]"); // ISO 8601 calendar
console.log(dt.year); // 2021
Specifications
| Specification |
|---|
| Temporal proposal # sec-get-temporal.zoneddatetime.prototype.year |
Browser compatibility
BCD tables only load in the browser
See also
Temporal.ZonedDateTimeTemporal.ZonedDateTime.prototype.with()Temporal.ZonedDateTime.prototype.add()Temporal.ZonedDateTime.prototype.subtract()Temporal.ZonedDateTime.prototype.eraTemporal.ZonedDateTime.prototype.eraYearTemporal.ZonedDateTime.prototype.yearOfWeekTemporal.ZonedDateTime.prototype.monthTemporal.ZonedDateTime.prototype.dayTemporal.PlainDate.prototype.year