datetime-parse Edge Function — Utilities

datetime-parse — Parse date strings to Unix timestamps

Normalise any date string or unix timestamp into a reliable millisecond timestamp and ISO string.

---

API

POST /api/datetime-parse

Request body

Field	Type	Required	Default	Description
value	string | number	✅	—	Date string or unix timestamp (s or ms)
options.assumeUtc	boolean	❌	true	Treat date-only strings as UTC

Supported formats

• ISO 8601: 2024-01-15T10:30:45Z, 2024-01-15T10:30:45+05:30
• Date-only: 2024-01-15
• US slash: 01/15/2024
• Unix seconds: 1705315845 (< 10 digits → multiplied by 1000)
• Unix milliseconds: 1705315845000

Success response (200)

{
  "success": true,
  "data": {
    "timestamp": 1705315845000,
    "iso": "2024-01-15T10:30:45.000Z",
    "valid": true
  }
}

Error responses

Code	HTTP	When
INVALID_INPUT	400	Missing value field
INTERNAL_ERROR	500	Unexpected error

---

Usage

cURL

curl -X POST "$FUNCTION_URL" \
  -H "Content-Type: application/json" \
  -d '{"value": "01/15/2024"}'

Direct import (Node / Bun / Deno)

import { datetimeParse } from '@aerostack/functions/datetime-parse';

const result = datetimeParse({ value: '2024-01-15' });
if (result.valid) {
  console.log(result.timestamp); // 1705276800000
}

---

Use Cases

• Normalising date inputs from forms or APIs before storing in a database
• Converting unix seconds from external APIs to ms for JavaScript Date
• Validating whether user-provided date strings are parseable