What's the difference between new Date() and new Date('2025-03-04')?

new Date() with no arguments creates a Date object representing the current moment. Passing a string like '2025-03-04' creates a Date representing that specific date, parsed according to the ISO 8601 format (interpreted as UTC midnight unless a time and timezone offset are also given).

Why is getMonth() zero-indexed but getDate() is not?

This inconsistency comes from JavaScript's Date object being modeled closely on Java's original Date class, which itself borrowed conventions from C's struct tm — months are 0-indexed (0-11) while the day of the month via getDate() is 1-indexed (1-31). It's a well-known historical quirk you just have to remember.

How do I format a date for a specific country or language?

Use toLocaleDateString() (or toLocaleString() for date and time together) and pass a locale string like 'en-US', 'fr-FR', or 'ja-JP' as the first argument, along with an options object controlling which parts to show. This produces a properly localized date string without manually building it yourself.

JS MASTER CLASS /// MASTER THE ENGINE /// BUILD LOGIC /// ASYNC PATTERNS /// JS MASTER CLASS /// MASTER THE ENGINE ///

Date Methods in JavaScript | Web Dev - In-Depth Guide

Learn about Date Methods in this comprehensive JavaScript tutorial for web development. Handle scheduling and date formatting.

⚡ Total XP: 0|💻 javascript XP: 0

Skill Matrix

UNLOCK NODES BY LEARNING NEW TAGS.

System Hub

Core logic.

Quick Quiz //

What is the primary advantage discussed here?

🚀 LEVEL UP TO SENIOR:Unlock 500+ Advanced Practical Challenges & Exercises.

🎓 COURSERA PARTNER:Earn professional Google, Meta, and IBM certificates to supercharge your resume.

The built-in Date object is how JavaScript represents and manipulates points in time. This lesson covers creating a Date with new Date() and reading it back with methods like getFullYear() and toLocaleDateString() for formatted, locale-aware output.

1Date Methods in JavaScript | Web Dev - In-Depth Guide Part 1

The Date object allows you to work with dates and times. You can create a new date using 'new Date()'.

—

const now = new Date();
console.log(now.getFullYear());
console.log(now.toLocaleDateString());

localhost:3000

Date Object

2Step-by-Step Breakdown

The Date object allows you to work with dates and times. You can create a new date using 'new Date()'.

Level Up 🚀

Advanced cheat sheets, SEO tricks, and interview prep for this topic.

Browser Support

ChromeSupported

Fully supported.

FirefoxSupported

Fully supported.

SafariSupported

Fully supported.

EdgeSupported

Fully supported.

Accessibility (A11y)

1Format Dates in a Way Screen Readers Announce Clearly

Raw numeric or ambiguous date formats (like 03/04/25) are read aloud awkwardly and are ambiguous between locales (day-first vs month-first). Use toLocaleDateString() with explicit options, or spell out the month, so assistive technology announces an unambiguous, natural-sounding date.

date.toLocaleDateString('en-US', { year: 'numeric', month: 'long', day: 'numeric' });

SEO Implications

1
Client-Rendered Dates Can Cause Hydration Mismatches That Hurt Core Web Vitals
Rendering `new Date().toLocaleDateString()` differently on the server versus the browser (due to timezone or locale differences) causes a hydration mismatch in frameworks like Next.js, which can trigger a visible content flash or console errors — both of which hurt user experience signals that factor into search ranking.

Best Practices

Store Dates in a Standard Format, Format Them Only for Display

Keep dates as Date objects, timestamps (numbers), or ISO 8601 strings ('2025-03-04T00:00:00Z') internally and in your database. Only convert to a human-readable, locale-specific string right before rendering it to the user with toLocaleDateString() or a formatting library.

Always Specify a Locale and Timezone When Formatting for Users

Calling toLocaleDateString() with no arguments uses the runtime's default locale and timezone, which can differ between your server and your users' browsers. Pass an explicit locale and timeZone option so the same date renders consistently regardless of where the code executes.

Frequent Bugs

THE BUG

Date.getMonth() returns a number that's one less than the actual calendar month.

THE FIX

getMonth() is zero-indexed (0 for January, 11 for December) for historical reasons tied to C's tm_mon structure. Add 1 when displaying the month to a user, e.g. `date.getMonth() + 1`.

Real-World Examples

Displaying a 'Last Updated' Timestamp

A blog post needed to show readers exactly when it was last edited, formatted in a friendly, readable way rather than a raw timestamp.

const lastUpdated = new Date('2025-03-04T14:30:00Z');
const formatted = lastUpdated.toLocaleDateString('en-US', {
  year: 'numeric', month: 'long', day: 'numeric'
});
// 'March 4, 2025'

Interview Prep

?Frequently Asked Questions

Pascual Vila

Frontend Instructor // Code Syllabus

Common Pitfalls & Errors

The Error //

Mutating arrays while iterating over them

// Wrong
items.forEach((item, index) => {
  if (item === 'remove') items.splice(index, 1);
});

// Correct
const newItems = items.filter(item => item !== 'remove');

The Solution //

Modifying an array's length or contents while looping through it (with a for loop or forEach) can cause elements to be skipped. Use methods like filter() or map() instead.

The Error //

Forgetting to await asynchronous functions

// Wrong
const data = fetch('api/data');
console.log(data.json()); // Error

// Correct
const response = await fetch('api/data');
const data = await response.json();

The Solution //

If a function returns a Promise, you must use 'await' (or .then) to get its resolved value. Otherwise, your variable will hold a Promise object instead of the data.