nano-date

Date class that supports up to nano seconds

MIT 50 个版本

nano date timestamp nanoseconds miliseconds microseconds time year day month

主页

仓库

提交 Issue

安装

npm install nano-date

yarn add nano-date

pnpm add nano-date

bun add nano-date

README

Nano Date

Date class that supports up to nano seconds

All of the normal date class functions with a few addtions.

If you pass a number in the constructor it will assume milliseconds however if you pass in a string of numbers it will assume nanoseconds.

const upToMillisecondPrecision  = new NanoDate(1497290225089); // assumes milliseconds
const upToMicrosecondPrecision  = new NanoDate(1497290225089.999); // assumes milliseconds
const upToNanosecondPrecision = new NanoDate('1497290225089999999'); // assumes nanoseconds

Why a string of numbers? This is because 13 digits is ~ the max you can have in javascript and not have it start rounding off and 16 digits is ~ the max you can have in a float before it too starts to round. So for our case of nanoseconds it needs up to 19 digits or more to represent time since epoch that goes far beyond what a integer or float can handle so we have to use strings. Under the hood we use a library called bignumber.js to handle the math we do on this number.

Extra available methods.

getMicroseconds

nanoDate.getMicroseconds(); // 0 - 999

getNanoseconds

nanoDate.getNanoseconds(); // 0 - 999

setMicroseconds - returns the microseconds value

nanoDate.setMicroseconds(25); // 25

setNanoseconds - returns the nanoseconds value

nanoDate.setNanoseconds(25); // 25

toString, toUTCString & toISOStringFull - adds millisecond, microsecond, nanosecond as a decimal to the seconds

nanoDate.toString(); // ie "Mon Jun 12 2017 12:57:05.089999999 GMT-0500 (CDT)"

valueOf && NanoDate.now() - returns a integer of millisecond precision
valueOfWithMicro - returns a float with microsecond precision

nanoDate.valueOfWithMicro(); // 1497290225089.999

valueOfWithNano - returns a float in a string with nanosecond precision

nanoDate.valueOfWithNano(); // "1497290225089.999999"

getTime - returns a string in nanoseconds

nanoDate.getTime(); // "1497290225089999999"

版本列表

4.1.0 2019-07-31

3.0.0 2018-07-11

2.1.0 2017-12-12

2.0.1 2017-09-25

2.0.0 2017-09-04

1.2.6 2017-07-21

1.2.5 2017-07-20

1.2.4 2017-07-13

1.2.3 2017-07-13

1.2.2 2017-07-13

1.2.1 2017-07-13

1.2.0 2017-07-13

1.1.4 2017-07-12

1.1.3 2017-07-03

1.1.2 2017-07-03

1.1.1 2017-07-03

1.1.0 2017-06-29

1.0.9 2017-06-29

1.0.8 2017-06-29

1.0.7 2017-06-29

1.0.6 2017-06-29

1.0.5 2017-06-29

1.0.4 2017-06-29

1.0.3 2017-06-29

1.0.2 2017-06-29

1.0.1 2017-06-29

1.0.0 2017-06-29

0.0.0-rc9 2017-06-29

0.0.0-rc8 2017-06-29

0.0.0-rc7 2017-06-29

0.0.0-rc6 2017-06-29

0.0.0-rc5 2017-06-29

0.0.0-rc4 2017-06-29

0.0.0-rc3 2017-06-29

0.0.0-rc23 2017-06-29

0.0.0-rc22 2017-06-29

0.0.0-rc21 2017-06-29

0.0.0-rc20 2017-06-29

0.0.0-rc2 2017-06-29

0.0.0-rc19 2017-06-29

0.0.0-rc18 2017-06-29

0.0.0-rc17 2017-06-29

0.0.0-rc16 2017-06-29

0.0.0-rc15 2017-06-29

0.0.0-rc14 2017-06-29

0.0.0-rc13 2017-06-29

0.0.0-rc12 2017-06-29

0.0.0-rc11 2017-06-29

0.0.0-rc10 2017-06-29

0.0.0-rc1 2017-06-29