⏳ Time Humanizer - Make Time More Human!


> A lightweight utility to humanize time intervals and durations, making them easier to understand for your users. Supports both CommonJS and ESM.

---

🚀 Features

- Human-Readable Time: Turn durations into easy-to-read strings like 5 minutes ago or in 3 days.
- Flexible Options: Customize output formats, thresholds, and more.
- Multi-Language Support: Coming Soon!
- Lightweight: Minimal dependencies and blazing-fast performance.

---

📦 Installation

Install the package via npm or yarn:

``bash


Using npm

npm install time-humanizer

Using yarn

yarn add time-humanizer

Using pnpm

pnpm add time-humanizer

Using bun

bun add time-humanizer
`

📜 License

This project is licensed under the MIT License

🙌 Contributing

Contributions are welcome! Please check out our Contributing Guide for more details.

1. Fork the repo.
2. Create your feature branch: git checkout -b feature/amazing-feature.
3. Commit your changes: git commit -m "Add some amazing feature".
4. Push to the branch: git push origin feature/amazing-feature.
5. Open a pull request.

📖 Usage

Time Humanizer provides a simple API for humanizing time durations:

Example

`ts
import { humanizeDuration } from 'time-humanizer';

// Past durations
console.log(humanizeDuration(-60000)); // Output: "1 minute ago"

// Future durations
console.log(humanizeDuration(3600000)); // Output: "in 1 hour"

// Custom thresholds
console.log(humanizeDuration(900000, { threshold: 15 })); // Output: "15 minutes ago"
`

⚙️ API

`ts
humanizeDuration(duration: number, options?: HumanizerOptions): string
``

Parameters:
• duration: Time in milliseconds (negative for past, positive for future).
• options (optional):
• threshold (number): Adjusts precision for output.
• locale (string): Language to display (default: en).
• format (string): Customize time string format.