@northguild/gmt 1.18.0 → 1.20.0

package/dist/plain/format/formatDateRange.d.ts

@@ -24,10 +24,10 @@ import type { DateTimeFormatOptions } from "../../types/index.js";
  * @param options optional Intl.DateTimeFormatOptions
  * @returns localized range string or "" when invalid
  *
- * @example formatDateRange("2024-02-03", "2024-02-05", "en-US", { dateStyle: "long" }) // "February 3 - 5, 2024"
- * @example formatDateRange("2024-02-03", "2024-06-10", "en-US", { dateStyle: "long" }) // "February 3 - June 10, 2024"
- * @example formatDateRange("2024-02-03", "2024-02-05", "en-US", { timeZoneName: "short" }) // "2/3/2024 - 2/5/2024"
- * @example formatDateRange("invalid", "2024-02-05", "en-US") // "" (invalid input)
+ * @example formatDateRange("2024-02-03", "2024-02-05", "en-GB", { dateStyle: "long" }) // "3 - 5 February 2024"
+ * @example formatDateRange("2024-02-03", "2024-06-10", "pt-BR", { dateStyle: "long" }) // "3 de fevereiro - 10 de junho de 2024"
+ * @example formatDateRange("2024-02-03", "2024-02-05", "hi-IN", { timeZoneName: "short" }) // "3/2/2024 - 5/2/2024"
+ * @example formatDateRange("invalid", "2024-02-05", "ja-JP") // "" (invalid input)
  * @example formatDateRange("2024-02-03", "2024-02-05", ["fr-FR", "en-US"], { dateStyle: "long" }) // "3-5 février 2024" (GMT writes range dashes as ASCII hyphens)
  */
 export declare function formatDateRange(start: string, end: string, locale?: string | string[], options?: DateTimeFormatOptions): string;

package/dist/plain/format/formatDateRange.js

@@ -1,8 +1,9 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { normalizeDateTime } from "../../internal/index.js";
 import { plainDateFormatOptions } from "../../internal/plainFormatOptions.js";
 import { isValidDate } from "../validate/index.js";
 import { readDateTimeFormatOptions } from "../../internal/readDateTimeFormatOptions.js";
