time-ago-dk

A tiny JavaScript utility to convert dates into human readable "time ago" format.

Features

Lightweight and fast
Supports years, months, days, hours, minutes, and seconds
Returns "just now" for very recent times
ES module and CommonJS compatible

Installation

npm install time-ago-dk

Usage

ES Modules

import { timeAgo } from "time-ago-dk";

console.log(timeAgo(new Date(Date.now() - 60000))); // "1 minute ago"
console.log(timeAgo(new Date(Date.now() - 3600000))); // "1 hour ago"
console.log(timeAgo(new Date(Date.now() - 1000))); // "just now"
console.log(timeAgo(new Date(Date.now() - 86400000))); // "1 day ago"
console.log(timeAgo(new Date(Date.now() - 2592000000))); // "1 month ago"
console.log(timeAgo(new Date(Date.now() - 31536000000))); // "1 year ago"

CommonJS

const { timeAgo } = require("time-ago-dk");

console.log(timeAgo(new Date(Date.now() - 60000))); // "1 minute ago"
console.log(timeAgo(new Date(Date.now() - 3600000))); // "1 hour ago"
console.log(timeAgo(new Date(Date.now() - 1000))); // "just now"
console.log(timeAgo(new Date(Date.now() - 86400000))); // "1 day ago"
console.log(timeAgo(new Date(Date.now() - 2592000000))); // "1 month ago"
console.log(timeAgo(new Date(Date.now() - 31536000000))); // "1 year ago"

API

`timeAgo(inputDate)`

Parameters:
- inputDate (Date | string | number): The date to convert. Can be a Date object, ISO string, or timestamp.
Returns: string - The human-readable time ago string.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.