Date Utils 🗓️

[![NPM Latest Version][version-badge]][npm-url] [![Coverage Status][coverage-badge]][coverage-url] [![Socket Status][socket-badge]][socket-url] [![NPM Monthly Downloads][downloads-badge]][npm-url] [![Dependencies][deps-badge]][deps-url]

[![GitHub Sponsor][sponsor-badge]][sponsor-url]

[version-badge]: https://img.shields.io/npm/v/%40alessiofrittoli%2Fdate-utils
[npm-url]: https://npmjs.org/package/%40alessiofrittoli%2Fdate-utils
[coverage-badge]: https://coveralls.io/repos/github/alessiofrittoli/date-utils/badge.svg
[coverage-url]: https://coveralls.io/github/alessiofrittoli/date-utils
[socket-badge]: https://socket.dev/api/badge/npm/package/@alessiofrittoli/date-utils
[socket-url]: https://socket.dev/npm/package/@alessiofrittoli/date-utils/overview
[downloads-badge]: https://img.shields.io/npm/dm/%40alessiofrittoli%2Fdate-utils.svg
[deps-badge]: https://img.shields.io/librariesio/release/npm/%40alessiofrittoli%2Fdate-utils
[deps-url]: https://libraries.io/npm/%40alessiofrittoli%2Fdate-utils

[sponsor-badge]: https://img.shields.io/static/v1?label=Fund%20this%20package&message=%E2%9D%A4&logo=GitHub&color=%23DB61A2
[sponsor-url]: https://github.com/sponsors/alessiofrittoli

Lightweight TypeScript date utility functions library

This lightweight TypeScript utility library comes with common and utility dates functions.

Everything is exported from the root of this library but specific paths can be used too (especially when dynamically importing functions and tree shaking has no effect).

$3

- Getting started
- What's Changed
- What's inside
- Common utilities
- Formatting functions
- Timezone utilities
- Utility functions
- Development
- Install depenendencies
- Build the source code
- ESLint
- Jest
- Contributing
- Security
- Credits

---

$3

Run the following command to start using date-utils in your projects:

``bash
npm i @alessiofrittoli/date-utils
`

or using pnpm

`bash
pnpm i @alessiofrittoli/date-utils
`

---

$3

#### Updates in the latest release 🎉

- formatDate
- token T now outputs time divider.
- Timezone identifier - short offset is now returned by o token.

---

$3

#### Install depenendencies

`bash
npm install
`

or using pnpm

`bash
pnpm i
`

#### Build the source code

Run the following command to test and build code for distribution.

`bash
pnpm build
`

#### ESLint

warnings / errors check.

`bash
pnpm lint
`

#### Jest

Run all the defined test suites by running the following:

`bash


Run tests and watch file changes.

pnpm test:watch

Run tests in a CI environment.

pnpm test:ci
`

- See package.json file scripts for more info.

Run tests with coverage.

An HTTP server is then started to serve coverage files from ./coverage folder.

⚠️ You may see a blank page the first time you run this command. Simply refresh the browser to see the updates.

`bash
test:coverage:serve
`

---

$3

Contributions are truly welcome!

Please refer to the Contributing Doc for more information on how to start contributing to this project.

Help keep this project up to date with [GitHub Sponsor][sponsor-url].

[![GitHub Sponsor][sponsor-badge]][sponsor-url]

---

$3

If you believe you have found a security vulnerability, we encourage you to _responsibly disclose this and NOT open a public issue_. We will investigate all legitimate reports. Email security@alessiofrittoli.it` to disclose any security vulnerabilities.

$3

Alessio Frittoli https://alessiofrittoli.it | info@alessiofrittoli.it