+import { cachedFormatter, checkFormatterArguments, } from "../../internal/formatterCache.js";
 /**
  * Format a plain date range using the Temporal Intl.DateTimeFormat formatRange API.
  *
@@ -28,10 +29,10 @@ import { readDateTimeFormatOptions } from "../../internal/readDateTimeFormatOpti
  * @param options optional Intl.DateTimeFormatOptions
  * @returns localized range string or "" when invalid
  *
- * @example formatDateRange("2024-02-03", "2024-02-05", "en-US", { dateStyle: "long" }) // "February 3 - 5, 2024"
- * @example formatDateRange("2024-02-03", "2024-06-10", "en-US", { dateStyle: "long" }) // "February 3 - June 10, 2024"
- * @example formatDateRange("2024-02-03", "2024-02-05", "en-US", { timeZoneName: "short" }) // "2/3/2024 - 2/5/2024"
- * @example formatDateRange("invalid", "2024-02-05", "en-US") // "" (invalid input)
+ * @example formatDateRange("2024-02-03", "2024-02-05", "en-GB", { dateStyle: "long" }) // "3 - 5 February 2024"
+ * @example formatDateRange("2024-02-03", "2024-06-10", "pt-BR", { dateStyle: "long" }) // "3 de fevereiro - 10 de junho de 2024"
+ * @example formatDateRange("2024-02-03", "2024-02-05", "hi-IN", { timeZoneName: "short" }) // "3/2/2024 - 5/2/2024"
+ * @example formatDateRange("invalid", "2024-02-05", "ja-JP") // "" (invalid input)
  * @example formatDateRange("2024-02-03", "2024-02-05", ["fr-FR", "en-US"], { dateStyle: "long" }) // "3-5 février 2024" (GMT writes range dashes as ASCII hyphens)
  */
 export function formatDateRange(start, end, locale, options) {
@@ -45,12 +46,12 @@ export function formatDateRange(start, end, locale, options) {
         // caller's options first surfaces the TypeError or RangeError
         // Intl.DateTimeFormat raises for invalid ones.
         const read = readDateTimeFormatOptions(options);
-        new Intl.DateTimeFormat(locale, read);
+        checkFormatterArguments("DateTimeFormat", locale, read);
         const resolved = plainDateFormatOptions(read);
         if (resolved === null) {
             return "";
         }
-        const out = new Intl.DateTimeFormat(locale, resolved).formatRange(Temporal.PlainDate.from(start).toZonedDateTime("UTC").epochMilliseconds, Temporal.PlainDate.from(end).toZonedDateTime("UTC").epochMilliseconds);
+        const out = cachedFormatter("DateTimeFormat", locale, resolved).formatRange(Temporal.PlainDate.from(start).toZonedDateTime("UTC").epochMilliseconds, Temporal.PlainDate.from(end).toZonedDateTime("UTC").epochMilliseconds);
         return normalizeDateTime(out);
     }
     catch {

package/dist/plain/format/formatDateTime.d.ts

@@ -23,13 +23,13 @@ import type { DateTimeFormatOptions } from "../../types/index.js";
  * @param options optional Intl.DateTimeFormatOptions
  * @returns localized date-time string or "" on invalid input
  *
- * @example formatDateTime("2024-03-15T14:30:00", "en-US", { dateStyle: "medium", timeStyle: "short" }) // "Mar 15, 2024, 2:30 PM"
- * @example formatDateTime("2024-03-15T14:30:00", "en-US", { dateStyle: "long", timeStyle: "short" }) // "March 15, 2024 at 2:30 PM"
+ * @example formatDateTime("2024-03-15T14:30:00", "en-GB", { dateStyle: "medium", timeStyle: "short" }) // "15 Mar 2024, 14:30"
+ * @example formatDateTime("2024-03-15T14:30:00", "ja-JP", { dateStyle: "long", timeStyle: "short" }) // "2024年3月15日 14:30"
  * @example formatDateTime("2024-03-15T14:30:00", "de-DE", { dateStyle: "medium", timeStyle: "short" }) // "15.03.2024, 14:30"
  * @example formatDateTime("2024-02-03T14:30:45", "en-US", { dateStyle: "short", timeStyle: "full" }) // "2/3/24, 2:30:45 PM"
  * @example formatDateTime("2024-02-03T14:30:45", "en-US", { year: "numeric", month: "numeric", day: "numeric", hour: "numeric", minute: "numeric", second: "numeric" }) // "2/3/2024, 2:30:45 PM" — the pre-1.16.0 text
- * @example formatDateTime("2024-02-03T14:30:45", "en-US", { era: "long" }) // "2/3/2024 Anno Domini, 2:30:45 PM"
- * @example formatDateTime("2024-02-03T14:30:45", "en-US", { era: "long", year: "numeric", month: "numeric", day: "numeric" }) // "2/3/2024 Anno Domini" — the pre-1.16.0 text
+ * @example formatDateTime("2024-02-03T14:30:45", "en-GB", { era: "long" }) // "03/02/2024 Anno Domini, 14:30:45"
+ * @example formatDateTime("2024-02-03T14:30:45", "en-GB", { era: "long", year: "numeric", month: "numeric", day: "numeric" }) // "03/02/2024 Anno Domini" — the pre-1.16.0 text
  * @example formatDateTime("invalid") // ""
  * @example formatDateTime("2024-02-03T14:30:45", ["fr-FR", "en-US"], { year: "numeric", month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit" }) // "03/02/2024 14:30"
  */

package/dist/plain/format/formatDateTime.js

@@ -1,8 +1,9 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { normalizeDateTime } from "../../internal/index.js";
 import { plainDateTimeFormatOptions } from "../../internal/plainFormatOptions.js";
 import { isValidDateTime } from "../validate/index.js";
 import { readDateTimeFormatOptions } from "../../internal/readDateTimeFormatOptions.js";
+import { cachedFormatter, checkFormatterArguments, } from "../../internal/formatterCache.js";
 /**
  * Return a localized string for a PlainDateTime ISO input using Intl options.
  *
@@ -27,13 +28,13 @@ import { readDateTimeFormatOptions } from "../../internal/readDateTimeFormatOpti
  * @param options optional Intl.DateTimeFormatOptions
  * @returns localized date-time string or "" on invalid input
  *
- * @example formatDateTime("2024-03-15T14:30:00", "en-US", { dateStyle: "medium", timeStyle: "short" }) // "Mar 15, 2024, 2:30 PM"
- * @example formatDateTime("2024-03-15T14:30:00", "en-US", { dateStyle: "long", timeStyle: "short" }) // "March 15, 2024 at 2:30 PM"
+ * @example formatDateTime("2024-03-15T14:30:00", "en-GB", { dateStyle: "medium", timeStyle: "short" }) // "15 Mar 2024, 14:30"
+ * @example formatDateTime("2024-03-15T14:30:00", "ja-JP", { dateStyle: "long", timeStyle: "short" }) // "2024年3月15日 14:30"
  * @example formatDateTime("2024-03-15T14:30:00", "de-DE", { dateStyle: "medium", timeStyle: "short" }) // "15.03.2024, 14:30"
  * @example formatDateTime("2024-02-03T14:30:45", "en-US", { dateStyle: "short", timeStyle: "full" }) // "2/3/24, 2:30:45 PM"
  * @example formatDateTime("2024-02-03T14:30:45", "en-US", { year: "numeric", month: "numeric", day: "numeric", hour: "numeric", minute: "numeric", second: "numeric" }) // "2/3/2024, 2:30:45 PM" — the pre-1.16.0 text
- * @example formatDateTime("2024-02-03T14:30:45", "en-US", { era: "long" }) // "2/3/2024 Anno Domini, 2:30:45 PM"
- * @example formatDateTime("2024-02-03T14:30:45", "en-US", { era: "long", year: "numeric", month: "numeric", day: "numeric" }) // "2/3/2024 Anno Domini" — the pre-1.16.0 text
+ * @example formatDateTime("2024-02-03T14:30:45", "en-GB", { era: "long" }) // "03/02/2024 Anno Domini, 14:30:45"
+ * @example formatDateTime("2024-02-03T14:30:45", "en-GB", { era: "long", year: "numeric", month: "numeric", day: "numeric" }) // "03/02/2024 Anno Domini" — the pre-1.16.0 text
  * @example formatDateTime("invalid") // ""
  * @example formatDateTime("2024-02-03T14:30:45", ["fr-FR", "en-US"], { year: "numeric", month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit" }) // "03/02/2024 14:30"
  */
@@ -49,9 +50,9 @@ export function formatDateTime(value, locale, options) {
         // surfaces the TypeError or RangeError Intl.DateTimeFormat raises for
         // invalid ones.
         const read = readDateTimeFormatOptions(options);
-        new Intl.DateTimeFormat(locale, read);
+        checkFormatterArguments("DateTimeFormat", locale, read);
         const epochMilliseconds = Temporal.PlainDateTime.from(value).toZonedDateTime("UTC").epochMilliseconds;
-        return normalizeDateTime(new Intl.DateTimeFormat(locale, plainDateTimeFormatOptions(read)).format(epochMilliseconds));
+        return normalizeDateTime(cachedFormatter("DateTimeFormat", locale, plainDateTimeFormatOptions(read)).format(epochMilliseconds));
     }
     catch {
         return "";

package/dist/plain/format/formatDateTimeRange.d.ts

@@ -25,12 +25,12 @@ import type { DateTimeFormatOptions } from "../../types/index.js";
  * @param options optional Intl.DateTimeFormatOptions
  * @returns localized range string or "" when invalid
  *
- * @example formatDateTimeRange("2024-02-03T09:00:00", "2024-02-03T17:00:00", "en-US", { dateStyle: "long", timeStyle: "short" }) // "February 3, 2024, 9:00 AM - 5:00 PM"
- * @example formatDateTimeRange("2024-02-03T09:00:00", "2024-02-10T17:00:00", "en-US", { dateStyle: "long", timeStyle: "short" }) // "February 3, 2024 at 9:00 AM - February 10, 2024 at 5:00 PM"
+ * @example formatDateTimeRange("2024-02-03T09:00:00", "2024-02-03T17:00:00", "en-GB", { dateStyle: "long", timeStyle: "short" }) // "3 February 2024, 09:00-17:00"
+ * @example formatDateTimeRange("2024-02-03T09:00:00", "2024-02-10T17:00:00", "pt-BR", { dateStyle: "long", timeStyle: "short" }) // "3 de fevereiro de 2024 às 09:00 - 10 de fevereiro de 2024 às 17:00"
  * @example formatDateTimeRange("2024-02-03T09:00:00", "2024-02-03T17:00:00", "zh-CN", { year: "numeric", month: "long" }) // "2024年2月"
  * @example formatDateTimeRange("2024-02-03T09:00:00", "2024-02-03T17:00:00", "zh-CN", { year: "numeric", month: "numeric" }) // "2024/2" — the pre-1.16.0 text
- * @example formatDateTimeRange("2024-02-03T09:00:00", "2024-02-03T17:00:00", "en-US", { era: "long" }) // "2/3/2024 Anno Domini, 9:00:00 AM - 5:00:00 PM"
- * @example formatDateTimeRange("invalid", "2024-02-03T17:00:00", "en-US") // "" (invalid input)
+ * @example formatDateTimeRange("2024-02-03T09:00:00", "2024-02-03T17:00:00", "en-GB", { era: "long" }) // "03/02/2024 Anno Domini, 09:00:00 - 17:00:00"
+ * @example formatDateTimeRange("invalid", "2024-02-03T17:00:00", "de-DE") // "" (invalid input)
  * @example formatDateTimeRange("2024-02-03T14:30:45", "2024-02-03T16:46:15", ["fr-FR", "en-US"], { hour: "numeric", minute: "numeric" }) // "14:30 - 16:46"
  */
 export declare function formatDateTimeRange(start: string, end: string, locale?: string | string[], options?: DateTimeFormatOptions): string;

package/dist/plain/format/formatDateTimeRange.js

@@ -1,8 +1,9 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { normalizeDateTime } from "../../internal/index.js";
 import { plainDateTimeFormatOptions } from "../../internal/plainFormatOptions.js";
 import { isValidDateTime } from "../validate/index.js";
 import { readDateTimeFormatOptions } from "../../internal/readDateTimeFormatOptions.js";
+import { cachedFormatter, checkFormatterArguments, } from "../../internal/formatterCache.js";
 /**
  * Format a plain datetime range using the Temporal Intl.DateTimeFormat formatRange API.
  *
@@ -29,12 +30,12 @@ import { readDateTimeFormatOptions } from "../../internal/readDateTimeFormatOpti
  * @param options optional Intl.DateTimeFormatOptions
  * @returns localized range string or "" when invalid
  *
- * @example formatDateTimeRange("2024-02-03T09:00:00", "2024-02-03T17:00:00", "en-US", { dateStyle: "long", timeStyle: "short" }) // "February 3, 2024, 9:00 AM - 5:00 PM"
- * @example formatDateTimeRange("2024-02-03T09:00:00", "2024-02-10T17:00:00", "en-US", { dateStyle: "long", timeStyle: "short" }) // "February 3, 2024 at 9:00 AM - February 10, 2024 at 5:00 PM"
+ * @example formatDateTimeRange("2024-02-03T09:00:00", "2024-02-03T17:00:00", "en-GB", { dateStyle: "long", timeStyle: "short" }) // "3 February 2024, 09:00-17:00"
+ * @example formatDateTimeRange("2024-02-03T09:00:00", "2024-02-10T17:00:00", "pt-BR", { dateStyle: "long", timeStyle: "short" }) // "3 de fevereiro de 2024 às 09:00 - 10 de fevereiro de 2024 às 17:00"
  * @example formatDateTimeRange("2024-02-03T09:00:00", "2024-02-03T17:00:00", "zh-CN", { year: "numeric", month: "long" }) // "2024年2月"
  * @example formatDateTimeRange("2024-02-03T09:00:00", "2024-02-03T17:00:00", "zh-CN", { year: "numeric", month: "numeric" }) // "2024/2" — the pre-1.16.0 text
- * @example formatDateTimeRange("2024-02-03T09:00:00", "2024-02-03T17:00:00", "en-US", { era: "long" }) // "2/3/2024 Anno Domini, 9:00:00 AM - 5:00:00 PM"
- * @example formatDateTimeRange("invalid", "2024-02-03T17:00:00", "en-US") // "" (invalid input)
+ * @example formatDateTimeRange("2024-02-03T09:00:00", "2024-02-03T17:00:00", "en-GB", { era: "long" }) // "03/02/2024 Anno Domini, 09:00:00 - 17:00:00"
+ * @example formatDateTimeRange("invalid", "2024-02-03T17:00:00", "de-DE") // "" (invalid input)
  * @example formatDateTimeRange("2024-02-03T14:30:45", "2024-02-03T16:46:15", ["fr-FR", "en-US"], { hour: "numeric", minute: "numeric" }) // "14:30 - 16:46"
  */
 export function formatDateTimeRange(start, end, locale, options) {
@@ -48,8 +49,8 @@ export function formatDateTimeRange(start, end, locale, options) {
         // caller's options first surfaces the TypeError or RangeError
         // Intl.DateTimeFormat raises for invalid ones.
         const read = readDateTimeFormatOptions(options);
-        new Intl.DateTimeFormat(locale, read);
-        const out = new Intl.DateTimeFormat(locale, plainDateTimeFormatOptions(read)).formatRange(Temporal.PlainDateTime.from(start).toZonedDateTime("UTC")
+        checkFormatterArguments("DateTimeFormat", locale, read);
+        const out = cachedFormatter("DateTimeFormat", locale, plainDateTimeFormatOptions(read)).formatRange(Temporal.PlainDateTime.from(start).toZonedDateTime("UTC")
             .epochMilliseconds, Temporal.PlainDateTime.from(end).toZonedDateTime("UTC").epochMilliseconds);
         return normalizeDateTime(out);
     }

package/dist/plain/format/formatDateTimeToParts.d.ts

@@ -2,10 +2,10 @@ import type { DateTimeFormatOptions } from "../../types/index.js";
 /**
  * Return the locale-formatted parts of a PlainDateTime.
  *
- * - This is GMT's substitute for a token formatter (Luxon `toFormat`, date-fns
- *   `format`). A token pattern hard-codes field order and ships US ordering to
- *   every locale; `formatToParts` gives the caller full control over presentation
- *   while the *locale* keeps control of order.
+ * - Use the parts instead of a fixed field pattern. A pattern such as UTS #35's `dd/MM/yyyy` fixes
+ *   one field order for every locale; ECMA-402's `Intl.DateTimeFormat.prototype.formatToParts`
+ *   (§11.3.6; `FormatDateTimeToParts` §11.5.7) returns the fields in the order of the locale's
+ *   CLDR date pattern, so the caller controls presentation and the locale keeps control of order.
  * - Each part is `{ type, value }` where `type` can be:
  *   `"era"`, `"year"`, `"relatedYear"`, `"yearName"`, `"month"`, `"day"`, `"weekday"`,
  *   `"hour"`, `"minute"`, `"second"`, `"fractionalSecond"`, `"dayPeriod"`, `"literal"`.
@@ -43,9 +43,9 @@ import type { DateTimeFormatOptions } from "../../types/index.js";
  * @param options optional Intl.DateTimeFormatOptions
  * @returns array of `{ type, value }` parts, or `[]` on invalid input
  *
- * @example formatDateTimeToParts("2024-03-15T14:30:00", "en-US") // [{ type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }, { type: "literal", value: ", " }, { type: "hour", value: "2" }, { type: "literal", value: ":" }, { type: "minute", value: "30" }, { type: "literal", value: ":" }, { type: "second", value: "00" }, { type: "literal", value: "\u202f" }, { type: "dayPeriod", value: "PM" }]
+ * @example formatDateTimeToParts("2024-03-15T14:30:00", "ja-JP") // [{ type: "year", value: "2024" }, { type: "literal", value: "/" }, { type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }, { type: "literal", value: " " }, { type: "hour", value: "14" }, { type: "literal", value: ":" }, { type: "minute", value: "30" }, { type: "literal", value: ":" }, { type: "second", value: "00" }]
  * @example formatDateTimeToParts("2024-03-15T14:30:00", "de-DE") // [{ type: "day", value: "15" }, { type: "literal", value: "." }, { type: "month", value: "3" }, { type: "literal", value: "." }, { type: "year", value: "2024" }, { type: "literal", value: ", " }, { type: "hour", value: "14" }, { type: "literal", value: ":" }, { type: "minute", value: "30" }, { type: "literal", value: ":" }, { type: "second", value: "00" }]
- * @example formatDateTimeToParts("2024-03-15T14:30:00", "en-US", { year: "numeric", month: "numeric", day: "numeric" }) // [{ type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }] — the pre-1.16.0 default
+ * @example formatDateTimeToParts("2024-03-15T14:30:00", "en-GB", { year: "numeric", month: "numeric", day: "numeric" }) // [{ type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "month", value: "03" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }] — the pre-1.16.0 default
  * @example formatDateTimeToParts("2024-02-29T12:00:00", "en-US", { timeStyle: "long" }) // [{ type: "hour", value: "12" }, { type: "literal", value: ":" }, { type: "minute", value: "00" }, { type: "literal", value: ":" }, { type: "second", value: "00" }, { type: "literal", value: "\u202f" }, { type: "dayPeriod", value: "PM" }]
  * @example formatZonedToParts("2024-02-29T12:00:00+00:00[UTC]", "en-US", { timeStyle: "long" }) // [{ type: "hour", value: "12" }, { type: "literal", value: ":" }, { type: "minute", value: "00" }, { type: "literal", value: ":" }, { type: "second", value: "00" }, { type: "literal", value: "\u202f" }, { type: "dayPeriod", value: "PM" }, { type: "literal", value: " " }, { type: "timeZoneName", value: "UTC" }] — the pre-1.16.0 parts
  * @example formatDateTimeToParts("invalid") // []

package/dist/plain/format/formatDateTimeToParts.js

@@ -1,14 +1,15 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { plainDateTimeFormatOptions } from "../../internal/plainFormatOptions.js";
 import { isValidDateTime } from "../validate/index.js";
 import { readDateTimeFormatOptions } from "../../internal/readDateTimeFormatOptions.js";
+import { cachedFormatter, checkFormatterArguments, } from "../../internal/formatterCache.js";
 /**
  * Return the locale-formatted parts of a PlainDateTime.
  *
- * - This is GMT's substitute for a token formatter (Luxon `toFormat`, date-fns
- *   `format`). A token pattern hard-codes field order and ships US ordering to
- *   every locale; `formatToParts` gives the caller full control over presentation
- *   while the *locale* keeps control of order.
+ * - Use the parts instead of a fixed field pattern. A pattern such as UTS #35's `dd/MM/yyyy` fixes
+ *   one field order for every locale; ECMA-402's `Intl.DateTimeFormat.prototype.formatToParts`
+ *   (§11.3.6; `FormatDateTimeToParts` §11.5.7) returns the fields in the order of the locale's
+ *   CLDR date pattern, so the caller controls presentation and the locale keeps control of order.
  * - Each part is `{ type, value }` where `type` can be:
  *   `"era"`, `"year"`, `"relatedYear"`, `"yearName"`, `"month"`, `"day"`, `"weekday"`,
  *   `"hour"`, `"minute"`, `"second"`, `"fractionalSecond"`, `"dayPeriod"`, `"literal"`.
@@ -46,9 +47,9 @@ import { readDateTimeFormatOptions } from "../../internal/readDateTimeFormatOpti
  * @param options optional Intl.DateTimeFormatOptions
  * @returns array of `{ type, value }` parts, or `[]` on invalid input
  *
- * @example formatDateTimeToParts("2024-03-15T14:30:00", "en-US") // [{ type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }, { type: "literal", value: ", " }, { type: "hour", value: "2" }, { type: "literal", value: ":" }, { type: "minute", value: "30" }, { type: "literal", value: ":" }, { type: "second", value: "00" }, { type: "literal", value: "\u202f" }, { type: "dayPeriod", value: "PM" }]
+ * @example formatDateTimeToParts("2024-03-15T14:30:00", "ja-JP") // [{ type: "year", value: "2024" }, { type: "literal", value: "/" }, { type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }, { type: "literal", value: " " }, { type: "hour", value: "14" }, { type: "literal", value: ":" }, { type: "minute", value: "30" }, { type: "literal", value: ":" }, { type: "second", value: "00" }]
  * @example formatDateTimeToParts("2024-03-15T14:30:00", "de-DE") // [{ type: "day", value: "15" }, { type: "literal", value: "." }, { type: "month", value: "3" }, { type: "literal", value: "." }, { type: "year", value: "2024" }, { type: "literal", value: ", " }, { type: "hour", value: "14" }, { type: "literal", value: ":" }, { type: "minute", value: "30" }, { type: "literal", value: ":" }, { type: "second", value: "00" }]
- * @example formatDateTimeToParts("2024-03-15T14:30:00", "en-US", { year: "numeric", month: "numeric", day: "numeric" }) // [{ type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }] — the pre-1.16.0 default
+ * @example formatDateTimeToParts("2024-03-15T14:30:00", "en-GB", { year: "numeric", month: "numeric", day: "numeric" }) // [{ type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "month", value: "03" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }] — the pre-1.16.0 default
  * @example formatDateTimeToParts("2024-02-29T12:00:00", "en-US", { timeStyle: "long" }) // [{ type: "hour", value: "12" }, { type: "literal", value: ":" }, { type: "minute", value: "00" }, { type: "literal", value: ":" }, { type: "second", value: "00" }, { type: "literal", value: "\u202f" }, { type: "dayPeriod", value: "PM" }]
  * @example formatZonedToParts("2024-02-29T12:00:00+00:00[UTC]", "en-US", { timeStyle: "long" }) // [{ type: "hour", value: "12" }, { type: "literal", value: ":" }, { type: "minute", value: "00" }, { type: "literal", value: ":" }, { type: "second", value: "00" }, { type: "literal", value: "\u202f" }, { type: "dayPeriod", value: "PM" }, { type: "literal", value: " " }, { type: "timeZoneName", value: "UTC" }] — the pre-1.16.0 parts
  * @example formatDateTimeToParts("invalid") // []
@@ -66,9 +67,9 @@ export function formatDateTimeToParts(value, locale, options) {
         // Constructing with the caller's options first surfaces the TypeError or
         // RangeError Intl.DateTimeFormat raises for invalid ones.
         const read = readDateTimeFormatOptions(options);
-        new Intl.DateTimeFormat(locale, read);
+        checkFormatterArguments("DateTimeFormat", locale, read);
         const epochMilliseconds = Temporal.PlainDateTime.from(value).toZonedDateTime("UTC").epochMilliseconds;
-        return new Intl.DateTimeFormat(locale, plainDateTimeFormatOptions(read))
+        return cachedFormatter("DateTimeFormat", locale, plainDateTimeFormatOptions(read))
             .formatToParts(epochMilliseconds)
             .map((p) => ({ type: p.type, value: p.value }));
     }

package/dist/plain/format/formatDateToParts.d.ts

@@ -2,10 +2,10 @@ import type { DateTimeFormatOptions } from "../../types/index.js";
 /**
  * Return the locale-formatted parts of a PlainDate.
  *
- * - This is GMT's substitute for a token formatter (Luxon `toFormat`, date-fns
- *   `format`). A token pattern hard-codes field order and ships US ordering to
- *   every locale; `formatToParts` gives the caller full control over presentation
- *   while the *locale* keeps control of order.
+ * - Use the parts instead of a fixed field pattern. A pattern such as UTS #35's `dd/MM/yyyy` fixes
+ *   one field order for every locale; ECMA-402's `Intl.DateTimeFormat.prototype.formatToParts`
+ *   (§11.3.6; `FormatDateTimeToParts` §11.5.7) returns the fields in the order of the locale's
+ *   CLDR date pattern, so the caller controls presentation and the locale keeps control of order.
  * - Each part is `{ type, value }` where `type` is one of:
  *   `"era"`, `"year"`, `"relatedYear"`, `"yearName"`, `"month"`, `"day"`, `"weekday"`,
  *   `"literal"`.
@@ -37,9 +37,9 @@ import type { DateTimeFormatOptions } from "../../types/index.js";
  * @param options optional Intl.DateTimeFormatOptions
  * @returns array of `{ type, value }` parts, or `[]` on invalid input
  *
- * @example formatDateToParts("2024-03-15", "en-US") // [{ type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }]
+ * @example formatDateToParts("2024-03-15", "zh-CN") // [{ type: "year", value: "2024" }, { type: "literal", value: "/" }, { type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }]
  * @example formatDateToParts("2024-03-15", "de-DE") // [{ type: "day", value: "15" }, { type: "literal", value: "." }, { type: "month", value: "3" }, { type: "literal", value: "." }, { type: "year", value: "2024" }]
- * @example formatDateToParts("2024-02-29", "en-US", { dateStyle: "full", timeStyle: "full" }) // [{ type: "weekday", value: "Thursday" }, { type: "literal", value: ", " }, { type: "month", value: "February" }, { type: "literal", value: " " }, { type: "day", value: "29" }, { type: "literal", value: ", " }, { type: "year", value: "2024" }]
+ * @example formatDateToParts("2024-02-29", "hi-IN", { dateStyle: "full", timeStyle: "full" }) // [{ type: "weekday", value: "गुरुवार" }, { type: "literal", value: ", " }, { type: "day", value: "29" }, { type: "literal", value: " " }, { type: "month", value: "फ़रवरी" }, { type: "literal", value: " " }, { type: "year", value: "2024" }]
  * @example formatDateToParts("2024-02-29", "en-US", { timeStyle: "long" }) // [] — a PlainDate has no time
  * @example formatZonedToParts("2024-02-29T00:00:00+00:00[UTC]", "en-US", { timeStyle: "long" }) // [{ type: "hour", value: "12" }, { type: "literal", value: ":" }, { type: "minute", value: "00" }, { type: "literal", value: ":" }, { type: "second", value: "00" }, { type: "literal", value: "\u202f" }, { type: "dayPeriod", value: "AM" }, { type: "literal", value: " " }, { type: "timeZoneName", value: "UTC" }] — the pre-1.16.0 parts
  * @example formatDateToParts("invalid") // []

package/dist/plain/format/formatDateToParts.js

@@ -1,14 +1,15 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { plainDateFormatOptions } from "../../internal/plainFormatOptions.js";
 import { isValidDate } from "../validate/index.js";
 import { readDateTimeFormatOptions } from "../../internal/readDateTimeFormatOptions.js";
+import { cachedFormatter, checkFormatterArguments, } from "../../internal/formatterCache.js";
 /**
  * Return the locale-formatted parts of a PlainDate.
  *
- * - This is GMT's substitute for a token formatter (Luxon `toFormat`, date-fns
- *   `format`). A token pattern hard-codes field order and ships US ordering to
- *   every locale; `formatToParts` gives the caller full control over presentation
- *   while the *locale* keeps control of order.
+ * - Use the parts instead of a fixed field pattern. A pattern such as UTS #35's `dd/MM/yyyy` fixes
+ *   one field order for every locale; ECMA-402's `Intl.DateTimeFormat.prototype.formatToParts`
+ *   (§11.3.6; `FormatDateTimeToParts` §11.5.7) returns the fields in the order of the locale's
+ *   CLDR date pattern, so the caller controls presentation and the locale keeps control of order.
  * - Each part is `{ type, value }` where `type` is one of:
  *   `"era"`, `"year"`, `"relatedYear"`, `"yearName"`, `"month"`, `"day"`, `"weekday"`,
  *   `"literal"`.
@@ -40,9 +41,9 @@ import { readDateTimeFormatOptions } from "../../internal/readDateTimeFormatOpti
  * @param options optional Intl.DateTimeFormatOptions
  * @returns array of `{ type, value }` parts, or `[]` on invalid input
  *
- * @example formatDateToParts("2024-03-15", "en-US") // [{ type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }]
+ * @example formatDateToParts("2024-03-15", "zh-CN") // [{ type: "year", value: "2024" }, { type: "literal", value: "/" }, { type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }]
  * @example formatDateToParts("2024-03-15", "de-DE") // [{ type: "day", value: "15" }, { type: "literal", value: "." }, { type: "month", value: "3" }, { type: "literal", value: "." }, { type: "year", value: "2024" }]
- * @example formatDateToParts("2024-02-29", "en-US", { dateStyle: "full", timeStyle: "full" }) // [{ type: "weekday", value: "Thursday" }, { type: "literal", value: ", " }, { type: "month", value: "February" }, { type: "literal", value: " " }, { type: "day", value: "29" }, { type: "literal", value: ", " }, { type: "year", value: "2024" }]
+ * @example formatDateToParts("2024-02-29", "hi-IN", { dateStyle: "full", timeStyle: "full" }) // [{ type: "weekday", value: "गुरुवार" }, { type: "literal", value: ", " }, { type: "day", value: "29" }, { type: "literal", value: " " }, { type: "month", value: "फ़रवरी" }, { type: "literal", value: " " }, { type: "year", value: "2024" }]
  * @example formatDateToParts("2024-02-29", "en-US", { timeStyle: "long" }) // [] — a PlainDate has no time
  * @example formatZonedToParts("2024-02-29T00:00:00+00:00[UTC]", "en-US", { timeStyle: "long" }) // [{ type: "hour", value: "12" }, { type: "literal", value: ":" }, { type: "minute", value: "00" }, { type: "literal", value: ":" }, { type: "second", value: "00" }, { type: "literal", value: "\u202f" }, { type: "dayPeriod", value: "AM" }, { type: "literal", value: " " }, { type: "timeZoneName", value: "UTC" }] — the pre-1.16.0 parts
  * @example formatDateToParts("invalid") // []
@@ -60,13 +61,13 @@ export function formatDateToParts(value, locale, options) {
         // Constructing with the caller's options first surfaces the TypeError or
         // RangeError Intl.DateTimeFormat raises for invalid ones.
         const read = readDateTimeFormatOptions(options);
-        new Intl.DateTimeFormat(locale, read);
+        checkFormatterArguments("DateTimeFormat", locale, read);
         const resolved = plainDateFormatOptions(read);
         if (resolved === null) {
             return [];
         }
         const epochMilliseconds = Temporal.PlainDate.from(value).toZonedDateTime("UTC").epochMilliseconds;
-        return new Intl.DateTimeFormat(locale, resolved)
+        return cachedFormatter("DateTimeFormat", locale, resolved)
             .formatToParts(epochMilliseconds)
             .map((p) => ({ type: p.type, value: p.value }));
     }

package/dist/plain/format/formatRelativeDate.d.ts

@@ -29,10 +29,10 @@ export interface FormatRelativeDateOptions extends RelativeTimeFormatOptions {
  * @param options How the distance is measured, rounded and worded
  * @returns the formatted relative-time string, or "" on invalid input
  *
- * @example formatRelativeDate("2026-01-15", "en-US", { reference: "2026-04-15" }) // "3 months ago"
- * @example formatRelativeDate("2026-03-01", "en-US", { reference: "2026-03-11", largestUnit: "week", roundingMethod: "floor" }) // "2 weeks ago" (−1.43 weeks floors to −2; the default rounds to "last week")
+ * @example formatRelativeDate("2026-01-15", "pt-BR", { reference: "2026-04-15" }) // "há 3 meses"
+ * @example formatRelativeDate("2026-03-01", "en-GB", { reference: "2026-03-11", largestUnit: "week", roundingMethod: "floor" }) // "2 weeks ago" (−1.43 weeks floors to −2; the default rounds to "last week")
  * @example formatRelativeDate("not-a-date") // ""
  * @example formatRelativeDate("2024-01-15", ["fr-FR", "en-US"], { reference: "2024-03-15" }) // "il y a 2 mois"
- * @example formatRelativeDate("2024-03-12", "en-US", null as never) // "" (null options)
+ * @example formatRelativeDate("2024-03-12", "ar-EG", null as never) // "" (null options)
  */
 export declare function formatRelativeDate(value: string, locale?: string | string[], options?: FormatRelativeDateOptions): string;

package/dist/plain/format/formatRelativeDate.js

@@ -1,8 +1,9 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { durationTotal } from "../../internal/index.js";
 import { formatRelativeAmount } from "../../internal/formatRelativeDuration.js";
 import { isValidDate } from "../validate/index.js";
 import { resolveRelativeUnit } from "../../internal/resolveRelativeUnit.js";
+import { isObject } from "../../internal/isObject.js";
 // Temporal's date unit group: the units a PlainDate difference may be written in.
 const DATE_UNITS = [
     "year",
@@ -30,17 +31,17 @@ const AUTO_UNITS = [
  * @param options How the distance is measured, rounded and worded
  * @returns the formatted relative-time string, or "" on invalid input
  *
- * @example formatRelativeDate("2026-01-15", "en-US", { reference: "2026-04-15" }) // "3 months ago"
- * @example formatRelativeDate("2026-03-01", "en-US", { reference: "2026-03-11", largestUnit: "week", roundingMethod: "floor" }) // "2 weeks ago" (−1.43 weeks floors to −2; the default rounds to "last week")
+ * @example formatRelativeDate("2026-01-15", "pt-BR", { reference: "2026-04-15" }) // "há 3 meses"
+ * @example formatRelativeDate("2026-03-01", "en-GB", { reference: "2026-03-11", largestUnit: "week", roundingMethod: "floor" }) // "2 weeks ago" (−1.43 weeks floors to −2; the default rounds to "last week")
  * @example formatRelativeDate("not-a-date") // ""
  * @example formatRelativeDate("2024-01-15", ["fr-FR", "en-US"], { reference: "2024-03-15" }) // "il y a 2 mois"
- * @example formatRelativeDate("2024-03-12", "en-US", null as never) // "" (null options)
+ * @example formatRelativeDate("2024-03-12", "ar-EG", null as never) // "" (null options)
  */
 export function formatRelativeDate(value, locale, options = {}) {
     try {
         // Temporal GetOptionsObject: options must be an object or omitted; null and other primitives are
         // invalid input.
-        if (options === null || typeof options !== "object")
+        if (!isObject(options))
             return "";
         if (!isValidDate(value))
             return "";

package/dist/plain/format/formatRelativeDateTime.d.ts

@@ -34,10 +34,10 @@ export interface FormatRelativeDateTimeOptions extends RelativeTimeFormatOptions
  * @returns the formatted relative-time string, or "" on invalid input
  *
  * @example formatRelativeDateTime("2026-03-17T09:00:00", "en-GB", { style: "long", reference: "2026-03-17T06:00:00" }) // "in 3 hours"
- * @example formatRelativeDateTime("2026-01-15T00:00:00", "en-US", { reference: "2026-01-15T10:30:00", roundingMethod: "floor" }) // "11 hours ago" (−10.5 hours floors to −11; the default rounds to 10)
- * @example formatRelativeDateTime("2021-03-15T12:00:00", "en-US", { reference: "2024-03-15T12:00:00" }) // "3 years ago"
+ * @example formatRelativeDateTime("2026-01-15T00:00:00", "en-GB", { reference: "2026-01-15T10:30:00", roundingMethod: "floor" }) // "11 hours ago" (−10.5 hours floors to −11; the default rounds to 10)
+ * @example formatRelativeDateTime("2021-03-15T12:00:00", "de-DE", { reference: "2024-03-15T12:00:00" }) // "vor 3 Jahren"
  * @example formatRelativeDateTime("not-a-date") // ""
  * @example formatRelativeDateTime("2024-03-15T09:00:00", ["fr-FR", "en-US"], { reference: "2024-03-15T12:00:00" }) // "il y a 3 heures"
- * @example formatRelativeDateTime("2024-03-12T10:00:00", "en-US", null as never) // "" (null options)
+ * @example formatRelativeDateTime("2024-03-12T10:00:00", "hi-IN", null as never) // "" (null options)
  */
 export declare function formatRelativeDateTime(value: string, locale?: string | string[], options?: FormatRelativeDateTimeOptions): string;

package/dist/plain/format/formatRelativeDateTime.js

@@ -1,8 +1,9 @@
 // fallow-ignore-file code-duplication -- cross-family Temporal type clone, by design (rule 5)
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { durationTotal } from "../../internal/index.js";
 import { formatRelativeDuration } from "../../internal/formatRelativeDuration.js";
 import { isValidDateTime } from "../validate/index.js";
+import { isObject } from "../../internal/isObject.js";
 /**
  * Format the relative time between a plain date-time and a reference date-time.
  *
@@ -23,17 +24,17 @@ import { isValidDateTime } from "../validate/index.js";
  * @returns the formatted relative-time string, or "" on invalid input
  *
  * @example formatRelativeDateTime("2026-03-17T09:00:00", "en-GB", { style: "long", reference: "2026-03-17T06:00:00" }) // "in 3 hours"
- * @example formatRelativeDateTime("2026-01-15T00:00:00", "en-US", { reference: "2026-01-15T10:30:00", roundingMethod: "floor" }) // "11 hours ago" (−10.5 hours floors to −11; the default rounds to 10)
- * @example formatRelativeDateTime("2021-03-15T12:00:00", "en-US", { reference: "2024-03-15T12:00:00" }) // "3 years ago"
+ * @example formatRelativeDateTime("2026-01-15T00:00:00", "en-GB", { reference: "2026-01-15T10:30:00", roundingMethod: "floor" }) // "11 hours ago" (−10.5 hours floors to −11; the default rounds to 10)
+ * @example formatRelativeDateTime("2021-03-15T12:00:00", "de-DE", { reference: "2024-03-15T12:00:00" }) // "vor 3 Jahren"
  * @example formatRelativeDateTime("not-a-date") // ""
  * @example formatRelativeDateTime("2024-03-15T09:00:00", ["fr-FR", "en-US"], { reference: "2024-03-15T12:00:00" }) // "il y a 3 heures"
- * @example formatRelativeDateTime("2024-03-12T10:00:00", "en-US", null as never) // "" (null options)
+ * @example formatRelativeDateTime("2024-03-12T10:00:00", "hi-IN", null as never) // "" (null options)
  */
 export function formatRelativeDateTime(value, locale, options = {}) {
     try {
         // Temporal GetOptionsObject: options must be an object or omitted; null and other primitives are
         // invalid input.
-        if (options === null || typeof options !== "object")
+        if (!isObject(options))
             return "";
         if (!isValidDateTime(value))
             return "";

package/dist/plain/format/formatRelativeTime.d.ts

@@ -29,10 +29,10 @@ export interface FormatRelativeTimeOptions extends RelativeTimeFormatOptions {
  * @param options How the distance is measured, rounded and worded
  * @returns the formatted relative-time string, or "" on invalid input
  *
- * @example formatRelativeTime("14:30:00", "en-US", { style: "short", reference: "16:30:00" }) // "2 hr. ago"
- * @example formatRelativeTime("09:00:00", "en-US", { reference: "10:30:00", roundingMethod: "floor" }) // "2 hours ago" (−1.5 hours floors to −2)
+ * @example formatRelativeTime("14:30:00", "de-DE", { style: "short", reference: "16:30:00" }) // "vor 2 Std."
+ * @example formatRelativeTime("09:00:00", "en-GB", { reference: "10:30:00", roundingMethod: "floor" }) // "2 hours ago" (−1.5 hours floors to −2)
  * @example formatRelativeTime("not-a-time") // ""
  * @example formatRelativeTime("10:00:00", ["fr-FR", "en-US"], { reference: "12:00:00" }) // "il y a 2 heures"
- * @example formatRelativeTime("10:00:00", "en-US", null as never) // "" (null options)
+ * @example formatRelativeTime("10:00:00", "ja-JP", null as never) // "" (null options)
  */
 export declare function formatRelativeTime(value: string, locale?: string | string[], options?: FormatRelativeTimeOptions): string;

package/dist/plain/format/formatRelativeTime.js

@@ -1,7 +1,8 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { formatRelativeAmount } from "../../internal/formatRelativeDuration.js";
 import { isValidTime } from "../validate/index.js";
 import { resolveRelativeUnit } from "../../internal/resolveRelativeUnit.js";
+import { isObject } from "../../internal/isObject.js";
 // Temporal's time unit group down to the second: the units a PlainTime difference may be written
 // in, less the sub-second units, which Intl.RelativeTimeFormat does not have.
 const TIME_UNITS = [
@@ -28,17 +29,17 @@ const AUTO_UNITS = [
  * @param options How the distance is measured, rounded and worded
  * @returns the formatted relative-time string, or "" on invalid input
  *
- * @example formatRelativeTime("14:30:00", "en-US", { style: "short", reference: "16:30:00" }) // "2 hr. ago"
- * @example formatRelativeTime("09:00:00", "en-US", { reference: "10:30:00", roundingMethod: "floor" }) // "2 hours ago" (−1.5 hours floors to −2)
+ * @example formatRelativeTime("14:30:00", "de-DE", { style: "short", reference: "16:30:00" }) // "vor 2 Std."
+ * @example formatRelativeTime("09:00:00", "en-GB", { reference: "10:30:00", roundingMethod: "floor" }) // "2 hours ago" (−1.5 hours floors to −2)
  * @example formatRelativeTime("not-a-time") // ""
  * @example formatRelativeTime("10:00:00", ["fr-FR", "en-US"], { reference: "12:00:00" }) // "il y a 2 heures"
- * @example formatRelativeTime("10:00:00", "en-US", null as never) // "" (null options)
+ * @example formatRelativeTime("10:00:00", "ja-JP", null as never) // "" (null options)
  */
 export function formatRelativeTime(value, locale, options = {}) {
     try {
         // Temporal GetOptionsObject: options must be an object or omitted; null and other primitives are
         // invalid input.
-        if (options === null || typeof options !== "object")
+        if (!isObject(options))
             return "";
         if (!isValidTime(value))
             return "";

package/dist/plain/format/{formatSql.d.ts → formatSqlDateTime.d.ts}

@@ -3,7 +3,7 @@
  * `YYYY-MM-DD HH:MM:SS[.fff]` form of standard SQL `TIMESTAMP` and MySQL/SQLite `DATETIME`
  * columns.
  *
- * - **Grammar:** SQL-92 §5.3 `<timestamp string>` and the ODBC `ts` escape, which `parseSql`
+ * - **Grammar:** SQL-92 §5.3 `<timestamp string>` and the ODBC `ts` escape, which `parseSqlDateTime`
  *   reads: the date, a single space, and the time with seconds always written.
  * - A year outside SQL-92's `0001`–`9999` (Table 10) returns `""`: the literal has no sign and
  *   no expanded year to write it with.
@@ -16,10 +16,10 @@
  * @param value plain ISO 8601 datetime string (e.g. "2024-03-15T14:30:00")
  * @returns SQL timestamp literal, or "" on invalid input
  *
- * @example formatSql("2024-03-15T14:30:00") // "2024-03-15 14:30:00"
- * @example formatSql("2024-03-15T14:30") // "2024-03-15 14:30:00"
- * @example formatSql("2024-03-15T14:30:00.500") // "2024-03-15 14:30:00.5"
- * @example formatSql("0000-01-01T00:00:00") // "" (year outside 0001–9999)
- * @example formatSql("invalid") // ""
+ * @example formatSqlDateTime("2024-03-15T14:30:00") // "2024-03-15 14:30:00"
+ * @example formatSqlDateTime("2024-03-15T14:30") // "2024-03-15 14:30:00"
+ * @example formatSqlDateTime("2024-03-15T14:30:00.500") // "2024-03-15 14:30:00.5"
+ * @example formatSqlDateTime("0000-01-01T00:00:00") // "" (year outside 0001–9999)
+ * @example formatSqlDateTime("invalid") // ""
  */
-export declare function formatSql(value: string): string;
+export declare function formatSqlDateTime(value: string): string;

package/dist/plain/format/{formatSql.js → formatSqlDateTime.js}

@@ -1,11 +1,11 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDateTime } from "../validate/index.js";
 /**
  * Format a plain ISO 8601 datetime string as a SQL timestamp literal without a time zone — the
  * `YYYY-MM-DD HH:MM:SS[.fff]` form of standard SQL `TIMESTAMP` and MySQL/SQLite `DATETIME`
  * columns.
  *
- * - **Grammar:** SQL-92 §5.3 `<timestamp string>` and the ODBC `ts` escape, which `parseSql`
+ * - **Grammar:** SQL-92 §5.3 `<timestamp string>` and the ODBC `ts` escape, which `parseSqlDateTime`
  *   reads: the date, a single space, and the time with seconds always written.
  * - A year outside SQL-92's `0001`–`9999` (Table 10) returns `""`: the literal has no sign and
  *   no expanded year to write it with.
@@ -18,13 +18,13 @@ import { isValidDateTime } from "../validate/index.js";
  * @param value plain ISO 8601 datetime string (e.g. "2024-03-15T14:30:00")
  * @returns SQL timestamp literal, or "" on invalid input
  *
- * @example formatSql("2024-03-15T14:30:00") // "2024-03-15 14:30:00"
- * @example formatSql("2024-03-15T14:30") // "2024-03-15 14:30:00"
- * @example formatSql("2024-03-15T14:30:00.500") // "2024-03-15 14:30:00.5"
- * @example formatSql("0000-01-01T00:00:00") // "" (year outside 0001–9999)
- * @example formatSql("invalid") // ""
+ * @example formatSqlDateTime("2024-03-15T14:30:00") // "2024-03-15 14:30:00"
+ * @example formatSqlDateTime("2024-03-15T14:30") // "2024-03-15 14:30:00"
+ * @example formatSqlDateTime("2024-03-15T14:30:00.500") // "2024-03-15 14:30:00.5"
+ * @example formatSqlDateTime("0000-01-01T00:00:00") // "" (year outside 0001–9999)
+ * @example formatSqlDateTime("invalid") // ""
  */
-export function formatSql(value) {
+export function formatSqlDateTime(value) {
     if (!isValidDateTime(value))
         return "";
     try {