JavaScript .setUTCHours()
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
Dateobject’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.000Z14
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.
Contribute to Docs
- Learn more about how to get involved.
- Edit this page on GitHub to fix an error or make an improvement.
- Submit feedback to let us know how we can improve Docs.
Learn JavaScript on Codecademy
- Front-end engineers work closely with designers to make websites beautiful, functional, and fast.
- Includes 34 Courses
- With Professional Certification
- Beginner Friendly.115 hours
- Learn how to use JavaScript — a powerful and flexible programming language for adding website interactivity.
- Beginner Friendly.15 hours