@croct/time

Time Library
Additional date-time classes that complement the standard library.

📦Releases · 🐞Report Bug · ✨Request Feature

Installation

Use the package manage NPM to install the package:

npm install @croct/time

Time zones

Offsets for region-based zones come from Intl. Daylight savings gaps and overlaps are fully supported, but Intl only reports the offset in effect at a point in time, which leads to three limits:

• Standard time and daylight savings time cannot be told apart, since both look the same through Intl.
• There is no list of transitions to read, so getNextTransition and getPreviousTransition search about five years from the given instant and return null past that. Checking whether a local date-time falls in a gap or an overlap does not need the list, and has no such limit.
• Offsets before 1970 depend on the Intl data of the runtime, and some environments drop the early history of some zones.
• The data is only reachable for the points in time a native date object can represent, roughly 273,790 years around 1970, so region-based zones reject the instants and local date-times beyond that range rather than guess an offset. The bound for a local date-time is a few days tighter, as resolving one reads the offsets around it.

Contributing

Contributions to the package are always welcome!

• Report any bugs or issues on the issue tracker.
• For major changes, please open an issue first to discuss what you would like to change.
• Please make sure to update tests as appropriate.

Testing

Before running the test suites, the development dependencies must be installed:

npm install

Then, to run all tests:

npm run test

Run the following command to check the code against the style guide:

npm run lint

Building

Before building the project, the dependencies must be installed:

npm run build

Local development

To use a local development version on other projects, you must link the built artifacts with npm:

npm run build
cd build
ln -s ../package.json package.json || true
npm link

Then on any other project that uses the library:

npm link @croct/time

License

Copyright © 2015-2021 Croct Limited, All Rights Reserved.

All information contained herein is, and remains the property of Croct Limited. The intellectual, design and technical concepts contained herein are proprietary to Croct Limited s and may be covered by U.S. and Foreign Patents, patents in process, and are protected by trade secret or copyright law. Dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from Croct Limited.