@zag-js/i18n-utils 1.33.0 → 1.34.0

package/dist/index.d.mts

@@ -53,6 +53,18 @@ declare function formatNumber(v: number, locale: string, options?: Intl.NumberFo
 
 declare function formatRelativeTime(value: Date, locale: string, options?: Intl.RelativeTimeFormatOptions): string;
 
+type TimeFormat = "12h" | "24h";
+interface AmPmLabels {
+    am: string;
+    pm: string;
+}
+interface FormatTimeOptions {
+    format?: TimeFormat;
+    amPmLabels?: AmPmLabels;
+    withSeconds?: boolean;
+}
+declare function formatTime(value: string | Date, locale: string, options?: FormatTimeOptions): string | null;
+
 declare function isRTL(locale: string): boolean;
 declare function getLocaleDir(locale: string): "rtl" | "ltr";
 
@@ -75,4 +87,4 @@ interface LocaleOptions {
 }
 declare function trackLocale(options?: LocaleOptions): () => void;
 
-export { type FilterOptions, type FilterReturn, type FormatBytesOptions, type Locale, type LocaleOptions, createCollator, createFilter, formatBytes, formatDate, formatList, formatNumber, formatRelativeTime, getDefaultLocale, getLocaleDir, isRTL, trackLocale };
+export { type AmPmLabels, type FilterOptions, type FilterReturn, type FormatBytesOptions, type FormatTimeOptions, type Locale, type LocaleOptions, type TimeFormat, createCollator, createFilter, formatBytes, formatDate, formatList, formatNumber, formatRelativeTime, formatTime, getDefaultLocale, getLocaleDir, isRTL, trackLocale };

package/dist/index.d.ts

@@ -53,6 +53,18 @@ declare function formatNumber(v: number, locale: string, options?: Intl.NumberFo
 
 declare function formatRelativeTime(value: Date, locale: string, options?: Intl.RelativeTimeFormatOptions): string;
 
+type TimeFormat = "12h" | "24h";
+interface AmPmLabels {
+    am: string;
+    pm: string;
+}
+interface FormatTimeOptions {
+    format?: TimeFormat;
+    amPmLabels?: AmPmLabels;
+    withSeconds?: boolean;
+}
+declare function formatTime(value: string | Date, locale: string, options?: FormatTimeOptions): string | null;
+
 declare function isRTL(locale: string): boolean;
 declare function getLocaleDir(locale: string): "rtl" | "ltr";
 
@@ -75,4 +87,4 @@ interface LocaleOptions {
 }
 declare function trackLocale(options?: LocaleOptions): () => void;
 
-export { type FilterOptions, type FilterReturn, type FormatBytesOptions, type Locale, type LocaleOptions, createCollator, createFilter, formatBytes, formatDate, formatList, formatNumber, formatRelativeTime, getDefaultLocale, getLocaleDir, isRTL, trackLocale };
+export { type AmPmLabels, type FilterOptions, type FilterReturn, type FormatBytesOptions, type FormatTimeOptions, type Locale, type LocaleOptions, type TimeFormat, createCollator, createFilter, formatBytes, formatDate, formatList, formatNumber, formatRelativeTime, formatTime, getDefaultLocale, getLocaleDir, isRTL, trackLocale };

package/dist/index.js

@@ -379,6 +379,55 @@ function getDistance(startDate, endDate) {
   };
 }
 
+// src/format-time.ts
+var getTimeFormatter = i18nCache(Intl.DateTimeFormat);
+function splitTimeString(timeString) {
+  const [hours = null, minutes = null, seconds = null] = timeString.split(":");
+  const parsedHours = hours === null ? null : Number(hours);
+  const parsedMinutes = minutes === null ? null : Number(minutes);
+  const parsedSeconds = seconds === null ? null : Number(seconds);
+  return {
+    hours: Number.isNaN(parsedHours) ? null : parsedHours,
+    minutes: Number.isNaN(parsedMinutes) ? null : parsedMinutes,
+    seconds: Number.isNaN(parsedSeconds) ? null : parsedSeconds
+  };
+}
+function getTimeParts(value) {
+  if (value instanceof Date) {
+    if (Number.isNaN(value.getTime())) return null;
+    return {
+      date: value,
+      hours: value.getHours(),
+      minutes: value.getMinutes(),
+      seconds: value.getSeconds()
+    };
+  }
+  const { hours, minutes, seconds } = splitTimeString(value);
+  if (hours === null || minutes === null) return null;
+  if (hours < 0 || hours > 23 || minutes < 0 || minutes > 59) return null;
+  if (seconds !== null && (seconds < 0 || seconds > 59)) return null;
+  const date = /* @__PURE__ */ new Date(0);
+  date.setHours(hours, minutes, seconds ?? 0, 0);
+  return { date, hours, minutes, seconds: seconds ?? 0 };
+}
+function formatTime(value, locale, options = {}) {
+  const { format = "24h", amPmLabels, withSeconds = false } = options;
+  const parts = getTimeParts(value);
+  if (!parts) return null;
+  const formatter = getTimeFormatter(locale, {
+    hour: format === "24h" ? "2-digit" : "numeric",
+    minute: "2-digit",
+    second: withSeconds ? "2-digit" : void 0,
+    hour12: format === "12h"
+  });
+  if (format !== "12h" || !amPmLabels) {
+    return formatter.format(parts.date);
+  }
+  const isPm = parts.hours >= 12;
+  const tokens = formatter.formatToParts(parts.date);
+  return tokens.map((token) => token.type === "dayPeriod" ? isPm ? amPmLabels.pm : amPmLabels.am : token.value).join("");
+}
+
 // src/is-rtl.ts
 var RTL_SCRIPTS = /* @__PURE__ */ new Set([
   "Avst",
@@ -455,6 +504,7 @@ exports.formatDate = formatDate;
 exports.formatList = formatList;
 exports.formatNumber = formatNumber;
 exports.formatRelativeTime = formatRelativeTime;
+exports.formatTime = formatTime;
 exports.getDefaultLocale = getDefaultLocale;
 exports.getLocaleDir = getLocaleDir;
 exports.isRTL = isRTL;

package/dist/index.mjs

@@ -377,6 +377,55 @@ function getDistance(startDate, endDate) {
   };
 }
 
+// src/format-time.ts
+var getTimeFormatter = i18nCache(Intl.DateTimeFormat);
+function splitTimeString(timeString) {
+  const [hours = null, minutes = null, seconds = null] = timeString.split(":");
+  const parsedHours = hours === null ? null : Number(hours);
+  const parsedMinutes = minutes === null ? null : Number(minutes);
+  const parsedSeconds = seconds === null ? null : Number(seconds);
+  return {
+    hours: Number.isNaN(parsedHours) ? null : parsedHours,
+    minutes: Number.isNaN(parsedMinutes) ? null : parsedMinutes,
+    seconds: Number.isNaN(parsedSeconds) ? null : parsedSeconds
+  };
+}
+function getTimeParts(value) {
+  if (value instanceof Date) {
+    if (Number.isNaN(value.getTime())) return null;
+    return {
+      date: value,
+      hours: value.getHours(),
+      minutes: value.getMinutes(),
+      seconds: value.getSeconds()
+    };
+  }
+  const { hours, minutes, seconds } = splitTimeString(value);
+  if (hours === null || minutes === null) return null;
+  if (hours < 0 || hours > 23 || minutes < 0 || minutes > 59) return null;
+  if (seconds !== null && (seconds < 0 || seconds > 59)) return null;
+  const date = /* @__PURE__ */ new Date(0);
+  date.setHours(hours, minutes, seconds ?? 0, 0);
+  return { date, hours, minutes, seconds: seconds ?? 0 };
+}
+function formatTime(value, locale, options = {}) {
+  const { format = "24h", amPmLabels, withSeconds = false } = options;
+  const parts = getTimeParts(value);
+  if (!parts) return null;
+  const formatter = getTimeFormatter(locale, {
+    hour: format === "24h" ? "2-digit" : "numeric",
+    minute: "2-digit",
+    second: withSeconds ? "2-digit" : void 0,
+    hour12: format === "12h"
+  });
+  if (format !== "12h" || !amPmLabels) {
+    return formatter.format(parts.date);
+  }
+  const isPm = parts.hours >= 12;
+  const tokens = formatter.formatToParts(parts.date);
+  return tokens.map((token) => token.type === "dayPeriod" ? isPm ? amPmLabels.pm : amPmLabels.am : token.value).join("");
+}
+
 // src/is-rtl.ts
 var RTL_SCRIPTS = /* @__PURE__ */ new Set([
   "Avst",
@@ -446,4 +495,4 @@ function trackLocale(options = {}) {
   };
 }
 
-export { createCollator, createFilter, formatBytes, formatDate, formatList, formatNumber, formatRelativeTime, getDefaultLocale, getLocaleDir, isRTL, trackLocale };
+export { createCollator, createFilter, formatBytes, formatDate, formatList, formatNumber, formatRelativeTime, formatTime, getDefaultLocale, getLocaleDir, isRTL, trackLocale };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zag-js/i18n-utils",
-  "version": "1.33.0",
+  "version": "1.34.0",
   "description": "Interationalization utilities for Zag.js",
   "keywords": [
     "js",
@@ -24,7 +24,7 @@
   },
   "clean-package": "../../../clean-package.config.json",
   "dependencies": {
-    "@zag-js/dom-query": "1.33.0"
+    "@zag-js/dom-query": "1.34.0"
   },
   "devDependencies": {
     "clean-package": "2.2.0",