How to detect an "invalid date" Date instance in JavaScript

In JavaScript, the Date object is a built-in object used for handling dates and times. However, in certain scenarios, a Date object may be created with invalid parameters, resulting in an invalid date (Invalid Date). To determine if a Date object is valid, we can utilize methods of the Date object itself and some straightforward techniques.

Step 1: Using the isNaN and getTime Methods

The getTime() method of the JavaScript Date object returns the date as a timestamp in milliseconds. If the date is invalid, getTime() returns NaN (Not a Number). Consequently, we can determine if a date is valid by checking the return value of getTime() with the isNaN() function.

Example Code

javascript
function isValidDate(d) {
  return d instanceof Date && !isNaN(d.getTime());
}

// Test code
const date1 = new Date('2021-02-29'); // Invalid date, as February 29 does not exist in 2021
const date2 = new Date('2021-02-28'); // Valid date

console.log(isValidDate(date1)); // Output: false
console.log(isValidDate(date2)); // Output: true

In this example, the isValidDate function first checks if d is an instance of Date, then verifies that d.getTime() is not NaN. This effectively identifies invalid date objects.

Step 2: Directly Inspecting the Invalid Date String

When converting a Date object to a string, an invalid date will produce the string "Invalid Date". Consequently, you can determine if the date is valid by converting the Date object to a string and checking for the presence of "Invalid Date".

Example Code

javascript
function isValidDateV2(d) {
  return d.toString() !== 'Invalid Date';
}

// Test code
const date1 = new Date('2021-02-29');
const date2 = new Date('2021-02-28');

console.log(isValidDateV2(date1)); // Output: false
console.log(isValidDateV2(date2)); // Output: true

This method is intuitive and easy to understand, though it may be slightly cumbersome due to its reliance on specific string representations.

Summary

The combination of getTime() and isNaN() is the most reliable and commonly used approach for detecting invalid dates in JavaScript. This method is both precise and efficient. Additionally, directly inspecting the string representation is a viable alternative, particularly in debugging and logging contexts where it may be more intuitive. In practice, you can select the most appropriate method based on specific requirements and scenarios.