@northguild/gmt 1.18.0 → 1.20.0

package/dist/plain/parse/parseHourFromTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidTime } from "../validate/index.js";
 /**
  * Return the hour (0-23) for a given ISO 8601 time string.

package/dist/plain/parse/parseMicrosecondFromDateTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDateTime } from "../validate/index.js";
 /**
  * Return the microsecond (0-999) for a given ISO 8601 datetime string.

package/dist/plain/parse/parseMicrosecondFromTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidTime } from "../validate/index.js";
 /**
  * Return the microsecond (0-999) for a given ISO 8601 time string.

package/dist/plain/parse/parseMillisecondFromDateTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDateTime } from "../validate/index.js";
 /**
  * Return the millisecond (0-999) for a given ISO 8601 datetime string.

package/dist/plain/parse/parseMillisecondFromTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidTime } from "../validate/index.js";
 /**
  * Return the millisecond (0-999) for a given ISO 8601 time string.

package/dist/plain/parse/parseMinuteFromDateTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDateTime } from "../validate/index.js";
 /**
  * Return the minute (0-59) for a given ISO 8601 datetime string.

package/dist/plain/parse/parseMinuteFromTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidTime } from "../validate/index.js";
 /**
  * Return the minute (0-59) for a given ISO 8601 time string.

package/dist/plain/parse/parseMonthFromDate.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDate } from "../validate/index.js";
 /**
  * Return the month (1-12) for a given ISO 8601 date string.

package/dist/plain/parse/parseMonthFromDateTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDateTime } from "../validate/index.js";
 /**
  * Return the month (1-12) for a given ISO 8601 datetime string.

package/dist/plain/parse/parseNanosecondFromDateTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDateTime } from "../validate/index.js";
 /**
  * Return the nanosecond (0-999) for a given ISO 8601 datetime string.

package/dist/plain/parse/parseNanosecondFromTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidTime } from "../validate/index.js";
 /**
  * Return the nanosecond (0-999) for a given ISO 8601 time string.

package/dist/plain/parse/parseSecondFromDateTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDateTime } from "../validate/index.js";
 /**
  * Return the second (0-59) for a given ISO 8601 datetime string.

package/dist/plain/parse/parseSecondFromTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidTime } from "../validate/index.js";
 /**
  * Return the second (0-59) for a given ISO 8601 time string.

package/dist/plain/parse/{parseSql.d.ts → parseSqlDateTime.d.ts}

@@ -8,7 +8,7 @@
  *   two-digit month, day, hour, minute and second (seconds are required), and an optional `.`
  *   followed by up to 9 fraction digits.
  * - **Plain only.** SQL's offset-carrying `TIMESTAMP WITH TIME ZONE` literal is out of scope; see
- *   `formatSql`'s JSDoc.
+ *   `formatSqlDateTime`'s JSDoc.
  * - The fraction is written as `Temporal.PlainDateTime#toString` writes it: trailing zeros are
  *   dropped (`.500` → `.5`, `.000` → none), and a `.` with no digits is dropped. `Temporal.PlainDateTime.from`
  *   proves the value is a real calendar date and time.
@@ -16,11 +16,11 @@
  * @param value SQL timestamp literal (e.g. "2024-03-15 14:30:00")
  * @returns plain ISO 8601 datetime string, or "" on invalid input
  *
- * @example parseSql("2024-03-15 14:30:00") // "2024-03-15T14:30:00"
- * @example parseSql("2024-03-15 14:30:00.5") // "2024-03-15T14:30:00.5"
- * @example parseSql("2024-03-15 14:30") // "" (seconds are required)
- * @example parseSql("0000-01-01 00:00:00") // "" (year outside 0001–9999)
- * @example parseSql("2024-03-15T14:30:00") // "" (wrong separator)
- * @example parseSql("not a date") // ""
+ * @example parseSqlDateTime("2024-03-15 14:30:00") // "2024-03-15T14:30:00"
+ * @example parseSqlDateTime("2024-03-15 14:30:00.5") // "2024-03-15T14:30:00.5"
+ * @example parseSqlDateTime("2024-03-15 14:30") // "" (seconds are required)
+ * @example parseSqlDateTime("0000-01-01 00:00:00") // "" (year outside 0001–9999)
+ * @example parseSqlDateTime("2024-03-15T14:30:00") // "" (wrong separator)
+ * @example parseSqlDateTime("not a date") // ""
  */
