Temporal.PlainTime.prototype.hour

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 hour accessor property of Temporal.PlainTime instances returns a integer from 0 to 23 representing the hour component of this time.

The set accessor of hour is undefined. You cannot change this property directly. Use the with() method to create a new Temporal.PlainTime object with the desired new value.

Examples

Using hour

js
const time = Temporal.PlainTime.from("12:34:56");
console.log(time.hour); // 12

Changing hour

js
const time = Temporal.PlainTime.from("12:34:56");
const newTime = time.with({ hour: 15 });
console.log(newTime.toString()); // 15:34:56

You can also use add() or subtract() to move a certain number of hours from the current time.

js
const time = Temporal.PlainTime.from("12:34:56");
const newTime = time.add({ hours: 3 });
console.log(newTime.toString()); // 15:34:56

Specifications

Specification
Temporal proposal
# sec-get-temporal.plaintime.prototype.hour

Browser compatibility

BCD tables only load in the browser

See also