Instant.js

A small package to format dates and durations.

Installation

npm i @coalaura/instant.js

Usage (durations)

import instant from "@coalaura/instant.js";

// Either use seconds
console.log(instant.ago(12345678)); // 4 months ago
console.log(instant.ago(-1234)); // since 20 minutes

// Or specify your duration type
console.log(instant.ago(3, "days")); // 3 days ago
console.log(instant.ago(-14, "minutes")) // since 14 minutes

Usage (dates)

import instant from "@coalaura/instant.js";

// Format a timestamp in your timezone
const myDate = instant.unix(1670610204);

console.log(myDate.format("d.m.Y - h:i:s a P"));
// 09.12.2022 - 07:23:24 pm +01:00

// Or force it to be UTC
console.log(myDate.utc().format("d.m.Y - h:i:s a P"));
// 09.12.2022 - 06:23:24 pm +00:00

|Format Character|Description|Example returned values| |--|--|--| |Day|---|---| |d|Day of the month, 2 digits with leading zeros|01 to 31| |D|A textual representation of a day, three letters|Mon through Sun| |j|Day of the month without leading zeros|1 to 31| |l (lowercase "L")|A full textual representation of the day of the week|Sunday through Saturday| |N|ISO 8601 numeric representation of the day of the week|1 (for Monday) through 7 (for Sunday)| |S|English ordinal suffix for the day of the month, 2 characters|st, nd, rd or th. Works well with j| |w|Numeric representation of the day of the week|0 (for Sunday) through 6 (for Saturday)| |Month|---|---| |F|A full textual representation of a month, such as January or March|January through December| |m|Numeric representation of a month, with leading zeros|01 through 12| |M|A short textual representation of a month, three letters|Jan through Dec| |n|Numeric representation of a month, without leading zeros|1 through 12| |t|Number of days in the given month|28 through 31| |Year|---|---| |L|Whether it's a leap year|1 if it is a leap year, 0 otherwise.| |Y|A full numeric representation of a year, at least 4 digits, with - for years BCE.|-0055, 0787, 1999, 2003, 10191| |y|A two digit representation of a year|Examples: 99 or 03| |Time|---|---| |a|Lowercase Ante meridiem and Post meridiem|am or pm| |A|Uppercase Ante meridiem and Post meridiem|AM or PM| |g|12-hour format of an hour without leading zeros|1 through 12| |G|24-hour format of an hour without leading zeros|0 through 23| |h|12-hour format of an hour with leading zeros|01 through 12| |H|24-hour format of an hour with leading zeros|00 through 23| |i|Minutes with leading zeros|00 to 59| |s|Seconds with leading zeros|00 through 59| |u|Milliseconds|654| |Timezone|---|---| |e|Timezone identifier|UTC, GMT, Atlantic/Azores| |O|Difference to Greenwich time (GMT) without colon between hours and minutes|+0200| |P|Difference to Greenwich time (GMT) with colon between hours and minutes|+02:00| |Full Date/Time|---|---| |c|ISO 8601 date|2004-02-12T15:19:21+00:00| |r|RFC 2822/ RFC 5322 formatted date|Thu, 21 Dec 2000 16:01:07 +0200| |U|Seconds since the Unix Epoch (January 1 1970 00:00:00 GMT)|1662731715|