-export declare function parseSql(value: string): string;
+export declare function parseSqlDateTime(value: string): string;

package/dist/plain/parse/{parseSql.js → parseSqlDateTime.js}

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { sqlDateTime } from "../../regex/index.js";
 /**
  * Parse a SQL timestamp literal without a time zone — the `YYYY-MM-DD HH:MM:SS[.fff]` form of
@@ -10,7 +10,7 @@ import { sqlDateTime } from "../../regex/index.js";
  *   two-digit month, day, hour, minute and second (seconds are required), and an optional `.`
  *   followed by up to 9 fraction digits.
  * - **Plain only.** SQL's offset-carrying `TIMESTAMP WITH TIME ZONE` literal is out of scope; see
- *   `formatSql`'s JSDoc.
+ *   `formatSqlDateTime`'s JSDoc.
  * - The fraction is written as `Temporal.PlainDateTime#toString` writes it: trailing zeros are
  *   dropped (`.500` → `.5`, `.000` → none), and a `.` with no digits is dropped. `Temporal.PlainDateTime.from`
  *   proves the value is a real calendar date and time.
@@ -18,14 +18,14 @@ import { sqlDateTime } from "../../regex/index.js";
  * @param value SQL timestamp literal (e.g. "2024-03-15 14:30:00")
  * @returns plain ISO 8601 datetime string, or "" on invalid input
  *
- * @example parseSql("2024-03-15 14:30:00") // "2024-03-15T14:30:00"
- * @example parseSql("2024-03-15 14:30:00.5") // "2024-03-15T14:30:00.5"
- * @example parseSql("2024-03-15 14:30") // "" (seconds are required)
- * @example parseSql("0000-01-01 00:00:00") // "" (year outside 0001–9999)
- * @example parseSql("2024-03-15T14:30:00") // "" (wrong separator)
- * @example parseSql("not a date") // ""
+ * @example parseSqlDateTime("2024-03-15 14:30:00") // "2024-03-15T14:30:00"
+ * @example parseSqlDateTime("2024-03-15 14:30:00.5") // "2024-03-15T14:30:00.5"
+ * @example parseSqlDateTime("2024-03-15 14:30") // "" (seconds are required)
+ * @example parseSqlDateTime("0000-01-01 00:00:00") // "" (year outside 0001–9999)
+ * @example parseSqlDateTime("2024-03-15T14:30:00") // "" (wrong separator)
+ * @example parseSqlDateTime("not a date") // ""
  */
