<p align="center">
	<img src="https://github.com/sgx4u/sgx4u-date-time-utils/blob/production/logo.svg?raw=true" width="75px" align="center" alt="SGX4U" />
	<h2 align="center">🌟 @sgx4u/date-time-utils 🌟</h2>
	<p align="center">A date-time utility library</p>
</p>

<br/>

<p align="center">
	<!-- NPM Version -->
	<img src="https://img.shields.io/npm/v/%40sgx4u%2Fdate-time-utils?style=for-the-badge&labelColor=353535&color=3b82f6" alt="Version">
	<!-- Tests -->
	<img src="https://img.shields.io/badge/test%20passing-65a30d?style=for-the-badge" alt="Version">
	<!-- License -->
	<img src="https://img.shields.io/github/license/sgx4u/sgx4u-date-time-utils?style=for-the-badge&labelColor=353535&color=4f46e5" alt="License">
	<!-- TypeScript -->
	<img src="https://img.shields.io/badge/typescript-%23007ACC.svg?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript">
	<!-- JavaScript -->
	<img src="https://img.shields.io/badge/javascript-%23323330.svg?style=for-the-badge&logo=javascript&logoColor=%23F7DF1E" alt="JavaScript">
	<!-- LinkedIn -->
	<a href="https://www.linkedin.com/in/sgx4u" rel="nofollow"><img src="https://img.shields.io/twitter/url?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fsgx4u%2F&style=for-the-badge&logo=linkedin&label=SGX4U&labelColor=%230077B5&color=%23353535" alt="LinkedIn"></a>
	<!-- X (Twitter) -->
	<a href="https://x.com/sgx4u" rel="nofollow"><img src="https://img.shields.io/twitter/url?url=https%3A%2F%2Fx.com%2Fsgx4u&style=for-the-badge&logo=x&label=sgx4u&labelColor=353535" alt="X (Twitter)"></a>
	<!-- Last Update -->
	<img src="https://img.shields.io/npm/last-update/%40sgx4u%2Fdate-time-utils?style=for-the-badge&labelColor=353535&color=f15b2a" alt="Update">
</p>

<br/>
<br/>

## ⚜️Table of contents

> ⚡Links to the documentations.

-   [`formatDateTime`](https://github.com/sgx4u/sgx4u-date-time-utils/blob/production/src/format-date-time/format-date-time.md) &dash; Format a date-time
-   [`dateTimeDifference`](https://github.com/sgx4u/sgx4u-date-time-utils/blob/production/src/date-time-difference/date-time-difference.md) &dash; Calculate the difference between two date/time.
-   [`indexToDay` `indexToMonth`](https://github.com/sgx4u/sgx4u-date-time-utils/blob/production/src/index-to-name/index-to-name.md) &dash; Get the day/month name from index
-   [`addSubtractTime`](https://github.com/sgx4u/sgx4u-date-time-utils/blob/production/src/add-subtract-time/add-subtract-time.md) &dash; Add/Subtract time value from a given time and get the new value in different formats
-   [`isValidDate`](https://github.com/sgx4u/sgx4u-date-time-utils/blob/production/src/is-valid-date/is-valid-date.md) &dash; Check if the given date is valid or not
-   [`isLeapYear`](https://github.com/sgx4u/sgx4u-date-time-utils/blob/production/src/is-leap-year/is-leap-year.md) &dash; Check if the given year is a leap year
-   [`getNextOccurrence`](https://github.com/sgx4u/sgx4u-date-time-utils/blob/production/src/get-next-occurrence/get-next-occurrence.md) &dash; Find the next occurrence of the given day

<br/>

## 💡Installation

```sh
npm install @sgx4u/date-time-utils       # npm
yarn add @sgx4u/date-time-utils          # yarn
pnpm add @sgx4u/date-time-utils          # pnpm
```
