JavaScript Date getHours() Method

What You’ll Learn

getHours() returns the hour of the day as an integer from 0 to 23 in local time (24-hour clock). This guide covers syntax, five examples, UTC comparisons, validation, and common patterns like greetings and schedulers.

Introduction

Dashboards, chat apps, and login screens often change behavior by time of day. The getHours() method reads the hour component from a Date object using the user’s local timezone.

Combine it with getMinutes() and getSeconds() for precise clocks, or use toLocaleTimeString() when you need a formatted display string.

Understanding the getHours() Method

Date.prototype.getHours() is a zero-argument instance method. It never mutates the original Date—it only reads the hour in 24-hour local time.

Midnight returns 0, noon returns 12, and 11 PM returns 23. If you need a 12-hour clock with AM/PM, convert the value or use locale formatters.

📝 Syntax

dateObj.getHours()

Parameters

• None.

Return value

• Integer 0–23 for a valid date in local time.
• NaN if dateObj is an invalid Date.

Sample values

• 0 — midnight (12:00 AM)
• 9 — 9:00 AM
• 12 — noon
• 15 — 3:00 PM
• 23 — 11:00 PM

Examples Gallery

Open DevTools Console (F12) or use Try-it links. Fixed times use new Date(y, m, d, h, min) for predictable local values.

const now = new Date();
const currentHour = now.getHours();

console.log("Current hour:", currentHour);

Current hour: 7

const afternoon = new Date(2026, 6, 4, 14, 30);

console.log(afternoon.getHours());    // 14
console.log(afternoon.getMinutes());  // 30

14
30

function safeGetHours(date) {
  if (!(date instanceof Date) || Number.isNaN(date.getTime())) {
    return null;
  }
  return date.getHours();
}

console.log(safeGetHours(new Date()));              // e.g. 7
console.log(safeGetHours(new Date("not-a-date")));  // null

7
null

function getGreeting() {
  const hour = new Date().getHours();

  if (hour < 12) {
    return "Good morning!";
  }
  if (hour < 18) {
    return "Good afternoon!";
  }
  return "Good evening!";
}

console.log(getGreeting());

Good morning!

const scheduledHour = 15; // 3:00 PM
const currentHour = new Date().getHours();

if (currentHour === scheduledHour) {
  console.log("Task scheduled for 3:00 PM is running.");
} else {
  console.log("No task at this hour.");
}

No task at this hour.

🚀 Common Use Cases

• Dashboard greetings — morning vs evening welcome text.
• Business hours — show “we’re open” between 9 and 17.
• Dark mode — auto-switch theme after a set hour.
• Hourly jobs — trigger cleanup when getHours() === 0.
• Analytics — bucket events by hour of day.
• Rate limits — reset counters at midnight local time.

📝 Notes

• getHours() is local; use getUTCHours() when you standardize on UTC.
• Returns 24-hour time (0–23), not 12-hour AM/PM.
• Invalid dates propagate NaN—validate first.
• Hour-only checks ignore minutes—combine getters for exact times.
• Daylight saving shifts can produce skipped or repeated local hours.
• For display, prefer toLocaleTimeString() or Intl.DateTimeFormat.

💡 Best Practices