ago-i18n

Fully unit tested module to convert Date objects into human readable relative timestamps, such as '4 minutes ago', 'yesterday', 'tomorrow', or 'in 3 months'.

Adapted from the excellent work of Sebastian Sandqvist available as s-ago

This version is a javascript adaptation (original in typescript) and adds i18n capabilities and a spanish version. It is easily translatable, refer to i18n documentation

Usage

var ago = require("ago-i18n");

// Set locale "en" or "es" (en by default)
ago.locale = "en";

var now = new Date();
var yesterday = new Date(now.getTime() - 24 * 60 * 60 * 1000);
var hoursAgo = new Date(now.getTime() - 6 * 60 * 60 * 1000);
var yesterday = new Date(now.getTime() - 24 * 60 * 60 * 1000);
var tomorrow = new Date(now.getTime() + 6 * 60 * 60 * 1000);
var inSixHours = new Date(now.getTime() + 6 * 60 * 60 * 1000);

// present
ago(now); // 'just now'

// past
ago(yesterday); // 'yesterday'
ago(hoursAgo); // '6 hours ago'

// future
ago(inSixHours); // 'in 6 hours'
ago(tomorrow); // 'tomorrow'

Output is as follows:

| Time | Output | Future output | | -------------------- | --------------- | -------------- | | Less than 1 minute | just now | just now | | 1-2 minutes | a minute ago | in a minute | | 2-46 minutes | # minutes ago | in # minutes | | 46 minutes - 2 hours | an hour ago | in an hour | | 2-20 hours | # hours ago | in # hours | | 20-48 hours | yesterday | tomorrow | | 2-6 days | last week | in a week | | 7-28 days | # weeks ago | in # weeks | | 28 days - 2 months | last month | in a month | | 2-11 months | # months ago | in # months | | 11-23 months | last year | in a year | | 2+ years | # years ago | in # years |