datetime-format Edge Function — Utilities

datetime-format — Format dates using format tokens

Format any date or timestamp into a human-readable string using pattern tokens, with full timezone support.

---

API

POST /api/datetime-format

Request body

Field	Type	Required	Default	Description
date	string | number	✅	—	ISO date string or Unix ms timestamp
format	string	✅	—	Format pattern using tokens below
options.timezone	string	❌	'UTC'	IANA timezone name

Format tokens

Token	Output	Example
YYYY	4-digit year	2024
MM	2-digit month	01
DD	2-digit day	15
HH	24h hours	14
mm	Minutes	30
ss	Seconds	45
ddd	Short weekday	Mon
dddd	Full weekday	Monday
MMM	Short month	Jan
MMMM	Full month	January

Success response (200)

{
  "success": true,
  "data": {
    "formatted": "2024-01-15 10:30:45",
    "timestamp": 1705315845000,
    "timezone": "UTC"
  }
}

Error responses

Code	HTTP	When
INVALID_INPUT	400	Missing required field
INTERNAL_ERROR	500	Invalid date or timezone

---

Usage

cURL

curl -X POST "$FUNCTION_URL" \
  -H "Content-Type: application/json" \
  -d '{"date": "2024-01-15T10:30:45Z", "format": "MMMM DD, YYYY"}'

TypeScript / JavaScript (HTTP)

const response = await fetch(FUNCTION_URL, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    date: Date.now(),
    format: 'YYYY-MM-DD HH:mm:ss',
    options: { timezone: 'America/New_York' }
  }),
});
const { data } = await response.json();
console.log(data.formatted); // "2024-01-15 05:30:45"

Direct import (Node / Bun / Deno)

import { datetimeFormat } from '@aerostack/functions/datetime-format';

const result = datetimeFormat({
  date: '2024-01-15T10:30:45Z',
  format: 'dddd, MMMM DD YYYY',
});
console.log(result.formatted); // "Monday, January 15 2024"

---

Use Cases

• Displaying user-facing dates in localised formats per timezone
• Generating date-stamped filenames (e.g. report-2024-01-15.csv)
• Formatting timestamps for logs, notifications, or receipts