JavaScript Date Object and Date Methods

JavaScript's Date object represents a single point in time as a numeric timestamp. You create a date with new Date(), then use getter, setter, formatting, UTC, and timer-related methods depending on what you need to do.

Basic syntax:

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

A Date stores an instant internally. Methods such as getHours() and getDate() read that instant in the user's local time zone; methods beginning with getUTC read the same instant as UTC.

Creating JavaScript Date Objects Top ↑

The most common constructor forms are shown below. Month numbers in the numeric constructor are zero-based: January is 0 and December is 11.

const now = new Date();
const fromTimestamp = new Date(0);
const localDate = new Date(2026, 8, 10, 14, 30);
const isoDate = new Date("2026-09-10T14:30:00+05:30");

For a fuller explanation of constructor forms, timestamps, validation, and date-string parsing, see JavaScript Date object.

Reading Date and Time Values Top ↑

Changing Date and Time Values Top ↑

Date setter methods mutate the existing Date object. JavaScript normalizes values outside their usual range, which can be useful for date arithmetic but can also hide mistakes.

Formatting a JavaScript Date Top ↑

Choose the output method according to whether you need a machine-friendly string, a localised display, only the date, or only the time.

• toString() for a general local date-time string.
• toLocaleString() for locale-aware date and time output.
• toDateString() for the date portion.
• toLocaleDateString() for locale-aware date-only output.
• toTimeString() for the time portion.

UTC and Time Zones Top ↑

Use the UTC Date methods when you need to read or create values in Coordinated Universal Time. For named time zones, Intl.DateTimeFormat or the timeZone option of locale-formatting methods is generally clearer than manually adding offsets.

const now = new Date();
console.log(now.getHours());
console.log(now.getUTCHours());
console.log(now.getTimezoneOffset());

Timers, Countdowns and Clocks Top ↑

• setTimeout() schedules a callback after a delay.
• clearTimeout() cancels a pending timeout.
• Recursive timer repeats work by scheduling the next timeout.
• Countdown timer calculates time remaining to an event.
• JavaScript clock displays changing hours, minutes and seconds.
• Time-zone clock displays times for different zones.
• Time-zone list provides zone names used by the clock examples.
• New Year countdown combines date arithmetic and a timer.

JavaScript Date Projects Top ↑

Date and time projects combine the methods above into practical examples such as date differences, calendar calculations and time-based interfaces.

Important JavaScript Date Pitfalls Top ↑

• Numeric months are zero-based.
• getDate() means day of the month; getDay() means weekday.
• Local getters depend on the host time zone.
• A date-only ISO string such as 2026-09-10 is interpreted differently from a local date-time string without an offset; include an explicit offset when the instant matters.
• Do not parse ambiguous strings such as 10/09/2026 when portability matters.
• Check invalid user input before using the resulting date.

All Date Projects →

Subhendu Mohapatra

Author & Instructor at plus2net

I write and maintain practical tutorials on Python, PHP, SQL, JavaScript, HTML, jQuery, and web development at plus2net. The tutorials focus on clear explanations, working examples, and code that readers can test and adapt while learning.

About the author   Watch on YouTube

Connect: