JavaScript Date toISOString() Method

What You’ll Learn

toISOString() serializes a Date as a portable UTC ISO 8601 string—the standard format for APIs, databases, and logs. This guide covers syntax, the Z suffix, date-only extraction, comparisons, and error handling.

Introduction

When you store or send dates across systems, you need a format that sorts chronologically and parses reliably. toISOString() converts any valid Date instant into UTC text that pairs naturally with Date.parse() and JSON APIs.

For human-readable local labels without time precision needs, use toDateString(). For locale-aware display, use toLocaleDateString().

Understanding the toISOString() Method

Date.prototype.toISOString() returns a string like 2026-03-15T12:30:45.500Z:

• YYYY-MM-DD — UTC calendar date
• T — separator between date and time
• HH:mm:ss.sss — UTC time with milliseconds
• Z — Zulu time (UTC offset zero)

The same instant always produces the same ISO string worldwide—unlike local formatters that vary by timezone and locale.

📝 Syntax

dateObj.toISOString()

Parameters

• None.

Return value

• A UTC ISO 8601 string for the Date instant.
• Throws RangeError: Invalid time value if the Date is invalid.

Examples Gallery

Open DevTools Console (F12) or use Try-it links. Fixed examples use Date.UTC() for predictable UTC output.

const date = new Date(Date.UTC(2026, 2, 15, 12, 0, 0));
const iso = date.toISOString();

console.log(iso); // "2026-03-15T12:00:00.000Z"

2026-03-15T12:00:00.000Z

const date = new Date(2026, 2, 15, 14, 30, 0);

console.log(date.toISOString());   // UTC instant
console.log(date.toDateString());  // local date only

2026-03-15T09:00:00.000Z
Sun Mar 15 2026

const meeting = new Date(Date.UTC(2026, 5, 20, 15, 0, 0));

const payload = {
  title: "Standup",
  scheduledAt: meeting.toISOString()
};

console.log(JSON.stringify(payload));
// {"title":"Standup","scheduledAt":"2026-06-20T15:00:00.000Z"}

{"title":"Standup","scheduledAt":"2026-06-20T15:00:00.000Z"}

const date = new Date(Date.UTC(2026, 2, 15, 23, 59, 59));
const utcDateOnly = date.toISOString().slice(0, 10);

console.log(utcDateOnly); // "2026-03-15"

2026-03-15

const bad = new Date("not-a-date");

if (Number.isNaN(bad.getTime())) {
  console.log("Cannot format invalid date");
} else {
  console.log(bad.toISOString());
}

Cannot format invalid date

🚀 Common Use Cases

• REST APIs — send scheduledAt fields as ISO strings.
• Database columns — store timestamps in portable text or derive from ISO.
• Structured logs — prefix lines with new Date().toISOString().
• Unit tests — assert expected ISO output after UTC setters.
• CSV / exports — use .slice(0, 10) for UTC date columns.
• Round-trip parsing — pair with Date.parse() for read/write workflows.

📝 Notes

• toISOString() always outputs UTC with a Z suffix.
• Read-only: does not mutate the Date.
• Invalid dates throw RangeError—unlike toDateString() which returns "Invalid Date".
• .slice(0, 10) gives UTC date, not local date.
• Lexicographic sort of ISO strings equals chronological sort.
• JSON.stringify on Date objects uses ISO format via toJSON().

💡 Best Practices