@northguild/gmt 1.14.2

package/dist/plain/parse/parseDateWithPattern.js

@@ -0,0 +1,91 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { DATE_PATTERN_FIELDS, parseValueWithPattern } from "../../internal/index.js";
+/**
+ * Parse a date string against a caller-supplied token pattern (e.g.
+ * `"MM/dd/yyyy"`, `"dd-MMM-yyyy"`) and return it as an ISO `PlainDate`
+ * string.
+ *
+ * - **Decoding, not display.** This is for consuming a *known, fixed*
+ *   producer format — a CSV column, a legacy API field, a partially-typed
+ *   form value — not for generating locale-correct output. For display,
+ *   use `formatDate`/`formatDateToParts`, which order fields per locale
+ *   instead of hard-coding a field order (see roadmap Decision 1 — a
+ *   token *formatter*, the inverse of this function, is deliberately out
+ *   of scope for GMT).
+ * - `pattern` accepts only date-shaped tokens. A pattern containing a
+ *   time-only token (`H h m s S a`) is malformed for this function and
+ *   returns `""` — use `parseDateTimeWithPattern` for combined input.
+ *
+ * ### Token table
+ * | Token | Field | Width | Range | Notes |
+ * |---|---|---|---|---|
+ * | `yyyy` | year | 4 digits | 0000–9999 | |
+ * | `yy` | year | 2 digits | 00–99 | Pivot: 00–68 → 2000–2068, 69–99 → 1969–1999 (fixed rule) |
+ * | `MM` | month | 2 digits | 01–12 | |
+ * | `M` | month | 1-2 digits | 1–12 | |
+ * | `MMMM` | month name (long) | locale | — | `getLocaleMonthNames(locale, "long")` |
+ * | `MMM` | month name (short) | locale | — | `getLocaleMonthNames(locale, "short")` |
+ * | `dd` | day | 2 digits | 01–31 | |
+ * | `d` | day | 1-2 digits | 1–31 | |
+ * | `EEEE` | weekday name (long) | locale | — | consumed, NOT cross-validated against the date (see below) |
+ * | `EEE` | weekday name (short) | locale | — | same |
+ * | `GGGG` | era name (long) | locale | — | BCE label ⇒ final year = 1 − parsed year |
+ * | `GG` | era name (short) | locale | — | same resolution |
+ *
+ * - Text in `'single quotes'` is a literal; a doubled `''` inside a
+ *   quoted segment is a literal `'`. Any other character (`/ - , space`,
+ *   literal digits, etc.) outside a quote/letter-run is automatically a
+ *   literal — no explicit quoting required.
+ * - `MMMM`/`MMM`/`EEEE`/`EEE`/`GGGG`/`GG` are locale-aware. If `locale`
+ *   is omitted and the pattern uses any of them, GMT defaults to
+ *   `"en-US"` rather than returning `""` for every caller who didn't
+ *   have another locale in mind — pass `locale` explicitly for others.
+ * - `EEEE`/`EEE` are matched against the locale's weekday names but the
+ *   result is **not** cross-checked against the constructed date — e.g.
+ *   `"Monday, 2024-03-15"` parses successfully against
+ *   `"EEEE, yyyy-MM-dd"` even though 2024-03-15 is actually a Friday.
+ *   This is a deliberate scope limit (no second weekday-index-to-ISO-
+ *   dayOfWeek mapping layer).
+ * - Adjacent variable-width numeric tokens with no literal separator
+ *   (e.g. `"Mdyyyy"`) are inherently ambiguous: each becomes a greedy
+ *   `\d{1,2}`/etc. in sequence, so the split between fields depends on
+ *   regex backtracking, not on any documented rule. Prefer zero-padded
+ *   tokens (`MM`, `dd`) or an explicit separator for reliable parsing.
+ * - A shape-valid match does not by itself prove a real date: extracted
+ *   fields are always handed to `Temporal.PlainDate.from(fields, {
+ *   overflow: "reject" })`, so `"02/31/2024"` against `"MM/dd/yyyy"`
+ *   still returns `""` — the regex only proves the shape, Temporal
+ *   proves the date is real.
+ *
+ * @param value The string to decode (e.g. "03/15/2024")
+ * @param pattern The token pattern describing `value`'s shape (e.g. "MM/dd/yyyy")
+ * @param locale Optional BCP 47 locale for name-based tokens (default "en-US")
+ * @returns ISO `PlainDate` string, or "" on no match, malformed pattern, or invalid input
+ *
+ * @example parseDateWithPattern("03/15/2024", "MM/dd/yyyy") // "2024-03-15"
+ * @example parseDateWithPattern("15-Mar-2024", "dd-MMM-yyyy") // "2024-03-15"
+ * @example parseDateWithPattern("02/31/2024", "MM/dd/yyyy") // "" (shape-valid, not a real date)
+ * @example parseDateWithPattern("14:30", "HH:mm") // "" (time token in a date-only pattern)
+ */
+export function parseDateWithPattern(value, pattern, locale) {
+    if (typeof value !== "string")
+        return "";
+    if (typeof pattern !== "string")
+        return "";
+    if (locale !== undefined && typeof locale !== "string")
+        return "";
+    const fields = parseValueWithPattern(value, pattern, locale, DATE_PATTERN_FIELDS);
+    if (fields === null)
+        return "";
+    try {
+        // The regex only proved `value` has the right *shape* for `pattern`
+        // (e.g. "02/31/2024" matches "MM/dd/yyyy") — Temporal is what proves
+        // the date is real: `overflow: "reject"` throws instead of silently
+        // clamping Feb 31 to Feb 29, which is what the default "constrain"
+        // would do.
+        return Temporal.PlainDate.from({ year: fields.year, month: fields.month, day: fields.day }, { overflow: "reject" }).toString();
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/parse/parseDayFromDate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Return the day of month (1-31) for a given ISO 8601 date string.
+ *
+ * - Returns zero-padded string for day.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO date string
+ * @returns Day (01-31) or "" on invalid input
+ *
+ * @example parseDayFromDate("2024-03-15") // "15"
+ * @example parseDayFromDate("invalid") // ""
+ */
+export declare function parseDayFromDate(value: string): string;

package/dist/plain/parse/parseDayFromDate.js

@@ -0,0 +1,25 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { isValidDate } from "../validate/index.js";
+/**
+ * Return the day of month (1-31) for a given ISO 8601 date string.
+ *
+ * - Returns zero-padded string for day.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO date string
+ * @returns Day (01-31) or "" on invalid input
+ *
+ * @example parseDayFromDate("2024-03-15") // "15"
+ * @example parseDayFromDate("invalid") // ""
+ */
+export function parseDayFromDate(value) {
+    if (!isValidDate(value))
+        return "";
+    try {
+        const date = Temporal.PlainDate.from(value);
+        return date.day.toString().padStart(2, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/parse/parseDayFromDateTime.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Return the day of month (1-31) for a given ISO 8601 datetime string.
+ *
+ * - Returns zero-padded string for day.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO datetime string
+ * @returns Day (01-31) or "" on invalid input
+ *
+ * @example parseDayFromDateTime("2024-03-15T12:30:00") // "15"
+ * @example parseDayFromDateTime("2024-12-31T23:59:59") // "31"
+ * @example parseDayFromDateTime("invalid") // ""
+ */
+export declare function parseDayFromDateTime(value: string): string;

package/dist/plain/parse/parseDayFromDateTime.js

@@ -0,0 +1,26 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { isValidDateTime } from "../validate/index.js";
+/**
+ * Return the day of month (1-31) for a given ISO 8601 datetime string.
+ *
+ * - Returns zero-padded string for day.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO datetime string
+ * @returns Day (01-31) or "" on invalid input
+ *
+ * @example parseDayFromDateTime("2024-03-15T12:30:00") // "15"
+ * @example parseDayFromDateTime("2024-12-31T23:59:59") // "31"
+ * @example parseDayFromDateTime("invalid") // ""
+ */
+export function parseDayFromDateTime(value) {
+    if (!isValidDateTime(value))
+        return "";
+    try {
+        const dateTime = Temporal.PlainDateTime.from(value);
+        return dateTime.day.toString().padStart(2, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/parse/parseDayOfWeekFromDate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Return the day of week (1-7) for a given ISO 8601 date string.
+ *
+ * - Monday=1 through Sunday=7.
+ * - Returns null for invalid input.
+ *
+ * @param value ISO date string
+ * @returns Day of week (1-7) or null on invalid input
+ *
+ * @example parseDayOfWeekFromDate("2024-01-01") // 1 (Monday)
+ * @example parseDayOfWeekFromDate("2024-01-07") // 7 (Sunday)
+ * @example parseDayOfWeekFromDate("2024-01-08") // 1 (Monday)
+ * @example parseDayOfWeekFromDate("invalid") // null
+ */
+export declare function parseDayOfWeekFromDate(value: string): number | null;

package/dist/plain/parse/parseDayOfWeekFromDate.js

@@ -0,0 +1,28 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { isValidDate } from "../validate/index.js";
+/**
+ * Return the day of week (1-7) for a given ISO 8601 date string.
+ *
+ * - Monday=1 through Sunday=7.
+ * - Returns null for invalid input.
+ *
+ * @param value ISO date string
+ * @returns Day of week (1-7) or null on invalid input
+ *
+ * @example parseDayOfWeekFromDate("2024-01-01") // 1 (Monday)
+ * @example parseDayOfWeekFromDate("2024-01-07") // 7 (Sunday)
+ * @example parseDayOfWeekFromDate("2024-01-08") // 1 (Monday)
+ * @example parseDayOfWeekFromDate("invalid") // null
+ */
+export function parseDayOfWeekFromDate(value) {
+    if (!isValidDate(value)) {
+        return null;
+    }
+    try {
+        const date = Temporal.PlainDate.from(value);
+        return date.dayOfWeek;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/plain/parse/parseDayOfWeekFromDateTime.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Return the day of week (1-7) for a given ISO 8601 datetime string.
+ *
+ * - Monday=1 through Sunday=7.
+ * - Returns null for invalid input.
+ *
+ * @param value ISO datetime string
+ * @returns Day of week (1-7) or null on invalid input
+ *
+ * @example parseDayOfWeekFromDateTime("2024-01-01T12:00:00") // 1 (Monday)
+ * @example parseDayOfWeekFromDateTime("2024-01-07T00:00:00") // 7 (Sunday)
+ * @example parseDayOfWeekFromDateTime("invalid") // null
+ */
+export declare function parseDayOfWeekFromDateTime(value: string): number | null;

package/dist/plain/parse/parseDayOfWeekFromDateTime.js

@@ -0,0 +1,27 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { isValidDateTime } from "../validate/index.js";
+/**
+ * Return the day of week (1-7) for a given ISO 8601 datetime string.
+ *
+ * - Monday=1 through Sunday=7.
+ * - Returns null for invalid input.
+ *
+ * @param value ISO datetime string
+ * @returns Day of week (1-7) or null on invalid input
+ *
+ * @example parseDayOfWeekFromDateTime("2024-01-01T12:00:00") // 1 (Monday)
+ * @example parseDayOfWeekFromDateTime("2024-01-07T00:00:00") // 7 (Sunday)
+ * @example parseDayOfWeekFromDateTime("invalid") // null
+ */
+export function parseDayOfWeekFromDateTime(value) {
+    if (!isValidDateTime(value)) {
+        return null;
+    }
+    try {
+        const dateTime = Temporal.PlainDateTime.from(value);
+        return dateTime.dayOfWeek;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/plain/parse/parseHourFromDateTime.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Return the hour (00-23) for a given ISO 8601 datetime string.
+ *
+ * - Returns zero-padded string for hour.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO datetime string
+ * @returns Hour (00-23) or "" on invalid input
+ *
+ * @example parseHourFromDateTime("2024-03-15T14:30:00") // "14"
+ * @example parseHourFromDateTime("2024-03-15T00:00:00") // "00"
+ * @example parseHourFromDateTime("invalid") // ""
+ */
+export declare function parseHourFromDateTime(value: string): string;

package/dist/plain/parse/parseHourFromDateTime.js

@@ -0,0 +1,26 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { isValidDateTime } from "../validate/index.js";
+/**
+ * Return the hour (00-23) for a given ISO 8601 datetime string.
+ *
+ * - Returns zero-padded string for hour.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO datetime string
+ * @returns Hour (00-23) or "" on invalid input
+ *
+ * @example parseHourFromDateTime("2024-03-15T14:30:00") // "14"
+ * @example parseHourFromDateTime("2024-03-15T00:00:00") // "00"
+ * @example parseHourFromDateTime("invalid") // ""
+ */
+export function parseHourFromDateTime(value) {
+    if (!isValidDateTime(value))
+        return "";
+    try {
+        const dateTime = Temporal.PlainDateTime.from(value);
+        return dateTime.hour.toString().padStart(2, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/parse/parseHourFromTime.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Return the hour (0-23) for a given ISO 8601 time string.
+ *
+ * - Returns zero-padded string for hour.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO time string
+ * @returns Hour (00-23) or "" on invalid input
+ *
+ * @example parseHourFromTime("12:30:00") // "12"
+ * @example parseHourFromTime("invalid") // ""
+ */
+export declare function parseHourFromTime(value: string): string;

package/dist/plain/parse/parseHourFromTime.js

@@ -0,0 +1,25 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { isValidTime } from "../validate/index.js";
+/**
+ * Return the hour (0-23) for a given ISO 8601 time string.
+ *
+ * - Returns zero-padded string for hour.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO time string
+ * @returns Hour (00-23) or "" on invalid input
+ *
+ * @example parseHourFromTime("12:30:00") // "12"
+ * @example parseHourFromTime("invalid") // ""
+ */
+export function parseHourFromTime(value) {
+    if (!isValidTime(value))
+        return "";
+    try {
+        const time = Temporal.PlainTime.from(value);
+        return time.hour.toString().padStart(2, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/parse/parseMicrosecondFromDateTime.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Return the microsecond (0-999) for a given ISO 8601 datetime string.
+ *
+ * - Returns zero-padded string for microsecond.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO datetime string
+ * @returns Microsecond (000-999) or "" on invalid input
+ *
+ * @example parseMicrosecondFromDateTime("2024-03-15T14:30:45.123") // "123"
+ * @example parseMicrosecondFromDateTime("2024-03-15T14:30:45.000") // "000"
+ * @example parseMicrosecondFromDateTime("invalid") // ""
+ */
+export declare function parseMicrosecondFromDateTime(value: string): string;

package/dist/plain/parse/parseMicrosecondFromDateTime.js

@@ -0,0 +1,26 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { isValidDateTime } from "../validate/index.js";
+/**
+ * Return the microsecond (0-999) for a given ISO 8601 datetime string.
+ *
+ * - Returns zero-padded string for microsecond.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO datetime string
+ * @returns Microsecond (000-999) or "" on invalid input
+ *
+ * @example parseMicrosecondFromDateTime("2024-03-15T14:30:45.123") // "123"
+ * @example parseMicrosecondFromDateTime("2024-03-15T14:30:45.000") // "000"
+ * @example parseMicrosecondFromDateTime("invalid") // ""
+ */
+export function parseMicrosecondFromDateTime(value) {
+    if (!isValidDateTime(value))
+        return "";
+    try {
+        const dateTime = Temporal.PlainDateTime.from(value);
+        return dateTime.microsecond.toString().padStart(3, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/parse/parseMicrosecondFromTime.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Return the microsecond (0-999) for a given ISO 8601 time string.
+ *
+ * @param value ISO time string
+ * @returns Microsecond (000-999) or "" on invalid input
+ *
+ * @example parseMicrosecondFromTime("12:30:45.123") // "123"
+ * @example parseMicrosecondFromTime("12:30:45.000") // "000"
+ * @example parseMicrosecondFromTime("invalid") // ""
+ */
+export declare function parseMicrosecondFromTime(value: string): string;

package/dist/plain/parse/parseMicrosecondFromTime.js

@@ -0,0 +1,23 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { isValidTime } from "../validate/index.js";
+/**
+ * Return the microsecond (0-999) for a given ISO 8601 time string.
+ *
+ * @param value ISO time string
+ * @returns Microsecond (000-999) or "" on invalid input
+ *
+ * @example parseMicrosecondFromTime("12:30:45.123") // "123"
+ * @example parseMicrosecondFromTime("12:30:45.000") // "000"
+ * @example parseMicrosecondFromTime("invalid") // ""
+ */
+export function parseMicrosecondFromTime(value) {
+    if (!isValidTime(value))
+        return "";
+    try {
+        const time = Temporal.PlainTime.from(value);
+        return time.microsecond.toString().padStart(3, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/parse/parseMillisecondFromDateTime.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Return the millisecond (0-999) for a given ISO 8601 datetime string.
+ *
+ * - Returns zero-padded string for millisecond.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO datetime string
+ * @returns Millisecond (000-999) or "" on invalid input
+ *
+ * @example parseMillisecondFromDateTime("2024-03-15T14:30:45.123") // "123"
+ * @example parseMillisecondFromDateTime("2024-03-15T14:30:45.000") // "000"
+ * @example parseMillisecondFromDateTime("invalid") // ""
+ */
+export declare function parseMillisecondFromDateTime(value: string): string;

package/dist/plain/parse/parseMillisecondFromDateTime.js

@@ -0,0 +1,26 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { isValidDateTime } from "../validate/index.js";
+/**
+ * Return the millisecond (0-999) for a given ISO 8601 datetime string.
+ *
+ * - Returns zero-padded string for millisecond.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO datetime string
+ * @returns Millisecond (000-999) or "" on invalid input
+ *
+ * @example parseMillisecondFromDateTime("2024-03-15T14:30:45.123") // "123"
+ * @example parseMillisecondFromDateTime("2024-03-15T14:30:45.000") // "000"
+ * @example parseMillisecondFromDateTime("invalid") // ""
+ */
+export function parseMillisecondFromDateTime(value) {
+    if (!isValidDateTime(value))
+        return "";
+    try {
+        const dateTime = Temporal.PlainDateTime.from(value);
+        return dateTime.millisecond.toString().padStart(3, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/parse/parseMillisecondFromTime.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Return the millisecond (0-999) for a given ISO 8601 time string.
+ *
+ * - Returns zero-padded string for millisecond.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO time string
+ * @returns Millisecond (000-999) or "" on invalid input
+ *
+ * @example parseMillisecondFromTime("12:30:45.123") // "123"
+ * @example parseMillisecondFromTime("12:30:45.000") // "000"
+ * @example parseMillisecondFromTime("invalid") // ""
+ */
+export declare function parseMillisecondFromTime(value: string): string;

package/dist/plain/parse/parseMillisecondFromTime.js

@@ -0,0 +1,26 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { isValidTime } from "../validate/index.js";
+/**
+ * Return the millisecond (0-999) for a given ISO 8601 time string.
+ *
+ * - Returns zero-padded string for millisecond.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO time string
+ * @returns Millisecond (000-999) or "" on invalid input
+ *
+ * @example parseMillisecondFromTime("12:30:45.123") // "123"
+ * @example parseMillisecondFromTime("12:30:45.000") // "000"
+ * @example parseMillisecondFromTime("invalid") // ""
+ */
+export function parseMillisecondFromTime(value) {
+    if (!isValidTime(value))
+        return "";
+    try {
+        const time = Temporal.PlainTime.from(value);
+        return time.millisecond.toString().padStart(3, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/parse/parseMinuteFromDateTime.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Return the minute (0-59) for a given ISO 8601 datetime string.
+ *
+ * - Returns zero-padded string for minute.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO datetime string
+ * @returns Minute (00-59) or "" on invalid input
+ *
+ * @example parseMinuteFromDateTime("2024-03-15T14:30:45") // "30"
+ * @example parseMinuteFromDateTime("2024-03-15T14:00:00") // "00"
+ * @example parseMinuteFromDateTime("invalid") // ""
+ */
+export declare function parseMinuteFromDateTime(value: string): string;

package/dist/plain/parse/parseMinuteFromDateTime.js

@@ -0,0 +1,26 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { isValidDateTime } from "../validate/index.js";
+/**
+ * Return the minute (0-59) for a given ISO 8601 datetime string.
+ *
+ * - Returns zero-padded string for minute.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO datetime string
+ * @returns Minute (00-59) or "" on invalid input
+ *
+ * @example parseMinuteFromDateTime("2024-03-15T14:30:45") // "30"
+ * @example parseMinuteFromDateTime("2024-03-15T14:00:00") // "00"
+ * @example parseMinuteFromDateTime("invalid") // ""
+ */
+export function parseMinuteFromDateTime(value) {
+    if (!isValidDateTime(value))
+        return "";
+    try {
+        const dateTime = Temporal.PlainDateTime.from(value);
+        return dateTime.minute.toString().padStart(2, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/parse/parseMinuteFromTime.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Return the minute (0-59) for a given ISO 8601 time string.
+ *
+ * - Returns zero-padded string for minute.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO time string
+ * @returns Minute (00-59) or "" on invalid input
+ *
+ * @example parseMinuteFromTime("12:30:00") // "30"
+ * @example parseMinuteFromTime("12:00:00") // "00"
+ * @example parseMinuteFromTime("invalid") // ""
+ */
+export declare function parseMinuteFromTime(value: string): string;

package/dist/plain/parse/parseMinuteFromTime.js

@@ -0,0 +1,26 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { isValidTime } from "../validate/index.js";
+/**
+ * Return the minute (0-59) for a given ISO 8601 time string.
+ *
+ * - Returns zero-padded string for minute.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO time string
+ * @returns Minute (00-59) or "" on invalid input
+ *
+ * @example parseMinuteFromTime("12:30:00") // "30"
+ * @example parseMinuteFromTime("12:00:00") // "00"
+ * @example parseMinuteFromTime("invalid") // ""
+ */
+export function parseMinuteFromTime(value) {
+    if (!isValidTime(value))
+        return "";
+    try {
+        const time = Temporal.PlainTime.from(value);
+        return time.minute.toString().padStart(2, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/parse/parseMonthFromDate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Return the month (1-12) for a given ISO 8601 date string.
+ *
+ * - Returns zero-padded string for month.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO date string
+ * @returns Month (01-12) or "" on invalid input
+ *
+ * @example parseMonthFromDate("2024-03-15") // "03"
+ * @example parseMonthFromDate("invalid") // ""
+ */
+export declare function parseMonthFromDate(value: string): string;

package/dist/plain/parse/parseMonthFromDate.js

@@ -0,0 +1,25 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { isValidDate } from "../validate/index.js";
+/**
+ * Return the month (1-12) for a given ISO 8601 date string.
+ *
+ * - Returns zero-padded string for month.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO date string
+ * @returns Month (01-12) or "" on invalid input
+ *
+ * @example parseMonthFromDate("2024-03-15") // "03"
+ * @example parseMonthFromDate("invalid") // ""
+ */
+export function parseMonthFromDate(value) {
+    if (!isValidDate(value))
+        return "";
+    try {
+        const date = Temporal.PlainDate.from(value);
+        return date.month.toString().padStart(2, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/parse/parseMonthFromDateTime.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Return the month (1-12) for a given ISO 8601 datetime string.
+ *
+ * - Returns zero-padded string for month.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO datetime string
+ * @returns Month (01-12) or "" on invalid input
+ *
+ * @example parseMonthFromDateTime("2024-03-15T12:30:00") // "03"
+ * @example parseMonthFromDateTime("invalid") // ""
+ */
+export declare function parseMonthFromDateTime(value: string): string;