Get the Number of Minutes between 2 Dates using JavaScript

Borislav Hadzhiev

Last updated: Jan 17, 2022

Photo from Unsplash

**To get the number of minutes between 2 dates:**

- Get the number of milliseconds between the unix epoch and the Dates.
- Subtract the milliseconds of the start date from the milliseconds of the end date.
- Divide the result by the number of milliseconds in a minute -
`60 * 1000`

.

index.js

`function getMinDiff(startDate, endDate) { const msInMinute = 60 * 1000; return Math.round( Math.abs(endDate - startDate) / msInMinute ); } // 👇️ (45 minutes - 30 minutes = 15 minutes) console.log( getMinDiff( new Date(2022, 1, 24, 9, 30, 0), new Date(2022, 1, 24, 9, 45, 0)), ); // 👇️ (1hr 45mins - 30 mins = 75 mins) console.log( getMinDiff( new Date(2022, 1, 24, 9, 30, 0), new Date(2022, 1, 24, 10, 45, 0)), );`

The parameters we passed to the `Date()`

constructor in the examples are -
`year`

, `month`

(0 = January, 1 = February, etc), `day of the month`

, `hour`

,
`minutes`

and `seconds`

.

We created a reusable function that returns the number of minutes between 2 dates.

The `msInMinute`

variable stores the number of milliseconds there are in a
minute.

When you subtract a Date object from another Date object, they both get implicitly converted to a number that represents the milliseconds elapsed between January 1st, 1970 and the given date.

We could have called the `getTime()`

method on both of the `Date`

objects to
achieve the same result.

index.js

`function getMinDiff(startDate, endDate) { const msInMinute = 60 * 1000; return Math.round( Math.abs(endDate.getTime() - startDate.getTime()) / msInMinute ); } // 👇️ (45 minutes - 30 minutes = 15 minutes) console.log( getMinDiff( new Date(2022, 1, 24, 9, 30, 0), new Date(2022, 1, 24, 9, 45, 0)), ); // 👇️ (1hr 45mins - 30 mins = 75 mins) console.log( getMinDiff( new Date(2022, 1, 24, 9, 30, 0), new Date(2022, 1, 24, 10, 45, 0) ), ); console.log(new Date().getTime()); // 👉️ 1642427316049`

In the example, we called the `getTime()`

method to explicitly convert the
`Date`

object to a timestamp when subtracting.

This might be the more clear and explicit approach for readers of your code.

The next step is to divide the result by the number of milliseconds in a minute to convert the value from milliseconds to minutes.

We used the Math.abs function to handle a scenario where we subtract a greater timestamp from a smaller one.

The `Math.abs`

function returns the absolute value of a number. In other words,
if the number is positive, the number is returned and if the number is negative,
the negation of the number is returned.

index.js

`console.log(Math.abs(-5)); // 👉️ 5 console.log(Math.abs(5)); // 👉️ 5`

We passed the value to the Math.round function to round to the nearest integer.

Here are some examples of how the `Math.round`

function works.

index.js

`console.log(Math.round(5.49)); // 👉️ 5 console.log(Math.round(5.5)); // 👉️ 6`

The function rounds the number up or down to the nearest integer.

If the number is positive and its fractional part is greater than or equal to

`0.5`

, it gets rounded to the next higher absolute value.If the number is positive and its fractional portion is less than `0.5`

, it gets
rounded to the lower absolute value.