🕒 TimeX

A lightweight JavaScript utility library for date and time manipulation.

TimeX provides a collection of simple and powerful functions to format dates, get day/month names, calculate age, check weekdays/weekends, handle timezones, and more. Perfect for modern JavaScript projects.

---

📦 Installation

You can install TimeX using npm or yarn:

$3

``bash
npm install timex
`

$3

`bash
yarn add timex
`

---

⚡ Usage

`javascript
import TimeX, {
formatDate,
getDayName,
getShortDayName,
getMonthName,
getShortMonthName,
toISO,
toUTC,
toUnix,
isLeapYear,
getTimeOfDay,
getAgeFromDateOfBirth,
isToday,
isYesterday,
isTomorrow,
isWeekend,
isWeekday,
isSameDay,
getTimeZone
} from 'timex';

// Formatting Dates
console.log(formatDate(new Date(), "DD/MM/YYYY")); // "04/12/2025"

// Day and Month Names
console.log(getDayName(new Date())); // "Thursday"
console.log(getShortDayName(new Date())); // "Thu"
console.log(getMonthName(new Date())); // "December"
console.log(getShortMonthName(new Date())); // "Dec"

// Convert Dates
console.log(toISO(new Date())); // "2025-12-04T12:30:00.000Z"
console.log(toUTC(new Date())); // { year: 2025, month: 12, day: 4, hour: 12, minute: 30, second: 0, iso: "2025-12-04T12:30:00.000Z" }
console.log(toUnix(new Date())); // 1730675400

// Leap Year Check
console.log(isLeapYear(2024)); // true
console.log(isLeapYear(1900)); // false
console.log(isLeapYear(2000)); // true

// Time of Day
console.log(getTimeOfDay(new Date())); // "afternoon"

// Age Calculation
console.log(getAgeFromDateOfBirth("1990-05-15")); // 35

// Relative Date Checks
console.log(isToday(new Date())); // true
console.log(isYesterday("2025-12-03")); // true
console.log(isTomorrow("2025-12-05")); // true

// Weekday / Weekend Checks
console.log(isWeekend(new Date())); // false
console.log(isWeekday(new Date())); // true

// Compare Two Dates
console.log(isSameDay("2025-12-04", new Date())); // true

// Get Timezone
console.log(getTimeZone()); // "Asia/Kolkata"
`

---

✅ Features

* Format dates (formatDate)
* Get day & month names (long and short)
* ISO, UTC, and Unix timestamp conversion
* Leap year detection (isLeapYear)
* Time of day detection (getTimeOfDay)
* Age calculation (getAgeFromDateOfBirth)
* Relative date checks (isToday, isYesterday, isTomorrow)
* Weekday/weekend checks (isWeekday, isWeekend)
* Compare two dates (isSameDay)
* Timezone detection (getTimeZone`)

---

🔗 License

MIT License