Temporal.ZonedDateTime.prototype.weekOfYear

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 weekOfYear accessor property of Temporal.ZonedDateTime instances returns a positive integer representing the 1-based week index in the yearOfWeek of this date, or undefined if the calendar does not have a well-defined week system. The first week of the year is 1. It is calendar-dependent.

The set accessor of weekOfYear is undefined. You cannot change this property directly. To create a new Temporal.ZonedDateTime object with the desired new weekOfYear value, use the add() or subtract() method with the appropriate number of weeks.

For general information and more examples, see Temporal.PlainDate.prototype.weekOfYear.

Examples

Using weekOfYear

js
const dt = Temporal.ZonedDateTime.from("2021-07-01[America/New_York]");
console.log(dt.weekOfYear); // 26

Specifications

Specification
Temporal proposal
# sec-get-temporal.zoneddatetime.prototype.weekofyear

Browser compatibility

BCD tables only load in the browser

See also