Relative timestamps with Intl

Posted on

JavaScript has a built-in formatter for relative timestamps. It returns strings like “yesterday” or “2 months from now” in the language we specify.

All major browser support this now, although some only started doing so recently. Some only added support recently. You might have to provide a fallback for earlier versions.

// a positive value describes a time in the future
new Intl.RelativeTimeFormat("en").format(2, "day")
// ⇒ "in 2 days"
 
// a negative value describes a time in the past
new Intl.RelativeTimeFormat("en").format(-1, "day")
// ⇒ "1 day ago"
 
// `numeric: "auto"` results in strings like “yesterday” and “tomorrow”
new Intl.RelativeTimeFormat("en", { numeric: "auto" }).format(-1, "day")
// ⇒ "yesterday"
 
// the formatter can base its output on different languages
new Intl.RelativeTimeFormat("de").format(3, "month")
// ⇒ "in 3 Monaten"
// a positive value describes a time in the future
new Intl.RelativeTimeFormat("en").format(2, "day")
// ⇒ "in 2 days"
 
// a negative value describes a time in the past
new Intl.RelativeTimeFormat("en").format(-1, "day")
// ⇒ "1 day ago"
 
// `numeric: "auto"` results in strings like “yesterday” and “tomorrow”
new Intl.RelativeTimeFormat("en", { numeric: "auto" }).format(-1, "day")
// ⇒ "yesterday"
 
// the formatter can base its output on different languages
new Intl.RelativeTimeFormat("de").format(3, "month")
// ⇒ "in 3 Monaten"
Debug
none
Grid overlay