In JavaScript, date and time are represented by the Date object. The Date object provides the date and time information and also provides various methods.

A JavaScript date defines the EcmaScript epoch that represents milliseconds since 1 January 1970 UTC. This date and time is the same as the UNIX epoch (predominant base value for computer-recorded date and time values).

Creating Date Objects

There are four ways to create a date object.

• new Date()
• new Date(milliseconds)
• new Date(Date string)
• new Date(year, month, day, hours, minutes, seconds, milliseconds)

new Date()

You can create a date object using the new Date() constructor. For example,

let timeNow = new Date();
console.log(timeNow); // shows current date and time

Output

Mon Jul 06 2020 12:03:49 GMT+0545 (Nepal Time)

Here, new Date() creates a new date object with the current date and local time.

new Date(milliseconds)

The Date object contains a number that represents milliseconds since 1 January 1970 UTC.

new Date(milliseconds) creates a new date object by adding the milliseconds to the zero time. For example,

let time1 = new Date(0);

// epoch time
console.log(time1); // Thu Jan 01 1970 05:30:00

// 100000000000 milliseconds after the epoch time
let time2 = new Date(100000000000)
console.log(time2); // Sat Mar 03 1973 15:16:40

Note: 1000 milliseconds is equal to 1 second.

new Date(date string)

new Date(date string) creates a new date object from a date string.

In JavaScript, there are generally three date input formats.

ISO Date Formats

You can create a date object by passing ISO date formats. For example,

// ISO Date(International Standard)
let date = new Date("2020-07-01");

// the result date will be according to UTC
console.log(date); // Wed Jul 01 2020 05:45:00 GMT+0545

You can also pass only the year and month or only the year. For example,

let date = new Date("2020-07");
console.log(date); // Wed Jul 01 2020 05:45:00 GMT+0545

let date1 = new Date("2020");
console.log(date1); // Wed Jul 01 2020 05:45:00 GMT+0545

You can also pass specific time to ISO dates.

let date = new Date("2020-07-01T12:00:00Z");
console.log(date); // Wed Jul 01 2020 17:45:00 GMT+0545

Note: Date and time are separated with capital letter T. And UTC time is defined with capital Z.

Short and Long date format

The other two date formats are short date format and long date format.

// short date format "MM/DD/YYYY"
let date = new Date("03/25/2015");
console.log(date); // Wed Mar 25 2015 00:00:00 GMT+0545

// long date format "MMM DD YYYY"
let date1 = new Date("Jul 1 2020");
console.log(date1); // Wed Jul 01 2020 00:00:00 GMT+0545

// month and day can be in any order
let date2 = new Date("1 Jul 2020");
console.log(date2); // Wed Jul 01 2020 00:00:00 GMT+0545

// month can be full or abbreviated. Also month names are insensitive.
// comma are ignored
let date3 = new Date("July 1 2020");
console.log(date3); // Wed Jul 01 2020 00:00:00 GMT+0545

let date4 = new Date("JULY, 1, 2020");
console.log(date4); // Wed Jul 01 2020 00:00:00

new Date(year, month, day, hours, minutes, seconds, milliseconds)

new Date(year, month,...) creates a new date object by passing specific date and time. For example,

let time1 = new Date(2020, 1, 20, 4, 12, 11, 0);
console.log(time1); // Thu Feb 20 2020 04:12:11

The passed argument has a specific order.

If four numbers are passed, it represents year, month, day and hours. For example,

let time1 = new Date(2020, 1, 20, 4);
console.log(time1); // Thu Feb 20 2020 04:00:00

Similarly, if two arguments are passed, it represents year and month. For example,

let time1 = new Date(2020, 1);
console.log(time1); // Sat Feb 01 2020 00:00:00

JavaScript Date Methods

There are various methods available in JavaScript Date object.

Example: Date Methods

let timeInMilliseconds = Date.now();
console.log(timeInMilliseconds); // 1593765214488

let time = new Date;

// get day of the month
let date = time.getDate();
console.log(date); // 30

// get day of the week
let year = time.getFullYear();
console.log(year); // 2020

let utcDate = time.getUTCDate();
console.log(utcDate); // 30

let event = new Date('Feb 19, 2020 23:15:30');
// set the date
event.setDate(15);
console.log(event.getDate()); // 15

// Only 28 days in February!
event.setDate(35);

console.log(event.getDate()); // 7

Formatting a Date

Unlike other programming languages, JavaScript does not provide a built-in function for formatting a date.

However, you can extract individual bits and use it like this.

let currentDate = new Date();
let date = currentDate.getDate();
let month = currentDate.getMonth();
let year = currentDate.getFullYear();

// show in specific format
let monthDateYear = (month+1) + '/' + date + '/' + year;

console.log(monthDateYear); // 7/3/2020

Note: The above program gives inconsistent length as date and month have single-digit and double-digit.

AutoCorrection in Date Object

When you assign out of range values in the Date object, it auto-corrects itself. For example,

let date = new Date(2008, 0, 33);
// Jan does not have 33 days

console.log(date);

Output

Sat Feb 02 2008

Disclaimer: The information and code presented within this recipe/tutorial is only for educational and coaching purposes for beginners and developers. Anyone can practice and apply the recipe/tutorial presented here, but the reader is taking full responsibility for his/her actions. The author (content curator) of this recipe (code / program) has made every effort to ensure the accuracy of the information was correct at time of publication. The author (content curator) does not assume and hereby disclaims any liability to any party for any loss, damage, or disruption caused by errors or omissions, whether such errors or omissions result from accident, negligence, or any other cause. The information presented here could also be found in public knowledge domains.