beauty-date-utils

A lightweight, zero-dependency JavaScript date utility library for real-world applications like dashboards, forms, calendars, and APIs.

It provides simple helpers for date manipulation, formatting, comparison, validation, and time calculations.

📦 Installation

npm install beauty-date-utils

Usage

import { formatDayMonthYear } from "beauty-date-utils";
const result = formatDayMonthYear("2026-04-12");
console.log(result); //12/04/2026

import { formatYearMonthDay } from "beauty-date-utils";
const result = formatYearMonthDay("2026-04-12T10:30:00");
console.log(result); // 2026-04-12

import { formatMonthDayYear } from "beauty-date-utils";
const result = formatMonthDayYear("2026-04-12T10:30:00");
console.log(result); //04/12/2026

import { addDays } from "beauty-date-utils";
const result = addDays("2026-04-12", 5);
console.log(formatDate(result, "YYYY-MM-DD")); //2026-04-17

import { differenceInHours } from "beauty-date-utils";
const hours = differenceInHours("2026-04-12T10:00:00", "2026-04-12T15:30:00");

import { isWeekday } from "beauty-date-utils";
const result1 = isWeekday(new Date("2026-04-13"));
console.log(result1); // true

import { startOfDay } from "beauty-date-utils";
const result = startOfDay("2026-04-12 15:45:30");
console.log(result); //Sun Apr 12 2026 00:00:00 GMT+0600

import { startOfMonth } from "beauty-date-utils";
const result = startOfMonth("2026-04-12");
console.log(result); // Wed Apr 01 2026 00:00:00 GMT+0600

import { endOfYear } from "beauty-date-utils";
const result = endOfYear("2026-04-12");
console.log(result); //Thu Dec 31 2026 00:00:00 GMT+0600

Add or subtract time from a date.

addDays(date, days);
addWeeks(date, weeks);
addMonths(date, months);
subtractDays(date, days);
subtractWeeks(date, weeks);

Difference Calculations

differenceInDays(date1, date2);
differenceInHours(date1, date2);
differenceInMinutes(date1, date2);
differenceInSeconds(date1, date2);
differenceInMonths(date1, date2);

Start & End of Time Units

startOfDay(date);
endOfDay(date);
startOfMonth(date);
endOfMonth(date);
startOfYear(date);
endOfYear(date);
getWeekStart(date);
getWeekEnd(date);

Formatting Utilities

formatDate(date, format);
formatISO(date);
formatTimeOnly(date);

Validation & Comparison

isValidDate(date);
isBefore(date1, date2);
isAfter(date1, date2);
isEqual(date1, date2);
isSameDay(date1, date2);
isWeekend(date);
isWeekday(date);

Utility Helpers

cloneDate(date);
parseDate(dateString);
fromTimestamp(timestamp);
toTimestamp(date);
getTime(date);
getNowDate();
getToday();
getTomorrow();
getYesterday();