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.