Skip to main content
Deno 2 is finally here 🎉️
Learn more
Module

std/datetime/mod.ts>difference

Deno standard library
Go to Latest
The Standard Library has been moved to JSR. See the blog post for details.
function difference
import { difference } from "https://deno.land/std@0.195.0/datetime/mod.ts";

Returns the difference of the 2 given dates in the given units. If the units are omitted, it returns the difference in the all available units.

Examples

Example 1

import { difference } from "https://deno.land/std@0.195.0/datetime/difference.ts";

const date0 = new Date("2018-05-14");
const date1 = new Date("2020-05-13");

difference(date0, date1, { units: ["days", "months", "years"] });
// => returns { days: 730, months: 23, years: 1 }

difference(date0, date1);
// => returns {
//   milliseconds: 63072000000,
//   seconds: 63072000,
//   minutes: 1051200,
//   hours: 17520,
//   days: 730,
//   weeks: 104,
//   months: 23,
//   quarters: 7,
//   years: 1
// }

Parameters

from: Date

Year to calculate difference

to: Date

Year to calculate difference with

optional
options: DifferenceOptions

Options for determining how to respond