JavaScript Date getSeconds() Method

What You’ll Learn

getSeconds() returns the second component as an integer from 0 to 59 in local time. This guide covers syntax, five examples, UTC comparisons, validation, clock formatting, and common pitfalls with timers.

Introduction

Stopwatch displays, log timestamps, and “run at :30” rules often need the second part of a Date. The getSeconds() method returns that value as an integer using the user’s local timezone.

Pair it with getHours() and getMinutes() to build HH:MM:SS strings, or use toLocaleTimeString() for locale-aware output.

Understanding the getSeconds() Method

Date.prototype.getSeconds() is a zero-argument instance method. It never mutates the original Date—it only reads the second component within the current minute in local time.

On a time like 14:30:45, getSeconds() returns 45. Sub-second precision comes from getMilliseconds().

📝 Syntax

dateObj.getSeconds()

Parameters

• None.

Return value

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

Examples Gallery

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

const now = new Date();
const seconds = now.getSeconds();

console.log("Current seconds:", seconds);

Current seconds: 22

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

console.log(stamp.getMinutes());  // 30
console.log(stamp.getSeconds());  // 45

30
45

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

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

22
null

function formatHms(date) {
  const h = date.getHours();
  const m = String(date.getMinutes()).padStart(2, "0");
  const s = String(date.getSeconds()).padStart(2, "0");
  return h + ":" + m + ":" + s;
}

console.log(formatHms(new Date(2026, 6, 4, 9, 5, 7)));
// "9:05:07"

9:05:07

function minuteHalf() {
  const sec = new Date().getSeconds();

  if (sec < 30) {
    return "First half of the minute.";
  }
  return "Second half of the minute.";
}

console.log(minuteHalf());

First half of the minute.

🚀 Common Use Cases

• Digital clocks — show HH:MM:SS with padded seconds.
• Log timestamps — include seconds in custom time strings.
• Cron-like UI — trigger when getSeconds() === 0.
• Animation frames — sync cues to second boundaries.
• Form defaults — pre-fill second fields on time pickers.
• Testing — assert second fields on constructed dates.

📝 Notes

• getSeconds() is local; use getUTCSeconds() when you standardize on UTC.
• Range is 0–59 only for valid dates.
• Not for elapsed duration—use getTime() or Date.now().
• Invalid dates propagate NaN—validate first.
• Pad with padStart(2, "0") when building fixed-width clocks.
• For sub-second precision, add getMilliseconds() or use performance.now().

💡 Best Practices