feat(date): add date time format

Author: adaptive-shield-matrix

src/date/dateTimeFormat.test.ts

@@ -0,0 +1,47 @@
+import { describe, expect, test } from "bun:test"
+import {
+  dateTimeFormat,
+  formatDateTimeFull,
+  formatDateTimeIso
+} from "./dateTimeFormat"
+import { dateTimeFormatStyle } from "./dateTimeFormatStyle"
+
+describe("dateTimeFormat", () => {
+  const testDate = new Date("2023-12-25T10:30:45.000Z")
+
+  test("formats date with iso format", () => {
+    const result = dateTimeFormat(testDate, dateTimeFormatStyle.iso)
+    expect(result).toBe("2023-12-25 10:30:45")
+  })
+
+  test("formats date with full format", () => {
+    const result = dateTimeFormat(testDate, dateTimeFormatStyle.full, "en-US")
+    expect(result).toContain("December")
+    expect(result).toContain("2023")
+    expect(result).toContain("10:30")
+  })
+
+  test("formats date time full", () => {
+    const result = formatDateTimeFull(testDate, "en-US")
+    expect(result).toContain("December")
+    expect(result).toContain("2023")
+    expect(result).toContain("10:30")
+  })
+
+  test("formats date time iso", () => {
+    const result = formatDateTimeIso(testDate)
+    expect(result).toBe("2023-12-25 10:30:45")
+  })
+
+  test("formats date time full with string input", () => {
+    const result = formatDateTimeFull("2023-12-25T10:30:45.000Z", "en-US")
+    expect(result).toContain("December")
+    expect(result).toContain("2023")
+    expect(result).toContain("10:30")
+  })
+
+  test("formats date time iso with string input", () => {
+    const result = formatDateTimeIso("2023-12-25T10:30:45.000Z")
+    expect(result).toBe("2023-12-25 10:30:45")
+  })
+})

src/date/dateTimeFormat.ts

@@ -0,0 +1,15 @@
+import { dateTimeFormatStyle, type DateTimeFormatStyle } from "~utils/date/dateTimeFormatStyle"
+import { dateTimeFormatterGetCached } from "./dateTimeFormatterGetCached"
+
+export function dateTimeFormat(date: Date|string, format: DateTimeFormatStyle, l?: string) {
+  const formatter = dateTimeFormatterGetCached(format, l)
+  return formatter.format(typeof date === "string" ? new Date(date) : date)
+}
+
+export function formatDateTimeFull(date: Date | string, l?: string) {
+  return dateTimeFormat(typeof date === "string" ? new Date(date) : date, dateTimeFormatStyle.full, l)
+}
+
+export function formatDateTimeIso(date: Date | string, l?: string) {
+  return dateTimeFormat(typeof date === "string" ? new Date(date) : date, dateTimeFormatStyle.iso, l)
+}

src/date/dateTimeFormatStyle.ts

@@ -0,0 +1,10 @@
+import * as v from "valibot"
+
+export type DateTimeFormatStyle = keyof typeof dateTimeFormatStyle
+
+export const dateTimeFormatStyle = {
+  iso: "iso",
+  full: "full",
+} as const
+
+export const dateTimeFormatStyleSchema = v.enum(dateTimeFormatStyle)

src/date/dateTimeFormatterCreate.ts

@@ -0,0 +1,21 @@
+import { type DateTimeFormatStyle, dateTimeFormatStyle } from "~utils/date/dateTimeFormatStyle"
+
+export function dateTimeFormatterCreate(format: DateTimeFormatStyle, l?: string): Intl.DateTimeFormat {
+  if (format === dateTimeFormatStyle.iso) {
+    return new Intl.DateTimeFormat("sv-SE", {
+      // date
+      year: "numeric",
+      month: "numeric",
+      day: "numeric",
+      // time
+      hour: "numeric",
+      minute: "numeric",
+      second: "numeric",
+      // timeZoneName: "short",
+    })
+  }
+  return new Intl.DateTimeFormat(l, {
+    dateStyle: "full",
+    timeStyle: "long",
+  })
+}

src/date/dateTimeFormatterGetCached.ts

@@ -0,0 +1,15 @@
+import { dateTimeFormatterCreate } from "~utils/date/dateTimeFormatterCreate"
+import { type DateTimeFormatStyle } from "./dateTimeFormatStyle"
+
+let cachedLocale: string | undefined = undefined
+let cachedFormat: DateTimeFormatStyle | undefined = undefined
+let cachedFormatter: Intl.DateTimeFormat | undefined = undefined
+
+export function dateTimeFormatterGetCached(format: DateTimeFormatStyle, l?: string): Intl.DateTimeFormat {
+  if (!cachedFormatter || cachedLocale !== l || cachedFormat !== format) {
+    cachedLocale = l
+    cachedFormat = format
+    cachedFormatter = dateTimeFormatterCreate(format, l)
+  }
+  return cachedFormatter
+}