@atom-forge/date-format

Lightweight, token-based date formatting utility built on Intl.DateTimeFormat.

Installation

bun add @atom-forge/date-format

Usage

import { dateFormat } from "@atom-forge/date-format";

dateFormat("%Y-%M-%D")               // "2026-04-07"
dateFormat("$M %D, %Y")             // "April 07, 2026"
dateFormat("%H:%I:%S")               // "14:05:03"
dateFormat("%D $M %Y", "2024-12-24") // "24 Dec 2024"
dateFormat("%Y", new Date(), "hu-HU") // "2026"
dateFormat("%H:%I", new Date(), "en-GB", "America/New_York") // "08:05"

Signature

function dateFormat(
  format: string,
  date?: Date | string,   // default: now
  lang?: string,          // default: "en-GB"
  timeZone?: string       // optional, e.g. "Europe/Budapest"
): string

Tokens

Numeric

| Token | Description | Example | |-------|---------------------|---------| | %Y | Year, full | 2026 | | %y | Year, 2-digit | 26 | | %m | Month, numeric | 4 | | %M | Month, 2-digit | 04 | | %d | Day, numeric | 7 | | %D | Day, 2-digit | 07 | | %h | Hour, 24h numeric | 9 | | %H | Hour, 24h 2-digit | 09 | | %g | Hour, 12h numeric | 9 | | %G | Hour, 12h 2-digit | 09 | | %i | Minute, numeric | 5 | | %I | Minute, 2-digit | 05 | | %s | Second, numeric | 3 | | %S | Second, 2-digit | 03 |

Text

| Token | Description | Example | |-------|--------------------|---------------------------| | $m | Month, short | Apr | | $M | Month, long | April | | $d | Weekday, narrow | T | | $w | Weekday, short | Tue | | $D | Weekday, long | Tuesday | | $W | Weekday, long | Tuesday | | $p | AM/PM, short | am | | $P | AM/PM, long | in the morning | | $z | Timezone, short | CET | | $Z | Timezone, long | Central European Time |