simple-date-utils

A lightweight, zero-dependency utility library for date formatting and manipulation in JavaScript.

Installation

npm install simple-date-utils-by-f1r09

Usage

const DateUtils = require('simple-date-utils-by-f1r09');

// Format dates
DateUtils.format(new Date(), 'YYYY-MM-DD'); // "2025-11-27"
DateUtils.format(new Date(), 'DD/MM/YYYY HH:mm'); // "27/11/2025 14:30"

// Manipulate dates
const tomorrow = DateUtils.addDays(new Date(), 1);
const nextMonth = DateUtils.addMonths(new Date(), 1);

// Compare dates
DateUtils.diffInDays('2025-01-01', '2025-01-10'); // 9
DateUtils.isToday(new Date()); // true
DateUtils.isPast('2024-01-01'); // true

// Relative time
DateUtils.timeAgo(new Date(Date.now() - 3600000)); // "1 hours ago"

// Get day/month names
DateUtils.getDayName(new Date()); // "Wednesday"
DateUtils.getMonthName(new Date()); // "November"

// Start/end of day
DateUtils.startOfDay(new Date()); // Today at 00:00:00
DateUtils.endOfDay(new Date()); // Today at 23:59:59

// Leap year check
DateUtils.isLeapYear(2024); // true

API

format(date, format)

Format a date according to a pattern. Tokens: YYYY, MM, DD, HH, mm, ss

addDays(date, days)

Add or subtract days from a date

addMonths(date, months)

Add or subtract months from a date

diffInDays(date1, date2)

Calculate difference between two dates in days

isToday(date) / isPast(date) / isFuture(date)

Check date status

timeAgo(date)

Get human-readable relative time string

startOfDay(date) / endOfDay(date)

Get start or end of a day

getDayName(date) / getMonthName(date)

Get day or month name

isLeapYear(year)

Check if a year is a leap year

License

MIT