-export function parseSql(value) {
+export function parseSqlDateTime(value) {
     if (typeof value !== "string")
         return "";
     if (!sqlDateTime.test(value))

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

@@ -33,9 +33,11 @@
  *   `"o'clock"`. A quote that never closes makes the pattern malformed
  *   (`""`). Any other character that is not a letter (`: , space`,
  *   digits and so on) is a literal with no quoting.
- * - `a` is locale-aware. If `locale` is omitted and the pattern uses
- *   `a`, GMT defaults to `"en-US"` rather than returning `""` for every
- *   caller who didn't have another locale in mind.
+ * - `a` is locale-aware. If `locale` is omitted (or an empty list) and
+ *   the pattern uses `a`, GMT reads the English labels in `"en"`, the
+ *   language with no region, rather than returning `""`. CLDR gives
+ *   `"en"` the same AM and PM labels as `"en-US"`. Pass `locale` for any
+ *   other language.
  * - `h`/`hh` resolve to 24-hour using a matched `a` token: if the label
  *   is the PM label and hour !== 12, add 12; if the AM label and hour
  *   === 12, set hour to 0. With no `a` token in the pattern at all, the
@@ -48,7 +50,7 @@
  *
  * @param value The string to decode (e.g. "02:30:45 PM")
  * @param pattern The token pattern describing `value`'s shape (e.g. "hh:mm:ss a")
- * @param locale Optional BCP 47 locale tag, or a preference list of tags, for the meridiem token (default "en-US")
+ * @param locale Optional BCP 47 locale tag, or a preference list of tags, for the meridiem token (default "en")
  * @returns ISO `PlainTime` string, or "" on no match, malformed pattern, or invalid input
  *
  * @example parseTimeWithPattern("14:30:45", "HH:mm:ss") // "14:30:45"

package/dist/plain/parse/parseTimeWithPattern.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { parseValueWithPattern, TIME_PATTERN_FIELDS } from "../../internal/index.js";
 /**
  * Parse a time string against a caller-supplied token pattern (e.g.
@@ -35,9 +35,11 @@ import { parseValueWithPattern, TIME_PATTERN_FIELDS } from "../../internal/index
  *   `"o'clock"`. A quote that never closes makes the pattern malformed
  *   (`""`). Any other character that is not a letter (`: , space`,
  *   digits and so on) is a literal with no quoting.
- * - `a` is locale-aware. If `locale` is omitted and the pattern uses
- *   `a`, GMT defaults to `"en-US"` rather than returning `""` for every
- *   caller who didn't have another locale in mind.
+ * - `a` is locale-aware. If `locale` is omitted (or an empty list) and
+ *   the pattern uses `a`, GMT reads the English labels in `"en"`, the
+ *   language with no region, rather than returning `""`. CLDR gives
+ *   `"en"` the same AM and PM labels as `"en-US"`. Pass `locale` for any
+ *   other language.
  * - `h`/`hh` resolve to 24-hour using a matched `a` token: if the label
  *   is the PM label and hour !== 12, add 12; if the AM label and hour
  *   === 12, set hour to 0. With no `a` token in the pattern at all, the
@@ -50,7 +52,7 @@ import { parseValueWithPattern, TIME_PATTERN_FIELDS } from "../../internal/index
  *
  * @param value The string to decode (e.g. "02:30:45 PM")
  * @param pattern The token pattern describing `value`'s shape (e.g. "hh:mm:ss a")
- * @param locale Optional BCP 47 locale tag, or a preference list of tags, for the meridiem token (default "en-US")
+ * @param locale Optional BCP 47 locale tag, or a preference list of tags, for the meridiem token (default "en")
  * @returns ISO `PlainTime` string, or "" on no match, malformed pattern, or invalid input
  *
  * @example parseTimeWithPattern("14:30:45", "HH:mm:ss") // "14:30:45"
@@ -66,6 +68,7 @@ export function parseTimeWithPattern(value, pattern, locale) {
             return "";
         if (typeof pattern !== "string")
             return "";
+        // A time pattern has no year token, so no two-digit-year window applies.
         const fields = parseValueWithPattern(value, pattern, locale, TIME_PATTERN_FIELDS);
         if (fields === null)
             return "";

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

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return a specific date unit extracted from a PlainDate string.
  *
@@ -9,6 +9,8 @@ import { Temporal } from "@js-temporal/polyfill";
  * - `optionsArg` must be an object or omitted: `null` or any other primitive returns "", as
  *   Temporal's GetOptionsObject rejects it.
  * - Returns "" for invalid input.
+ * - The `"year"` unit is written as Temporal writes a year: four digits (`"2024"`, `"0005"`), or a
+ *   sign and six digits outside 0000–9999 (`"+010000"`, `"-000005"`).
  *
  * @param value ISO PlainDate string
  * @param unit unit to extract from the date
@@ -16,6 +18,7 @@ import { Temporal } from "@js-temporal/polyfill";
  * @returns string representation of the requested unit or "" on invalid input
  *
  * @example parseUnitFromDate("2024-03-15", "year") // "2024"
+ * @example parseUnitFromDate("0005-06-01", "year") // "0005"
  * @example parseUnitFromDate("2024-03-15", "month") // "03"
  * @example parseUnitFromDate("2024-03-15", "day") // "15"
  * @example parseUnitFromDate("2024-03-15", "week") // "11"

package/dist/plain/parse/parseUnitFromDate.js

@@ -1,9 +1,10 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { resolveDateTimeUnit } from "../../internal/resolveDateTimeUnit.js";
 import { resolveWeekStartsOn } from "../../internal/resolveWeekStartsOn.js";
 import { getWeekNumber } from "../calculate/getWeekNumber.js";
 import { isValidDate } from "../validate/index.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
+import { isoYearString } from "../../internal/isoYearString.js";
 /**
  * Return a specific date unit extracted from a PlainDate string.
  *
@@ -14,6 +15,8 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * - `optionsArg` must be an object or omitted: `null` or any other primitive returns "", as
  *   Temporal's GetOptionsObject rejects it.
  * - Returns "" for invalid input.
+ * - The `"year"` unit is written as Temporal writes a year: four digits (`"2024"`, `"0005"`), or a
+ *   sign and six digits outside 0000–9999 (`"+010000"`, `"-000005"`).
  *
  * @param value ISO PlainDate string
  * @param unit unit to extract from the date
@@ -21,6 +24,7 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * @returns string representation of the requested unit or "" on invalid input
  *
  * @example parseUnitFromDate("2024-03-15", "year") // "2024"
+ * @example parseUnitFromDate("0005-06-01", "year") // "0005"
  * @example parseUnitFromDate("2024-03-15", "month") // "03"
  * @example parseUnitFromDate("2024-03-15", "day") // "15"
  * @example parseUnitFromDate("2024-03-15", "week") // "11"
@@ -44,7 +48,7 @@ export function parseUnitFromDate(value, unit, optionsArg) {
             const date = Temporal.PlainDate.from(value);
             switch (resolveDateTimeUnit(unit)) {
                 case "year":
-                    return date.year.toString();
+                    return isoYearString(date.year);
                 case "month":
                     return date.month.toString().padStart(2, "0");
                 case "day":

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

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return a specific unit extracted from a PlainDateTime string.
  *
@@ -11,6 +11,8 @@ import { Temporal } from "@js-temporal/polyfill";
  * - `optionsArg` must be an object or omitted: `null` or any other primitive returns "", as
  *   Temporal's GetOptionsObject rejects it.
  * - Returns "" for invalid input.
+ * - The `"year"` unit is written as Temporal writes a year: four digits (`"2024"`, `"0005"`), or a
+ *   sign and six digits outside 0000–9999 (`"+010000"`, `"-000005"`).
  *
  * @param value ISO PlainDateTime string
  * @param unit unit to extract from the datetime
@@ -18,6 +20,7 @@ import { Temporal } from "@js-temporal/polyfill";
  * @returns string representation of the requested unit or "" on invalid input
  *
  * @example parseUnitFromDateTime("2024-03-15T14:30:45.123", "year") // "2024"
+ * @example parseUnitFromDateTime("0005-06-01T12:30:00", "year") // "0005"
  * @example parseUnitFromDateTime("2024-03-15T14:30:45.123", "week") // "11"
  * @example parseUnitFromDateTime("2024-03-15T14:30:45.123", "hour") // "14"
  * @example parseUnitFromDateTime("2024-03-15T14:30:45.123", "millisecond") // "123"

package/dist/plain/parse/parseUnitFromDateTime.js

@@ -1,10 +1,11 @@
 // 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 { resolveDateTimeUnit } from "../../internal/resolveDateTimeUnit.js";
 import { resolveWeekStartsOn } from "../../internal/resolveWeekStartsOn.js";
 import { getWeekNumber } from "../calculate/getWeekNumber.js";
 import { isValidDateTime } from "../validate/index.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
+import { isoYearString } from "../../internal/isoYearString.js";
 /**
  * Return a specific unit extracted from a PlainDateTime string.
  *
@@ -17,6 +18,8 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * - `optionsArg` must be an object or omitted: `null` or any other primitive returns "", as
  *   Temporal's GetOptionsObject rejects it.
  * - Returns "" for invalid input.
+ * - The `"year"` unit is written as Temporal writes a year: four digits (`"2024"`, `"0005"`), or a
+ *   sign and six digits outside 0000–9999 (`"+010000"`, `"-000005"`).
  *
  * @param value ISO PlainDateTime string
  * @param unit unit to extract from the datetime
@@ -24,6 +27,7 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * @returns string representation of the requested unit or "" on invalid input
  *
  * @example parseUnitFromDateTime("2024-03-15T14:30:45.123", "year") // "2024"
+ * @example parseUnitFromDateTime("0005-06-01T12:30:00", "year") // "0005"
  * @example parseUnitFromDateTime("2024-03-15T14:30:45.123", "week") // "11"
  * @example parseUnitFromDateTime("2024-03-15T14:30:45.123", "hour") // "14"
  * @example parseUnitFromDateTime("2024-03-15T14:30:45.123", "millisecond") // "123"
@@ -45,7 +49,7 @@ export function parseUnitFromDateTime(value, unit, optionsArg) {
             const dateTime = Temporal.PlainDateTime.from(value);
             switch (resolveDateTimeUnit(unit)) {
                 case "year":
-                    return dateTime.year.toString();
+                    return isoYearString(dateTime.year);
                 case "month":
                     return dateTime.month.toString().padStart(2, "0");
                 case "day":

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

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return a specific time unit extracted from a PlainTime string.
  *

package/dist/plain/parse/parseUnitFromTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { resolveDateTimeUnit } from "../../internal/resolveDateTimeUnit.js";
 import { isValidTime } from "../validate/index.js";
 /**

package/dist/plain/parse/parseWeekFromDateTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { resolveWeekStartsOn } from "../../internal/resolveWeekStartsOn.js";
 import { getWeekNumber } from "../calculate/getWeekNumber.js";
 import { isValidDateTime } from "../validate/index.js";

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

@@ -1,13 +1,16 @@
 /**
  * Return the year for a given ISO 8601 date string.
  *
- * - Returns the year as a string (e.g., "2024").
+ * - Returns the year as Temporal writes it: four digits (`"2024"`, `"0005"`), or a sign and six
+ *   digits outside 0000–9999 (`"+010000"`, `"-000005"`).
  * - Returns "" for invalid input.
  *
  * @param value ISO date string
- * @returns Year (YYYY) or "" on invalid input
+ * @returns the year as four digits, or a sign and six digits outside 0000–9999, or "" on invalid input
  *
  * @example parseYearFromDate("2024-03-15") // "2024"
+ * @example parseYearFromDate("0005-06-01") // "0005"
+ * @example parseYearFromDate("+010000-01-01") // "+010000"
  * @example parseYearFromDate("invalid") // ""
  */
 export declare function parseYearFromDate(value: string): string;

package/dist/plain/parse/parseYearFromDate.js

@@ -1,15 +1,19 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDate } from "../validate/index.js";
+import { isoYearString } from "../../internal/isoYearString.js";
 /**
  * Return the year for a given ISO 8601 date string.
  *
- * - Returns the year as a string (e.g., "2024").
+ * - Returns the year as Temporal writes it: four digits (`"2024"`, `"0005"`), or a sign and six
+ *   digits outside 0000–9999 (`"+010000"`, `"-000005"`).
  * - Returns "" for invalid input.
  *
  * @param value ISO date string
- * @returns Year (YYYY) or "" on invalid input
+ * @returns the year as four digits, or a sign and six digits outside 0000–9999, or "" on invalid input
  *
  * @example parseYearFromDate("2024-03-15") // "2024"
+ * @example parseYearFromDate("0005-06-01") // "0005"
+ * @example parseYearFromDate("+010000-01-01") // "+010000"
  * @example parseYearFromDate("invalid") // ""
  */
 export function parseYearFromDate(value) {
@@ -17,7 +21,7 @@ export function parseYearFromDate(value) {
         return "";
     try {
         const date = Temporal.PlainDate.from(value);
-        return date.year.toString();
+        return isoYearString(date.year);
     }
     catch {
         return "";

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

@@ -1,13 +1,15 @@
 /**
  * Return the year for a given ISO 8601 datetime string.
  *
- * - Returns the year as a string (e.g., "2024").
+ * - Returns the year as Temporal writes it: four digits (`"2024"`, `"0005"`), or a sign and six
+ *   digits outside 0000–9999 (`"+010000"`, `"-000005"`).
  * - Returns "" for invalid input.
  *
  * @param value ISO datetime string
- * @returns Year (YYYY) or "" on invalid input
+ * @returns the year as four digits, or a sign and six digits outside 0000–9999, or "" on invalid input
  *
  * @example parseYearFromDateTime("2024-03-15T12:30:00") // "2024"
+ * @example parseYearFromDateTime("0005-06-01T12:30:00") // "0005"
  * @example parseYearFromDateTime("invalid") // ""
  */
 export declare function parseYearFromDateTime(value: string): string;

package/dist/plain/parse/parseYearFromDateTime.js

@@ -1,15 +1,18 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDateTime } from "../validate/index.js";
+import { isoYearString } from "../../internal/isoYearString.js";
 /**
  * Return the year for a given ISO 8601 datetime string.
  *
- * - Returns the year as a string (e.g., "2024").
+ * - Returns the year as Temporal writes it: four digits (`"2024"`, `"0005"`), or a sign and six
+ *   digits outside 0000–9999 (`"+010000"`, `"-000005"`).
  * - Returns "" for invalid input.
  *
  * @param value ISO datetime string
- * @returns Year (YYYY) or "" on invalid input
+ * @returns the year as four digits, or a sign and six digits outside 0000–9999, or "" on invalid input
  *
  * @example parseYearFromDateTime("2024-03-15T12:30:00") // "2024"
+ * @example parseYearFromDateTime("0005-06-01T12:30:00") // "0005"
  * @example parseYearFromDateTime("invalid") // ""
  */
 export function parseYearFromDateTime(value) {
@@ -17,7 +20,7 @@ export function parseYearFromDateTime(value) {
         return "";
     try {
         const dateTime = Temporal.PlainDateTime.from(value);
-        return dateTime.year.toString();
+        return isoYearString(dateTime.year);
     }
     catch {
         return "";

package/dist/plain/validate/{isLeapSecond.d.ts → hasSecond60.d.ts}

@@ -5,7 +5,8 @@
  *   `:59`. It does not check the IERS leap-second list: a real leap second exists only at
  *   23:59:60 UTC at the end of a month in which one was inserted (RFC 3339 §5.7), so
  *   `"2024-12-31T23:59:60Z"` (no leap second that day, IERS Bulletin C 68) and
- *   `"2024-06-15T12:34:60Z"` both return true.
+ *   `"2024-06-15T12:34:60Z"` both return true. It does not check that one was inserted on that
+ *   day; for that, use `isLeapSecond` from `timescale/`.
  * - Matches a seconds field of `60` with any date, time of day or offset, or none, for example
  *   "YYYY-MM-DDT23:59:60Z", "YYYY-MM-DDT23:59:60+00:00", "YYYY-MM-DDT23:59:60" or "23:59:60".
  * - Accepts optional fractional seconds.
@@ -13,22 +14,23 @@
  *   extended or basic digits, a bare time with or without a `T` designator, and a designator,
  *   annotation or nothing after the second. Temporal silently clamps each of them to `:59`, so
  *   each is a leap second GMT has to catch. A `[key=value]` annotation value is never read as a time.
- * - Compatibility: earlier releases recognised only an uppercase `T` with extended digits. To
- *   keep that narrower test, match `/T\d{2}:\d{2}:60(?:[.,]\d+)?[-+Zz[]/` yourself.
+ * - **Compatibility:** earlier releases of this test (named `isLeapSecond`) recognised only an
+ *   uppercase `T` with extended digits. To keep that narrower test, match
+ *   `/T\d{2}:\d{2}:60(?:[.,]\d+)?[-+Zz[]/` yourself.
  *
  * @param value ISO date-time or time string
  * @returns true when the string has a second-60 field, otherwise false
  *
- * @example isLeapSecond("2016-12-31T23:59:60Z") // true
- * @example isLeapSecond("2016-12-31T23:59:60.123Z") // true
- * @example isLeapSecond("2016-12-31T23:59:60+00:00") // true
- * @example isLeapSecond("2016-12-31T23:59:60.123+00:00") // true
- * @example isLeapSecond("2016-12-31t23:59:60Z") // true (lowercase t)
- * @example isLeapSecond("20161231 235960Z") // true (space separator, basic format)
- * @example isLeapSecond("2016-12-31T23:59:60") // true (no designator; PlainDateTime clamps it)
- * @example isLeapSecond("23:59:60") // true (a time; PlainTime clamps it)
- * @example isLeapSecond("2016-12-31T23:59:59Z") // false
- * @example isLeapSecond("2024-06-15T12:34:60Z") // true (syntactic: no leap second can occur here)
+ * @example hasSecond60("2016-12-31T23:59:60Z") // true
+ * @example hasSecond60("2016-12-31T23:59:60.123Z") // true
+ * @example hasSecond60("2016-12-31T23:59:60+00:00") // true
+ * @example hasSecond60("2016-12-31T23:59:60.123+00:00") // true
+ * @example hasSecond60("2016-12-31t23:59:60Z") // true (lowercase t)
+ * @example hasSecond60("20161231 235960Z") // true (space separator, basic format)
+ * @example hasSecond60("2016-12-31T23:59:60") // true (no designator; PlainDateTime clamps it)
+ * @example hasSecond60("23:59:60") // true (a time; PlainTime clamps it)
+ * @example hasSecond60("2016-12-31T23:59:59Z") // false
+ * @example hasSecond60("2024-06-15T12:34:60Z") // true (syntactic: no leap second can occur here)
  * @example /T\d{2}:\d{2}:60(?:[.,]\d+)?[-+Zz[]/.test("2016-12-31t23:59:60Z") // false (the earlier uppercase-T-only test)
  */
-export declare function isLeapSecond(value: string): boolean;
+export declare function hasSecond60(value: string): boolean;

package/dist/plain/validate/{isLeapSecond.js → hasSecond60.js}

@@ -6,7 +6,8 @@ import { leapSecond } from "../../regex/leap-second.js";
  *   `:59`. It does not check the IERS leap-second list: a real leap second exists only at
  *   23:59:60 UTC at the end of a month in which one was inserted (RFC 3339 §5.7), so
  *   `"2024-12-31T23:59:60Z"` (no leap second that day, IERS Bulletin C 68) and
- *   `"2024-06-15T12:34:60Z"` both return true.
+ *   `"2024-06-15T12:34:60Z"` both return true. It does not check that one was inserted on that
+ *   day; for that, use `isLeapSecond` from `timescale/`.
  * - Matches a seconds field of `60` with any date, time of day or offset, or none, for example
  *   "YYYY-MM-DDT23:59:60Z", "YYYY-MM-DDT23:59:60+00:00", "YYYY-MM-DDT23:59:60" or "23:59:60".
  * - Accepts optional fractional seconds.
@@ -14,25 +15,26 @@ import { leapSecond } from "../../regex/leap-second.js";
  *   extended or basic digits, a bare time with or without a `T` designator, and a designator,
  *   annotation or nothing after the second. Temporal silently clamps each of them to `:59`, so
  *   each is a leap second GMT has to catch. A `[key=value]` annotation value is never read as a time.
- * - Compatibility: earlier releases recognised only an uppercase `T` with extended digits. To
- *   keep that narrower test, match `/T\d{2}:\d{2}:60(?:[.,]\d+)?[-+Zz[]/` yourself.
+ * - **Compatibility:** earlier releases of this test (named `isLeapSecond`) recognised only an
+ *   uppercase `T` with extended digits. To keep that narrower test, match
+ *   `/T\d{2}:\d{2}:60(?:[.,]\d+)?[-+Zz[]/` yourself.
  *
  * @param value ISO date-time or time string
  * @returns true when the string has a second-60 field, otherwise false
  *
- * @example isLeapSecond("2016-12-31T23:59:60Z") // true
- * @example isLeapSecond("2016-12-31T23:59:60.123Z") // true
- * @example isLeapSecond("2016-12-31T23:59:60+00:00") // true
- * @example isLeapSecond("2016-12-31T23:59:60.123+00:00") // true
- * @example isLeapSecond("2016-12-31t23:59:60Z") // true (lowercase t)
- * @example isLeapSecond("20161231 235960Z") // true (space separator, basic format)
- * @example isLeapSecond("2016-12-31T23:59:60") // true (no designator; PlainDateTime clamps it)
- * @example isLeapSecond("23:59:60") // true (a time; PlainTime clamps it)
- * @example isLeapSecond("2016-12-31T23:59:59Z") // false
- * @example isLeapSecond("2024-06-15T12:34:60Z") // true (syntactic: no leap second can occur here)
+ * @example hasSecond60("2016-12-31T23:59:60Z") // true
+ * @example hasSecond60("2016-12-31T23:59:60.123Z") // true
+ * @example hasSecond60("2016-12-31T23:59:60+00:00") // true
+ * @example hasSecond60("2016-12-31T23:59:60.123+00:00") // true
+ * @example hasSecond60("2016-12-31t23:59:60Z") // true (lowercase t)
+ * @example hasSecond60("20161231 235960Z") // true (space separator, basic format)
+ * @example hasSecond60("2016-12-31T23:59:60") // true (no designator; PlainDateTime clamps it)
+ * @example hasSecond60("23:59:60") // true (a time; PlainTime clamps it)
+ * @example hasSecond60("2016-12-31T23:59:59Z") // false
+ * @example hasSecond60("2024-06-15T12:34:60Z") // true (syntactic: no leap second can occur here)
  * @example /T\d{2}:\d{2}:60(?:[.,]\d+)?[-+Zz[]/.test("2016-12-31t23:59:60Z") // false (the earlier uppercase-T-only test)
  */
-export function isLeapSecond(value) {
+export function hasSecond60(value) {
     if (typeof value !== "string") {
         return false;
     }

package/dist/plain/validate/index.d.ts

@@ -1,4 +1,4 @@
-export * from "./isLeapSecond.js";
+export * from "./hasSecond60.js";
 export * from "./isLeapYear.js";
 export * from "./isValidCalendarDate.js";
 export * from "./isValidDate.js";
@@ -12,6 +12,7 @@ export * from "./isValidDateTimeRange.js";
 export * from "./isValidDateTimeUnit.js";
 export * from "./isValidDateUnit.js";
 export * from "./isValidIsoDateLike.js";
+export * from "./isValidSqlDateTime.js";
 export * from "./isValidTime.js";
 export * from "./isValidTimeCycleField.js";
 export * from "./isValidTimeDurationUnit.js";

package/dist/plain/validate/index.js

@@ -1,4 +1,4 @@
-export * from "./isLeapSecond.js";
+export * from "./hasSecond60.js";
 export * from "./isLeapYear.js";
 export * from "./isValidCalendarDate.js";
 export * from "./isValidDate.js";
@@ -12,6 +12,7 @@ export * from "./isValidDateTimeRange.js";
 export * from "./isValidDateTimeUnit.js";
 export * from "./isValidDateUnit.js";
 export * from "./isValidIsoDateLike.js";
+export * from "./isValidSqlDateTime.js";
 export * from "./isValidTime.js";
 export * from "./isValidTimeCycleField.js";
 export * from "./isValidTimeDurationUnit.js";

package/dist/plain/validate/isLeapYear.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDate } from "./isValidDate.js";
 /**
  * Return true when the given PlainDate falls in a leap year.