eddiejibson/dubium

Light Javascript date and time utilities (formatting, ranges e.t.c)

Light (1kb gzipped) Javascript date and time utilities (formatting, ranges e.t.c).

If you appreciate this project, please 🌟 it on GitHub.

Dubium works both in the browser and with node.

For browser use, either host the dubium.js file yourself (By downloading the current release here) or use a CDN (and, yes, it's free):

<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/dubium.min.js"></script>

As for NodeJS, it can be included like so:

const dubium = require("dubium");

Example

// In this example, if the date is not passed in, we'll pretend it's currently
// Febuary 1, 1970 19:30:00 UTC.

// .format returns the current date and/or time in a formatted manor
dubium.format("DD/MM/YYYY hh:mm:ss") // 01/02/1970 19:30:00
dubium.format("MM/DD/YYYY H:mm:ss a") // 02/01/1970 7:30:00 pm
dubium.format("DD/MMM/YY H:mm:ss A") // 01/Mar/70 7:30:00 PM
dubium.format("DD/MMMM/YY H:mm:ss A") // 01/March/70 7:30:00 PM

// You can also pass in a date to format:
dubium.format("DD/MM/YYYY hh:mm:ss", 1554159037369); // 01/04/2019 23:50:37
dubium.format("DD/MM/YYYY hh:mm:ss", "Fri, 02 Feb 1996 03:04:05 GMT"); // 02/02/1996 03:04:05

// You may unformat a string to get the epoch integer:
dubium.unformat("01/March/70 7:30:00 PM", "DD/MMMM/YY H:mm:ss A"); // 3163604400000

// You can get all the day value from a range of dates (inclusive of the ones being passed in)...
dubium.daysInRange(1554160761053, 1554333561053) // Array(3) [ 1554160761053, 1554247161053, 1554333561053 ]

// You can also get the range of the start of the week and end
dubium.getWeekRange() //Array [ 1554073200000, 1554677999999 ]
// Obviously you can pass an epoch value, too, if you want:
dubium.getWeekRange(3163604400000); // Array [ 3163446000000, 3161375999999 ]

// And, yeah, that's pretty much it... 
// These functions will be improved and added upon soon, too.

Benchmarks

Tested the speed of formatting and unformatting in Chrome 75 on Windows 10.

See it for yourself here on jsPerf.

Library	Ops/sec
Dubium	197,278
DayJS	108,859
MomentJS	56,163

Development

Building dubium for browser:

npm run build

dubium's Issues

Benchmarks

Could we get some benchmarks against other popular dateformatting libraries? Here are some possible candidates:

• Moment.js
• date-format
• dateformat
• date-fns

IE11 syntax error

Hi,

The main property in the package json should point to the built version of the lib in the dist folder(dist/dubium.min.js), so I could import it directly.

Thank you