Relative Time Parser Plugin for Moment.js

This plugin converts a simple string to a manipulated moment object. The string format is inspired by Graphite's relative time format.

Badges


Install - NPM

``
npm install relative-time-parser
`

Usage


Using the string `-7d` would be equivalent of `moment().subtract(7, 'days');`, and similarly, using the string `+7d` would be equivalent of `moment().add(7, 'days');`. The specific abbreviations are listed in the table below.

`JavaScript
var moment = require('relative-time-parser');
moment().relativeTime('-6h').format();
`

Patterns

$3


##### subtract milliseconds
`JavaScript
moment().relativeTime('-6ms');
`
##### add milliseconds
`JavaScript
moment().relativeTime('+6ms');
`

$3

##### subtract seconds
`JavaScript
moment().relativeTime('-6s');
`
##### add seconds
`JavaScript
moment().relativeTime('+6s');
`

$3

##### subtract seconds
`JavaScript
moment().relativeTime('-6sec');
`
##### add seconds
`JavaScript
moment().relativeTime('+6sec');
`

$3

##### subtract seconds
`JavaScript
moment().relativeTime('-6second');
`
##### add seconds
`JavaScript
moment().relativeTime('+6second');
`

$3

##### subtract seconds
`JavaScript
moment().relativeTime('-6seconds');
`
##### add seconds
`JavaScript
moment().relativeTime('+6seconds');
`

$3

##### subtract minutes
`JavaScript
moment().relativeTime('-6m');
`
##### add minutes
`JavaScript
moment().relativeTime('+6m');
`

$3

##### subtract minutes
`JavaScript
moment().relativeTime('-6min');
`
##### add minutes
`JavaScript
moment().relativeTime('+6min');
`

$3

##### subtract minutes
`JavaScript
moment().relativeTime('-6minute');
`
##### add minutes
`JavaScript
moment().relativeTime('+6minute');
`

$3

##### subtract minutes
`JavaScript
moment().relativeTime('-6minutes');
`
##### add minutes
`JavaScript
moment().relativeTime('+6minutes');
`

$3

##### subtract hours
`JavaScript
moment().relativeTime('-6h');
`
##### add hours
`JavaScript
moment().relativeTime('+6h');
`

$3

##### subtract hours
`JavaScript
moment().relativeTime('-6hour');
`
##### add hours
`JavaScript
moment().relativeTime('+6hour');
`

$3

##### subtract hours
`JavaScript
moment().relativeTime('-6hours');
`
##### add hours
`JavaScript
moment().relativeTime('+6hours');
`

$3

##### subtract days
`JavaScript
moment().relativeTime('-6d');
`
##### add days
`JavaScript
moment().relativeTime('+6d');
`

$3

##### subtract days
`JavaScript
moment().relativeTime('-6day');
`
##### add days
`JavaScript
moment().relativeTime('+6day');
`

$3

##### subtract weeks
`JavaScript
moment().relativeTime('-6w');
`
##### add weeks
`JavaScript
moment().relativeTime('+6w');
`

$3

##### subtract weeks
`JavaScript
moment().relativeTime('-6week');
`
##### add weeks
`JavaScript
moment().relativeTime('+6week');
`

$3

##### subtract weeks
`JavaScript
moment().relativeTime('-6weeks');
`
##### add weeks
`JavaScript
moment().relativeTime('+6weeks');
`

$3

##### subtract months
`JavaScript
moment().relativeTime('-6mon');
`
##### add months
`JavaScript
moment().relativeTime('+6mon');
`

$3

##### subtract months
`JavaScript
moment().relativeTime('-6month');
`
##### add months
`JavaScript
moment().relativeTime('+6month');
`

$3

##### subtract months
`JavaScript
moment().relativeTime('-6months');
`
##### add months
`JavaScript
moment().relativeTime('+6months');
`

$3

##### subtract months
`JavaScript
moment().relativeTime('-6M');
`
##### add months
`JavaScript
moment().relativeTime('+6M');
`

$3

##### subtract quarters
`JavaScript
moment().relativeTime('-6Q');
`
##### add quarters
`JavaScript
moment().relativeTime('+6Q');
`

$3

##### subtract quarters
`JavaScript
moment().relativeTime('-6Quarter');
`
##### add quarters
`JavaScript
moment().relativeTime('+6Quarter');
`

$3

##### subtract quarters
`JavaScript
moment().relativeTime('-6Quarters');
`
##### add quarters
`JavaScript
moment().relativeTime('+6Quarters');
`

$3

##### subtract years
`JavaScript
moment().relativeTime('-6y');
`
##### add years
`JavaScript
moment().relativeTime('+6y');
`

$3

##### subtract years
`JavaScript
moment().relativeTime('-6year');
`
##### add years
`JavaScript
moment().relativeTime('+6year');
`

$3

##### subtract years
`JavaScript
moment().relativeTime('-6years');
`
##### add years
`JavaScript
moment().relativeTime('+6years');
`

$3

`JavaScript
moment().relativeTime('now');
`

Is Relative Time String Format

$3

`JavaScript
moment().isRelativeTimeFormat('-2y'); // should === true
`

`JavaScript
moment().isRelativeTimeFormat('xxx'); // should === false
`

`JavaScript
moment().isRelativeTimeFormat('now'); // should === true
``

Resources

Graphite URL Api Reference