easydev-date-format

A simple, lightweight, and React-compatible date formatting utility.
This package includes both ES Module (index.js) and CommonJS (dist/index.cjs) entry points so it should work with most bundlers and Node versions.

Installation

npm install ray-date-time-format
# or
yarn add ray-date-time-format

Usage (React / JavaScript)

ESM (recommended — supported by modern bundlers)

import { formatDate, timeAgo } from "ray-date-time-format";

console.log(formatDate("2025-11-11T08:25:00Z", "dd/mm/yyyy")); // "11/11/2025"
console.log(timeAgo("2025-11-11T08:25:00Z")); // "2h ago"

CommonJS (Node or older setups)

const { formatDate, timeAgo } = require("ray-date-time-format");

console.log(formatDate("2025-11-11T08:25:00Z", "dd/mm/yyyy"));
console.log(timeAgo("2025-11-11T08:25:00Z"));

Supported formats for formatDate(dateInput, format)

• dd/mm/yyyy
• mm/dd/yyyy
• yyyy/mm/dd
• dd-mm-yyyy
• yyyy (only year)
• mm (only month)
• dd (only day)
• time (hh:mm:ss)
• default: date.toLocaleString()

Functions

formatDate(dateInput, format = "dd/mm/yyyy")

• dateInput: Date object, ISO string, or timestamp
• format: format string (see supported formats)

timeAgo(dateInput)

• Returns relative time like 5s ago, 10min ago, 3h ago, 2d ago, 6mo ago, 1y ago.

Files included

• index.js — ES Module entry (use with import)
• dist/index.cjs — CommonJS entry (use with require)
• README.md — this file
• package.json — npm package info

Example React component

import React from "react";
import { formatDate, timeAgo } from "ray-date-time-format";

export default function Demo() {
  const backendDate = "2025-11-11T08:25:00Z";
  return (
    <div>
      <p>Original: {backendDate}</p>
      <p>Formatted: {formatDate(backendDate, "dd/mm/yyyy")}</p>
      <p>Time ago: {timeAgo(backendDate)}</p>
    </div>
  );
}

Notes

• If your bundler reports issues about modules, use the ESM import form (index.js) or the CJS require form (dist/index.cjs).
• This is intentionally dependency-free and simple. For advanced localization/timezone features consider date-fns or luxon.

License

MIT