atikin-timebuddy/README.md

Atikin TimeBuddy – Lightweight Date & Time Utilities for Everyday Use

# Atikin TimeBuddy

> 🚀 Lightweight Date & Time Utilities for Everyday Use – built with ❤️ by Atikin Verse

Atikin TimeBuddy is a blazing-fast, zero-dependency JavaScript utility toolkit for working with time and date. Whether you're formatting timestamps, calculating working days, or localizing timezones, TimeBuddy makes it easy.

## ✨ Features

- ✅ Human-readable time: `"2 minutes ago"`, `"3 days ago"`
- 📅 Simple date formatting: `"15 Jun 2025"`
- 🌐 Timezone support with native JS
- 🔁 Add/subtract days or hours
- 📆 Calculate working days
- 🗓️ Get labels like "Today", "Tomorrow", etc.
- 🧪 100% Testable, Zero Dependencies

## 📦 Installation

```bash
npm i atikin-timebuddy
```

## 🔧 Usage

```js
const {
  timeAgo,
  formatDate,
  getTimeInZone,
  addDays,
  subtractHours,
  isWeekend,
  workingDaysBetween,
  getRelativeDay
} = require('@atikinverse/timebuddy');

console.log(timeAgo('2025-06-14T19:30:00')); // "x hours ago"
console.log(formatDate(new Date(), 'short')); // "15 Jun 2025"
console.log(getTimeInZone('Asia/Kolkata')); // "2025-06-15 09:30 PM"
console.log(addDays(new Date(), 5)); // Add 5 days to today
console.log(isWeekend(new Date())); // true or false
console.log(workingDaysBetween('2025-06-01', '2025-06-15')); // 11
console.log(getRelativeDay('2025-06-15')); // "Today"
```

## 🔒 License

MIT © Atikin Verse.


## FOLLOW US ON For more information:

Join our social media for exciting updates, news, and insights! Follow us on :

<!--Table-->
| ACCOUNTS                 | USERNAME          |
|------------              | --------------    |
| FACEBOOK                 | atikinverse       |
| INSTAGRAM                | atikinverse       |
| LINKEDIN                 | atikinverse       |
| TWITTER (X)              | atikinverse       |
| THREADS                  | atikinverse       |
| PINTREST                 | atikinverse       |
| QUORA                    | atikinverse       |
| REDDIT                   | atikinverse       |
| TUMBLR                   | atikinverse       |
| SNAPCHAT                 | atikinverse       |
| SKYPE                    | atikinverse       |
| GITHUB                   | atikinverse       |


Feel free to reach out if you have any questions or suggestions!

Happy Coding! 🚀