JavaScript Date setHours() Method

What You’ll Learn

setHours() writes the hour (0–23) on a Date object in local time, with optional minutes, seconds, and milliseconds. This guide covers syntax, scheduling patterns, overflow, and comparisons with UTC setters.

Introduction

Reminders, meeting times, and “open at 9 AM” rules need to change the clock on a Date. After reading the hour with getHours(), setHours() writes it back in local time.

Like other setters, it mutates the original object and returns epoch milliseconds—not the Date for chaining.

Understanding the setHours() Method

Date.prototype.setHours(hour [, minute [, second [, millisecond]]]) accepts a 24-hour local hour and up to three optional time fields. When you pass only the hour, minutes, seconds, and milliseconds stay the same unless overflow normalization shifts the calendar day.

Values outside normal ranges roll forward or backward— setHours(25) becomes 1:xx on the next day. For UTC hour writes, use setUTCHours().

📝 Syntax

dateObj.setHours(hour)
dateObj.setHours(hour, minute)
dateObj.setHours(hour, minute, second)
dateObj.setHours(hour, minute, second, millisecond)

Parameters

• hour — Integer 0–23 in local 24-hour time (overflow normalizes).
• minute (optional) — 0–59.
• second (optional) — 0–59.
• millisecond (optional) — 0–999.

Return value

• Updated epoch milliseconds after the change.
• NaN if the Date was invalid before the call.

Examples Gallery

Open DevTools Console (F12) or use Try-it links. Examples use the Date constructor for predictable local times.

const date = new Date(2026, 2, 1, 12, 30, 45);
date.setHours(8);

console.log(date.getHours());    // 8
console.log(date.getMinutes());  // 30
console.log(date.getSeconds());  // 45

8
30
45

const meeting = new Date(2026, 2, 1, 9, 45, 30, 500);
meeting.setHours(15, 0, 0, 0);

console.log(meeting.getHours());         // 15
console.log(meeting.getMinutes());       // 0
console.log(meeting.getSeconds());       // 0
console.log(meeting.getMilliseconds());  // 0

15
0
0
0

const date = new Date(2026, 2, 1, 22, 30, 0);
date.setHours(date.getHours() + 2);

console.log(date.getHours());  // 0 (next day)
console.log(date.getDate());   // 2

0
2

const date = new Date(2026, 2, 1, 12, 30, 45);
const ms = date.setHours(8);

console.log("Type:", typeof ms);                    // "number"
console.log("Matches getTime():", ms === date.getTime()); // true

Type: number
Matches getTime(): true

const date = new Date(2026, 2, 1, 12, 30, 45);
date.setHours(25);

console.log(date.getHours());  // 1
console.log(date.getDate());   // 2

1
2

🚀 Common Use Cases

• Meeting reminders — snap events to setHours(15, 0, 0, 0).
• Business hours — open at 9, close at 17 in local time.
• Relative shifts — postpone by N hours with getHours() + N.
• Form time pickers — apply user-selected hour to a Date.
• Day boundaries — set midnight with setHours(0, 0, 0, 0).
• Clone + mutate — copy a Date before changing hours for comparisons.

📝 Notes

• setHours() uses 24-hour local time (0 = midnight, 12 = noon).
• Mutates the original Date—clone with new Date(date) when needed.
• Returns epoch ms, not the Date—no fluent chaining on the return value.
• Overflow normalizes (e.g. hour 25 → next day hour 1).
• For real timezone conversion, use Intl or libraries—not naive getHours() + offset on UTC strings.
• Use setUTCHours when rules follow UTC, not local wall clock.

💡 Best Practices