.setUTCHours()

Published Jun 27, 2023
Contribute to Docs

The .setUTCHours() method sets the hour value of a Date object according to Coordinated Universal Time(UTC) and returns the updated Date object.

Syntax

myDate.setUTCHours(hoursValue);

The .setUTCHours() method is called on the myDate object with an input argument hoursValue that passes the new hour value.

Optionally, the method can also set the date’s minute, second, and millisecond UTC values. The valid number ranges for the time units are as follows:

  • Hours (required): 0 to 23
  • Minutes (optional): 0 to 59
  • Seconds (optional): 0 to 59
  • Milliseconds (optional): 0 to 999

Note: The object’s second and millisecond values can only be set when the preceding time unit is defined in the method call. For example, to set a Date object’s millisecond value, the minute and second values must be set as well.

Examples

This example sets the hour value of the eventHour object to 14.

const eventHour = new Date('2023-06-25T00:00:00');
eventHour.setUTCHours(14);
console.log(eventHour);
console.log(eventHour.getUTCHours());

The code above results in the following output:

2023-06-25T14:30:00.000Z
14

Codebyte Example

This code example sets the hour and minute values of eventHour to 14 and 30 respectively. The values are then logged to the console.

us
Visit us
code
Hide code
Code
Output
Hide output
Hide output
Loading...

All contributors

Looking to contribute?

Learn JavaScript on Codecademy