Skip to main content
Deno 2 is finally here 🎉️
Learn more
Go to Latest
function formatDistanceToNow
import { formatDistanceToNow } from "https://deno.land/x/date_fns@v2.0.0-alpha.34/index.js";

Examples

// If today is 1 January 2015, what is the distance to 2 July 2014? var result = formatDistanceToNow( new Date(2014, 6, 2) ) //=> '6 months'

// If now is 1 January 2015 00:00:00, // what is the distance to 1 January 2015 00:00:15, including seconds? var result = formatDistanceToNow( new Date(2015, 0, 1, 0, 0, 15), {includeSeconds: true} ) //=> 'less than 20 seconds'

// If today is 1 January 2015, // what is the distance to 1 January 2016, with a suffix? var result = formatDistanceToNow( new Date(2016, 0, 1), {addSuffix: true} ) //=> 'in about 1 year'

// If today is 1 January 2015, // what is the distance to 1 August 2016 in Esperanto? var eoLocale = require('date-fns/locale/eo') var result = formatDistanceToNow( new Date(2016, 7, 1), {locale: eoLocale} ) //=> 'pli ol 1 jaro'

Parameters

dirtyDate
  • the given date
dirtyOptions