Skip to content

Parse grafana-inspired relative date notation into momentjs instances

License

Notifications You must be signed in to change notification settings

AdvancedClimateSystems/moment-relativism

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

moment-relativism

Build Status

Parse a grafana-inspired relative date notation into momentjs instances. Where "relative" means: relative to now.

Usage

Pass in a string in moment-relativism's relative date notation.

var moment = require('moment-relativism');
var result = moment.relativism('now-7d');

// logs "Thu Aug 04 2016 16:03:28 GMT+0200" when now is "Thu Aug 11 2016 16:03:28 GMT+0200"
console.log(result.toString());

You can also pass in an object. moment.relativism will return an object of the same structure (same fields), but with the values replaced with their current momentjs equivalent instances.

var moment = require('moment-relativism');

// I want the date range for exactly the last 7 days (not rounded).
var range = {
    from: 'now-7d',
    to: 'now'
};

var result = moment.relativism(range);

// logs "Thu Aug 04 2016 16:03:28 GMT+0200" and "Thu Aug 11 2016 16:03:28 GMT+0200"
console.log(result.from.toString(), result.to.toString());

Check out the tests directory for more detailed usage.

Notation

moment-relativism's notation is based on grafana's relative date parser. However, grafana's notation does not provide a way to distinguish between rounding up or rounding down. Instead the rounding character / is rounded up or down based on the context the string is used in. If the string is used as a "from" date in a date range, it rounds down. Otherwise it rounds down.

moment-relativism differs here, as it adds a | character for rounding down. / is always used for rounding up.

When adding, subtracting and rounding you can use moment's shorthand keys for years, days, etc as found in moment's documentation.

Notation Result
now+1d Add one day to now
now-1d Subtract one day from now
now+1d/d Add one day to now, round up to end of day
`now-1d d`
now Just returns the date corresponding to now
now/d Rounds up to todays end of day.
`now d`

License

This software is copyrighted by Advanced Climate Systems bv, and released under the Mozilla Public License v2.0. See the LICENSE file for the entire license.

About

Parse grafana-inspired relative date notation into momentjs instances

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published