s-date

s-date

Same general purpose as moment.js, but in ~1kb minified.

This CommonJS module exports a single function that takes two parameters. The first is a format string, the second is an optional Date. If the date is omitted, it defaults to new Date();.

If you don't need full customizability for your date string, you probably don't need this library. Just use Date.toLocaleDateString() and related methods.

Usage

var date = require('s-date');

var myBirthday = new Date(1994, 10, 7);
date('{mm}/{dd}/{yyyy}', myBirthday); // '11/07/1994'

Formatting options

Example: For January 2, 2053 4:30pm + 45 seconds

String template	Output example	Meaning
{yyyy}	2053	4-digit year
{yy}	53	2-digit year
{mm}	01	2-digit month
{m}	1	unpadded month
{Month}	January	month name
{Mo}	Jan	month shortname
{d}	2	date
{ds}	2nd	date + suffix
{dd}	02	2-digit date
{Weekday}	Thursday	day of the week
{Day}	Thu	day shortname
{Dy}	Th	day shortername
{D}	T	1-char day name
{h24}	16	unpadded hours (24)
{hh24}	16	hours (24)
{hh}	04	hours (12)
{h}	4	unpadded hours (12)
{ampm}	pm	am/pm
{AMPM}	PM	AM/PM
{Minutes}	30	Minutes (padded)
{Seconds}	45	Seconds (padded)

To output the example above...

// Date(year, month-1, date, hours, minutes, seconds)
var someDay = new Date(2053, 0, 2, 4, 30, 45);
date('{Month} {d}, {yyyy} {h}:{Minutes}{ampm} + {Seconds} seconds', someDay);

Benchmarks

Run using benchmark.js on 2.3GHz Macbook Pro

s-date    x 428,936 ops/sec ±2.29% (79 runs sampled)
moment    x 271,963 ops/sec ±1.34% (85 runs sampled)
date-fns  x 196,827 ops/sec ±1.17% (80 runs sampled)
dayjs     x 121,425 ops/sec ±1.99% (87 runs sampled)
luxon     x 90,782 ops/sec ±1.13% (83 runs sampled)
Fastest is s-date