chronos-date 1.2.0 → 1.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +104 -5
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,8 +1,51 @@
|
|
|
1
|
-
# Chronos Date
|
|
2
|
-
|
|
3
|
-
A lightweight, immutable, and plugin-based date-time manipulation library for JavaScript and TypeScript.
|
|
4
|
-
|
|
5
|
-

|
|
1
|
+
# [Chronos Date](https://chronos.nazmul-nhb.dev/)
|
|
2
|
+
|
|
3
|
+
> A lightweight, immutable, and plugin-based date-time manipulation library for JavaScript and TypeScript.
|
|
4
|
+
|
|
5
|
+
[](https://chronos.nazmul-nhb.dev/)
|
|
6
|
+
|
|
7
|
+
<p>
|
|
8
|
+
<!-- Package Info -->
|
|
9
|
+
<a href="https://www.npmjs.com/package/chronos-date" aria-label="NPM Downloads">
|
|
10
|
+
<img src="https://img.shields.io/npm/dm/chronos-date.svg?label=DOWNLOADS&style=flat&color=red&logo=npm" alt="Downloads" />
|
|
11
|
+
</a>
|
|
12
|
+
<a href="https://www.npmjs.com/package/chronos-date" aria-label="Latest Version">
|
|
13
|
+
<img src="https://img.shields.io/npm/v/chronos-date.svg?label=NPM&style=flat&color=teal&logo=npm" alt="Latest Version" />
|
|
14
|
+
</a>
|
|
15
|
+
<a href="https://bundlejs.com/?q=chronos-date" aria-label="Bundle Size">
|
|
16
|
+
<img src="https://img.shields.io/bundlejs/size/chronos-date?label=Bundle%20Size&style=flat&color=blue&logo=npm" alt="Bundle Size" />
|
|
17
|
+
</a>
|
|
18
|
+
|
|
19
|
+
<!-- Project Metadata -->
|
|
20
|
+
<a href="https://github.com/nazmul-nhb/chronos-date" aria-label="TypeScript">
|
|
21
|
+
<img src="https://img.shields.io/badge/BUILT%20with-TypeScript-3178C6?style=flat&logo=typescript&logoColor=blue" alt="Built with TypeScript" />
|
|
22
|
+
</a>
|
|
23
|
+
<a href="https://github.com/nazmul-nhb/chronos-date/actions" aria-label="Build Status">
|
|
24
|
+
<img src="https://img.shields.io/github/actions/workflow/status/nazmul-nhb/chronos-date/publish.yml?label=BUILD%20%26%20PUBLISH&style=flat&logo=github" alt="Build Status" />
|
|
25
|
+
</a>
|
|
26
|
+
<a href="https://github.com/nazmul-nhb/chronos-date" aria-label="Project Status">
|
|
27
|
+
<img src="https://img.shields.io/badge/STATUS-maintained-brightgreen?style=flat&logo=git" alt="Maintained" />
|
|
28
|
+
</a>
|
|
29
|
+
<a href="https://github.com/nazmul-nhb/chronos-date/commits/main" aria-label="Last Commit">
|
|
30
|
+
<img src="https://img.shields.io/github/last-commit/nazmul-nhb/chronos-date?style=flat&label=LAST%20COMMIT&logo=git" alt="Last Commit" />
|
|
31
|
+
</a>
|
|
32
|
+
|
|
33
|
+
<!-- GitHub Meta -->
|
|
34
|
+
<a href="https://github.com/nazmul-nhb/chronos-date/stargazers" aria-label="GitHub Stars">
|
|
35
|
+
<img src="https://img.shields.io/github/stars/nazmul-nhb/chronos-date?style=flat&label=STARS&logo=github" alt="GitHub stars" />
|
|
36
|
+
</a>
|
|
37
|
+
<a href="https://github.com/nazmul-nhb/chronos-date/issues" aria-label="Open Issues">
|
|
38
|
+
<img src="https://img.shields.io/github/issues/nazmul-nhb/chronos-date?style=flat&label=ISSUES&logo=github" alt="Open Issues" />
|
|
39
|
+
</a>
|
|
40
|
+
<a href="https://github.com/nazmul-nhb/chronos-date/pulls" aria-label="Open Pull Requests">
|
|
41
|
+
<img src="https://img.shields.io/github/issues-pr/nazmul-nhb/chronos-date?style=flat&label=PRs&logo=github" alt="Pull Requests" />
|
|
42
|
+
</a>
|
|
43
|
+
|
|
44
|
+
<!-- License Info -->
|
|
45
|
+
<a href="https://www.npmjs.com/package/chronos-date" aria-label="License">
|
|
46
|
+
<img src="https://img.shields.io/npm/l/chronos-date.svg?label=LICENSE&style=flat&color=orange&logo=open-source-initiative" alt="License" />
|
|
47
|
+
</a>
|
|
48
|
+
</p>
|
|
6
49
|
|
|
7
50
|
## Why Chronos?
|
|
8
51
|
|
|
@@ -20,6 +63,8 @@ Designed to go beyond the native `Date` object, it empowers you to manipulate, f
|
|
|
20
63
|
- **Comprehensive TypeScript IntelliSense:** Built with first-class TypeScript types and granular tracking for strict date formatting tokens.
|
|
21
64
|
- **Cross-environment compatibility:** Works anywhere JS runs (Node.js, Browser, Deno, Bun).
|
|
22
65
|
|
|
66
|
+
---
|
|
67
|
+
|
|
23
68
|
## Installation
|
|
24
69
|
|
|
25
70
|
```sh
|
|
@@ -30,6 +75,8 @@ yarn add chronos-date
|
|
|
30
75
|
pnpm add chronos-date
|
|
31
76
|
```
|
|
32
77
|
|
|
78
|
+
---
|
|
79
|
+
|
|
33
80
|
## Quick Start
|
|
34
81
|
|
|
35
82
|
```ts
|
|
@@ -48,6 +95,8 @@ const eventDate = new Chronos('2025-12-31');
|
|
|
48
95
|
console.log(now.diff(eventDate, 'day')); // Days until event
|
|
49
96
|
```
|
|
50
97
|
|
|
98
|
+
---
|
|
99
|
+
|
|
51
100
|
## Modular Imports
|
|
52
101
|
|
|
53
102
|
You can import specific submodules for better tree-shaking:
|
|
@@ -70,10 +119,60 @@ import { timeZonePlugin } from "chronos-date/plugins/timeZonePlugin";
|
|
|
70
119
|
import { seasonPlugin } from "chronos-date/plugins/seasonPlugin";
|
|
71
120
|
```
|
|
72
121
|
|
|
122
|
+
---
|
|
123
|
+
|
|
73
124
|
## Documentation
|
|
74
125
|
|
|
75
126
|
For full documentation, API reference, and interactive playgrounds, visit the [**Documentation Site**](https://chronos.nazmul-nhb.dev/).
|
|
76
127
|
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
## 🔗 Related Packages
|
|
131
|
+
|
|
132
|
+
<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
|
|
133
|
+
<a target="_blank" href="https://www.npmjs.com/package/nhb-toolbox">
|
|
134
|
+
<img src="https://img.shields.io/badge/NHB_Toolbox-nhb--toolbox-steelblue" alt="nhb-toolbox" />
|
|
135
|
+
</a>
|
|
136
|
+
</div>
|
|
137
|
+
|
|
138
|
+
<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
|
|
139
|
+
<a target="_blank" href="https://www.npmjs.com/package/bn-calendar">
|
|
140
|
+
<img src="https://img.shields.io/badge/Bangla_Calendar-bn--calendar-red" alt="bn-calendar" />
|
|
141
|
+
</a>
|
|
142
|
+
</div>
|
|
143
|
+
|
|
144
|
+
<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
|
|
145
|
+
<a target="_blank" href="https://www.npmjs.com/package/nhb-hooks">
|
|
146
|
+
<img src="https://img.shields.io/badge/React_Hooks-nhb--hooks-blue" alt="nhb-hooks" />
|
|
147
|
+
</a>
|
|
148
|
+
</div>
|
|
149
|
+
|
|
150
|
+
<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
|
|
151
|
+
<a target="_blank" href="https://www.npmjs.com/package/locality-idb">
|
|
152
|
+
<img src="https://img.shields.io/badge/IndexedDB_ORM-locality--idb-darkviolet" alt="locality-idb" />
|
|
153
|
+
</a>
|
|
154
|
+
</div>
|
|
155
|
+
|
|
156
|
+
<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
|
|
157
|
+
<a target="_blank" href="https://www.npmjs.com/package/nhb-scripts">
|
|
158
|
+
<img src="https://img.shields.io/badge/Development_Scripts-nhb--scripts-red" alt="nhb-scripts" />
|
|
159
|
+
</a>
|
|
160
|
+
</div>
|
|
161
|
+
|
|
162
|
+
<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
|
|
163
|
+
<a target="_blank" href="https://www.npmjs.com/package/nhb-express">
|
|
164
|
+
<img src="https://img.shields.io/badge/Express_Server_Scaffolder-nhb--express-orange" alt="nhb-express" />
|
|
165
|
+
</a>
|
|
166
|
+
</div>
|
|
167
|
+
|
|
168
|
+
<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
|
|
169
|
+
<a target="_blank" href="https://www.npmjs.com/package/nhb-anagram-generator">
|
|
170
|
+
<img src="https://img.shields.io/badge/Anagram_Generator-nhb--anagram--generator-teal" alt="nhb-anagram-generator" />
|
|
171
|
+
</a>
|
|
172
|
+
</div>
|
|
173
|
+
|
|
174
|
+
---
|
|
175
|
+
|
|
77
176
|
## License
|
|
78
177
|
|
|
79
178
|
This project is licensed under the [Apache License 2.0](LICENSE).
|
package/package.json
CHANGED