Skip to content

Latest commit

 

History

History
158 lines (133 loc) · 4.05 KB

README.md

File metadata and controls

158 lines (133 loc) · 4.05 KB
Raw

datef NPM version Build Status Coverage Status

datef is a Javascript date formatting library, both for browser and node.js.

Features

  • Can output: year, full year, month, day, hour, minutes, seconds, milliseconds and timezone — both zero padded and not
  • Simple localization
  • Built-in formats and easyly extensible
  • Doesn't mess with built-in prototypes
  • Acts as node.js and requirejs/amd module, and have .noConflict method in case no module system is present (e.g. plain browser environment)
  • No external dependencies
  • Contains predefined formats for some ISO8601 date and time representation
  • Thoroughly annotated with jsdoc, so if your IDE/editor supports it, you may never need interrupt yourself from code

Usage

Node.js

npm install datef
var datef = require('datef');
datef('MM.YYYY');

Require.js

require.config({
    paths: {
        'datef': 'path/to/datef'
    }
})
require(['datef'], function(datef){
    datef('MM.YYYY');
});

Browser

<script src="datef.js"></script>
<script>
    datef('MM.YYYY');
</script>

Basic usage

datef('dd.MM.YY', new Date()); // "13.08.13"
datef('dd.MM.YY'); // second argument is optional; datef takes Date.now() if no date is provided

var d = new Date();
d.setFullYear(2045);
datef('dd.MM.YYYY', d); // "13.08.2045"

Languages

Node.js

datef.lang('ru');
datef('dd MMMM'); // 13 августа

Require.js

require.config({
    paths: {
        'datef': 'path/to/datef',
        'datef_ru': 'path/to/datef_lang/ru'
    }
})

require(['datef', 'datef_ru'], function(datef){
    datef.lang('ru');
    datef('dd MMMM'); // 13 августа
});

Browser

<script src="datef.js"></script>
<script src="lang/ru.js"></script>
<script>
    datef.lang('ru');
    datef('dd MMMM'); // 13 августа
</script>

Custom formatters

// predefined formats
datef.formatters(); // ['ISODate','ISOTime','ISODateTime','ISODateTimeTZ']
datef('ISODateTimeTZ', d); // "2013-08-13T15:01:29 -04:00"

// defining your own simple format
datef.register('myFormat', 'd.M.YY');
datef('myFormat', d); // "13.8.13"

// defining your own format with i10n
datef.register('myI10nFormat', {
    'en': 'MMMM dd, DD',
    'ru': 'DD, dd MMMM',
    'default': 'dd MMMM'
});
datef('myI10nFormat', d); // "August 13, Tuesday"
datef.lang('ru');
datef('myI10nFormat', d); // "Вторник, 13 августа"
datef.lang('uk');
datef('myI10nFormat', d); // "13 жніўня"

Cleaning global namespace

This is similar to Backbone.noConflict()

<script>var datef = 'My very important data';</script>
…
<script src="datef.js"></script>

<script>
console.log(typeof datef); // "function"
var formattingLib = datef.noConflict();
console.log(datef); // 'My very important data'
</script>

Tokens

Full list of tokens possible in format string include:

  • YYYY: 4-digit year
  • YY: last 2 digit of year
  • MMMM: full name of month
  • MMM: short name of month
  • MM: ISO8601-compatible number of month (i.e. zero-padded) in year (with January being 1st month)
  • M: number of month in year without zero-padding (with January being 1st month)
  • DDD: full name of day
  • DD: short name of day
  • D: min name of day
  • dd: zero-padded number of day in month
  • d: number of day in month
  • HH: zero-padded 24 hour time
  • H: 24 hour time
  • hh: zero-padded 12 hour time
  • h: 12 hour time
  • mm: zero-padded minutes
  • m: minutes
  • ss: zero-padded seconds
  • s: seconds
  • ff: zero-padded milliseconds, 3 digits
  • f: milliseconds
  • A: AM/PM
  • a: am/pm
  • ZZ: time-zone in ISO8601-compatible basic format (i.e. "-0400")
  • Z: time-zone in ISO8601-compatible extended format (i.e. "-04:00")