t-since (Relative Time Format)

Format the relative time between the current date and a given date in a human readable format. The output is rounded to the nearest time unit, i.e. 1 year ago, 5 minutes ago, in 3 days, in 6 seconds.

Built on top of the Intl.RelativeTimeFormat API. Supports multiple languages and custom formatting options.

Install

$ npm install t-since --save

Usage

1import Time from "t-since";
2
3const time = Time();
4time.Relative(new Date("2024-01-01T00:00:00.000Z")); // "2 months ago"
5
6const timeRO = Time("ro", { numeric: "auto" });
7timeRO.Relative(new Date("2024-05-01T00:00:00.000Z")); // "peste 2 luni"
8
9const timeES = Time("es", { style: "long" });
10timeES.Relative(new Date("2024-01-01T00:00:00.000Z")); // "hace 2 meses"

v1 (old)

1const timeSince = require("t-since");
2
3timeSince(new Date("2023-01-01T00:00:00.000Z")) + " ago"; // 5 months ago