@jdsalasc/solvejs-date

Zero-dependency date utilities for JavaScript and TypeScript.

Utilities

• formatDate, toIsoDate
• parseDateStrict, parseIsoDate, parseUnixTimestamp
• parseDateMany, parseDateOrThrow
• addDays, diffInDays
• startOfDay, endOfDay
• isLeapYear, daysInMonth
• toUtcOffset, formatInUtcOffset, convertUtcOffset
• Enums: DateFormat, DateParseFormat, UtcOffset

When to use this package

Use it when you need predictable date parsing/formatting, UTC-safe operations, and common date math without adding heavy dependencies.

Limitations and Constraints

• Formatting tokens are intentionally limited to a small practical set.
• Helpers operate in UTC-safe mode and avoid locale-calendar formatting features.
• For advanced timezone rules per region, integrate a dedicated timezone library.

Install

npm i @jdsalasc/solvejs-date

Quick example

import {
  DateFormat,
  DateParseFormat,
  UtcOffset,
  addDays,
  convertUtcOffset,
  formatInUtcOffset,
  parseDateOrThrow,
  toIsoDate
} from "@jdsalasc/solvejs-date";

const d = parseDateOrThrow("07/02/2026", [DateParseFormat.DAY_MONTH_YEAR_SLASH]);
const next = addDays(d!, 3);
toIsoDate(next); // "2026-02-10"

const instant = new Date("2026-02-07T15:00:00.000Z");
formatInUtcOffset(instant, UtcOffset.UTC_MINUS_05, DateFormat.YYYY_MM_DD_HH_MM_SS); // "2026-02-07 10:00:00"

const wallClockInMinusFive = new Date("2026-02-07T10:00:00.000Z");
convertUtcOffset(wallClockInMinusFive, UtcOffset.UTC_MINUS_05, UtcOffset.UTC_PLUS_01); // 16:00 wall-clock