Temporal.PlainDateTime.prototype.dayOfWeek

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 dayOfWeek accessor property of Temporal.PlainDateTime instances returns a positive integer representing the 1-based day index in the week of this date. Days in a week are numbered sequentially from 1 to daysInWeek, with each number mapping to its name. It is calendar-dependent.

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

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

Examples

Using dayOfWeek

js
const dt = Temporal.PlainDateTime.from("2021-07-01");
console.log(dt.dayOfWeek); // 4; Thursday

Specifications

Specification
Temporal proposal
# sec-get-temporal.plaindatetime.prototype.dayofweek

Browser compatibility

BCD tables only load in the browser

See also