/s-date

Tiny date/time formatter

Primary LanguageJavaScript

s-date

NPM version Dependencies build status NPM license Test Coverage

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();.

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} 2 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);

License

Copyright (c) 2015, Sebastian Sandqvist s.github@sparque.me

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.