time-ago-formatter

A lightweight JavaScript/Node.js library to format timestamps into human-readable relative time (e.g., "5 minutes ago", "2 hours ago", "Yesterday").

Installation

Install via npm:

npm install time-ago-formatter

Or via yarn:

yarn add time-ago-formatter

---

Usage

Import the Package

const timeAgo = require("time-ago-formatter");

Basic Usage

console.log(timeAgo(Date.now() - 60000));   // "1 minute ago"
console.log(timeAgo(Date.now() - 3600000)); // "1 hour ago"
console.log(timeAgo(Date.now() - 86400000)); // "1 day ago"
console.log(timeAgo("2023-12-01"));         // "2 months ago"

---

API Reference

timeAgo(input)

Formats a timestamp into a compact, human-readable relative time string.

Parameter	Type	Description
input	Date / String / Number	The date or timestamp to format

---

License

This package is licensed under the MIT License.

---

Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.

---

Author

Developed by Rohit Chavan.