@duplojs/utils 1.4.57 → 1.4.59

package/dist/date/getters/getMinute.cjs

@@ -6,15 +6,15 @@ var toNative = require('../toNative.cjs');
  * {@include date/getMinute/index.md}
  */
 function getMinute(input, timezone = "UTC") {
-    const nativeDate = toNative.toNative(input);
+    const date = toNative.toNative(input);
     if (timezone === "UTC") {
-        return nativeDate.getUTCMinutes();
+        return date.getUTCMinutes();
     }
     const formatter = new Intl.DateTimeFormat("en-US", {
         timeZone: timezone,
         minute: "numeric",
     });
-    return Number(formatter.format(nativeDate));
+    return Number(formatter.format(date));
 }
 
 exports.getMinute = getMinute;

package/dist/date/getters/getMinute.d.ts

@@ -1,26 +1,28 @@
-import { type TheDate, type Timezone } from "..";
+import type { SerializedTheDate } from "../types";
+import { type TheDate } from "../theDate";
+import { type Timezone } from "../timezone";
 /**
- * Returns the minute of a date.
+ * Returns the minute (`0` to `59`) for a date in a target timezone.
  * 
- * Signature: `getMinute(input, timezone)` → returns a value
+ * Signature: `getMinute(input, timezone?)` → `number`
  * 
- * If timezone is omitted, UTC is used.
- * 
- * The input value is not mutated.
+ * `input` accepts `TheDate` or `SerializedTheDate`. If `timezone` is omitted, UTC is used.
  * 
  * ```ts
- * const input = D.create("2024-06-20");
- * const result = D.getMinute(input);
- * // result: 0
+ * const input = D.create("2024-06-20", {
+ * 	hour: "00",
+ * 	minute: "30",
+ * });
+ * const utcMinute = D.getMinute(input);
+ * // utcMinute: 30
  * 
- * const result2 = D.getMinute(input, "Europe/Madrid");
- * // result2: 0
+ * const tokyoMinute = D.getMinute(input, "Asia/Tokyo");
+ * // tokyoMinute: 30
  * 
  * pipe(
  * 	input,
- * 	D.getMinute,
- * ); // result: 0
- * 
+ * 	(value) => D.getMinute(value, "UTC"),
+ * ); // 30
  * ```
  * 
  * @see https://utils.duplojs.dev/en/v1/api/date/getMinute
@@ -28,4 +30,4 @@ import { type TheDate, type Timezone } from "..";
  * @namespace D
  * 
  */
-export declare function getMinute<GenericInput extends TheDate>(input: GenericInput, timezone?: Timezone): number;
+export declare function getMinute<GenericInput extends TheDate | SerializedTheDate>(input: GenericInput, timezone?: Timezone): number;

package/dist/date/getters/getMinute.mjs

@@ -4,15 +4,15 @@ import { toNative } from '../toNative.mjs';
  * {@include date/getMinute/index.md}
  */
 function getMinute(input, timezone = "UTC") {
-    const nativeDate = toNative(input);
+    const date = toNative(input);
     if (timezone === "UTC") {
-        return nativeDate.getUTCMinutes();
+        return date.getUTCMinutes();
     }
     const formatter = new Intl.DateTimeFormat("en-US", {
         timeZone: timezone,
         minute: "numeric",
     });
-    return Number(formatter.format(nativeDate));
+    return Number(formatter.format(date));
 }
 
 export { getMinute };

package/dist/date/getters/getMonth.cjs

@@ -6,15 +6,15 @@ var toNative = require('../toNative.cjs');
  * {@include date/getMonth/index.md}
  */
 function getMonth(input, timezone = "UTC") {
-    const nativeDate = toNative.toNative(input);
+    const date = toNative.toNative(input);
     if (timezone === "UTC") {
-        return nativeDate.getUTCMonth() + 1;
+        return date.getUTCMonth() + 1;
     }
     const formatter = new Intl.DateTimeFormat("en-US", {
         timeZone: timezone,
         month: "numeric",
     });
-    return Number(formatter.format(nativeDate));
+    return Number(formatter.format(date));
 }
 
 exports.getMonth = getMonth;

package/dist/date/getters/getMonth.d.ts

@@ -1,31 +1,36 @@
-import { type TheDate, type Timezone } from "..";
+import type { SerializedTheDate } from "../types";
+import { type TheDate } from "../theDate";
+import type { Timezone } from "../timezone";
 /**
- * Returns the month of a date.
+ * Returns the month number (`1` to `12`) for a date in a target timezone.
  * 
- * Signature: `getMonth(input, timezone)` → returns a value
+ * Signature: `getMonth(input, timezone?)` → `number`
  * 
- * If timezone is omitted, UTC is used.
- * 
- * The input value is not mutated.
+ * `input` accepts `TheDate` or `SerializedTheDate`. If `timezone` is omitted, UTC is used.
  * 
  * ```ts
- * const input = D.create("2024-12-31");
- * const result = D.getMonth(input);
- * // result: 12
+ * const input = D.create("2024-12-31", {
+ * 	hour: "23",
+ * 	minute: "30",
+ * });
+ * const utcMonth = D.getMonth(input);
+ * // utcMonth: 12
  * 
- * const result2 = D.getMonth(input, "Asia/Tokyo");
- * // result2: 12
+ * const tokyoMonth = D.getMonth(input, "Asia/Tokyo");
+ * // tokyoMonth: 1
  * 
  * pipe(
  * 	input,
- * 	D.getMonth,
- * ); // result: 12
- * 
+ * 	(value) => D.getMonth(value, "UTC"),
+ * ); // 12
  * ```
  * 
+ * @remarks
+ * - Unlike native `Date#getMonth`, this getter is 1-based.
+ * 
  * @see https://utils.duplojs.dev/en/v1/api/date/getMonth
  * 
  * @namespace D
  * 
  */
-export declare function getMonth<GenericInput extends TheDate>(input: GenericInput, timezone?: Timezone): number;
+export declare function getMonth<GenericInput extends TheDate | SerializedTheDate>(input: GenericInput, timezone?: Timezone): number;

package/dist/date/getters/getMonth.mjs

@@ -4,15 +4,15 @@ import { toNative } from '../toNative.mjs';
  * {@include date/getMonth/index.md}
  */
 function getMonth(input, timezone = "UTC") {
-    const nativeDate = toNative(input);
+    const date = toNative(input);
     if (timezone === "UTC") {
-        return nativeDate.getUTCMonth() + 1;
+        return date.getUTCMonth() + 1;
     }
     const formatter = new Intl.DateTimeFormat("en-US", {
         timeZone: timezone,
         month: "numeric",
     });
-    return Number(formatter.format(nativeDate));
+    return Number(formatter.format(date));
 }
 
 export { getMonth };

package/dist/date/getters/getSecond.cjs

@@ -6,15 +6,15 @@ var toNative = require('../toNative.cjs');
  * {@include date/getSecond/index.md}
  */
 function getSecond(input, timezone = "UTC") {
-    const nativeDate = toNative.toNative(input);
+    const date = toNative.toNative(input);
     if (timezone === "UTC") {
-        return nativeDate.getUTCSeconds();
+        return date.getUTCSeconds();
     }
     const formatter = new Intl.DateTimeFormat("en-US", {
         timeZone: timezone,
         second: "numeric",
     });
-    return Number(formatter.format(nativeDate));
+    return Number(formatter.format(date));
 }
 
 exports.getSecond = getSecond;

package/dist/date/getters/getSecond.d.ts

@@ -1,26 +1,28 @@
-import { type TheDate, type Timezone } from "..";
+import type { SerializedTheDate } from "../types";
+import type { TheDate } from "../theDate";
+import type { Timezone } from "../timezone";
 /**
- * Returns the second of a date.
+ * Returns the second (`0` to `59`) for a date in a target timezone.
  * 
- * Signature: `getSecond(input, timezone)` → returns a value
+ * Signature: `getSecond(input, timezone?)` → `number`
  * 
- * If timezone is omitted, UTC is used.
- * 
- * The input value is not mutated.
+ * `input` accepts `TheDate` or `SerializedTheDate`. If `timezone` is omitted, UTC is used.
  * 
  * ```ts
- * const input = D.create("2024-06-20");
- * const result = D.getSecond(input);
- * // result: 0
+ * const input = D.create("2024-06-20", {
+ * 	hour: "00",
+ * 	minute: "00",
+ * 	second: "45",
+ * });
+ * const utcSecond = D.getSecond(input);
+ * // utcSecond: 45
  * 
- * const result2 = D.getSecond(input, "Asia/Seoul");
- * // result2: 0
+ * const londonSecond = D.getSecond(input, "Europe/London");
+ * // londonSecond: 45
  * 
  * pipe(
  * 	input,
- * 	D.getSecond,
- * ); // result: 0
- * 
+ * 	(value) => D.getSecond(value, "UTC"),
  * ```
  * 
  * @see https://utils.duplojs.dev/en/v1/api/date/getSecond
@@ -28,4 +30,4 @@ import { type TheDate, type Timezone } from "..";
  * @namespace D
  * 
  */
-export declare function getSecond<GenericInput extends TheDate>(input: GenericInput, timezone?: Timezone): number;
+export declare function getSecond<GenericInput extends TheDate | SerializedTheDate>(input: GenericInput, timezone?: Timezone): number;

package/dist/date/getters/getSecond.mjs

@@ -4,15 +4,15 @@ import { toNative } from '../toNative.mjs';
  * {@include date/getSecond/index.md}
  */
 function getSecond(input, timezone = "UTC") {
-    const nativeDate = toNative(input);
+    const date = toNative(input);
     if (timezone === "UTC") {
-        return nativeDate.getUTCSeconds();
+        return date.getUTCSeconds();
     }
     const formatter = new Intl.DateTimeFormat("en-US", {
         timeZone: timezone,
         second: "numeric",
     });
-    return Number(formatter.format(nativeDate));
+    return Number(formatter.format(date));
 }
 
 export { getSecond };

package/dist/date/getters/getWeekOfYear.cjs

@@ -1,19 +1,20 @@
 'use strict';
 
 var toNative = require('../toNative.cjs');
+var constants = require('../constants.cjs');
 
 /**
  * {@include date/getWeekOfYear/index.md}
  */
 function getWeekOfYear(input, timezone = "UTC") {
-    const nativeDate = toNative.toNative(input);
+    const date = toNative.toNative(input);
     let year = 0;
     let month = 0;
     let day = 0;
     if (timezone === "UTC") {
-        year = nativeDate.getUTCFullYear();
-        month = nativeDate.getUTCMonth();
-        day = nativeDate.getUTCDate();
+        year = date.getUTCFullYear();
+        month = date.getUTCMonth();
+        day = date.getUTCDate();
     }
     else {
         const parts = new Intl.DateTimeFormat("en-US", {
@@ -21,19 +22,19 @@ function getWeekOfYear(input, timezone = "UTC") {
             day: "numeric",
             year: "numeric",
             month: "numeric",
-        }).formatToParts(nativeDate);
+        }).formatToParts(date);
         const partsMap = new Map(parts.map((part) => [part.type, part.value]));
         year = Number(partsMap.get("year"));
         month = Number(partsMap.get("month")) - 1;
         day = Number(partsMap.get("day"));
     }
-    const date = new Date(Date.UTC(year, month, day));
-    const dayOfWeek = date.getUTCDay() || 7;
+    const nativeDate = new Date(Date.UTC(year, month, day));
+    const dayOfWeek = nativeDate.getUTCDay() || 7;
     const nearestThursday = day + 4 - dayOfWeek;
-    date.setUTCDate(nearestThursday);
-    const thursYearStart = Date.UTC(date.getUTCFullYear(), 0, 1);
-    const millisecondsDiff = date.getTime() - thursYearStart;
-    const daysDiff = Math.floor(millisecondsDiff / 86400000);
+    nativeDate.setUTCDate(nearestThursday);
+    const thursYearStart = Date.UTC(nativeDate.getUTCFullYear(), 0, 1);
+    const millisecondsDiff = nativeDate.getTime() - thursYearStart;
+    const daysDiff = Math.floor(millisecondsDiff / constants.millisecondsInOneDay);
     return Math.ceil((daysDiff + 1) / 7);
 }
 

package/dist/date/getters/getWeekOfYear.d.ts

@@ -1,28 +1,34 @@
-import { type TheDate, type Timezone } from "..";
+import type { SerializedTheDate } from "../types";
+import type { TheDate } from "../theDate";
+import type { Timezone } from "../timezone";
 /**
- * Returns the week of year of a date.
+ * Returns the ISO week number (`1` to `53`) for a date in a target timezone.
  * 
- * Signature: `getWeekOfYear(input, timezone)` → returns a value
+ * Signature: `getWeekOfYear(input, timezone?)` → `number`
  * 
- * If timezone is omitted, UTC is used.
- * 
- * The input value is not mutated.
+ * `input` accepts `TheDate` or `SerializedTheDate`. If `timezone` is omitted, UTC is used.
  * 
  * ```ts
  * const input = D.create("2024-01-04");
- * const result = D.getWeekOfYear(input, "Europe/Berlin");
- * // result: 1
+ * const utcWeek = D.getWeekOfYear(input);
+ * // utcWeek: 1
+ * 
+ * const berlinWeek = D.getWeekOfYear(input, "Europe/Berlin");
+ * // berlinWeek: 1
  * 
  * pipe(
  * 	input,
- * 	(value) => D.getWeekOfYear(value, "Europe/Berlin"),
- * ); // result: 1
+ * 	(value) => D.getWeekOfYear(value, "UTC"),
+ * ); // 1
  * 
  * ```
  * 
+ * @remarks
+ * - Uses ISO-8601 week rules (week aligned around Thursday logic).
+ * 
  * @see https://utils.duplojs.dev/en/v1/api/date/getWeekOfYear
  * 
  * @namespace D
  * 
  */
-export declare function getWeekOfYear<GenericInput extends TheDate>(input: GenericInput, timezone?: Timezone): number;
+export declare function getWeekOfYear<GenericInput extends TheDate | SerializedTheDate>(input: GenericInput, timezone?: Timezone): number;

package/dist/date/getters/getWeekOfYear.mjs

@@ -1,17 +1,18 @@
 import { toNative } from '../toNative.mjs';
+import { millisecondsInOneDay } from '../constants.mjs';
 
 /**
  * {@include date/getWeekOfYear/index.md}
  */
 function getWeekOfYear(input, timezone = "UTC") {
-    const nativeDate = toNative(input);
+    const date = toNative(input);
     let year = 0;
     let month = 0;
     let day = 0;
     if (timezone === "UTC") {
-        year = nativeDate.getUTCFullYear();
-        month = nativeDate.getUTCMonth();
-        day = nativeDate.getUTCDate();
+        year = date.getUTCFullYear();
+        month = date.getUTCMonth();
+        day = date.getUTCDate();
     }
     else {
         const parts = new Intl.DateTimeFormat("en-US", {
@@ -19,19 +20,19 @@ function getWeekOfYear(input, timezone = "UTC") {
             day: "numeric",
             year: "numeric",
             month: "numeric",
-        }).formatToParts(nativeDate);
+        }).formatToParts(date);
         const partsMap = new Map(parts.map((part) => [part.type, part.value]));
         year = Number(partsMap.get("year"));
         month = Number(partsMap.get("month")) - 1;
         day = Number(partsMap.get("day"));
     }
-    const date = new Date(Date.UTC(year, month, day));
-    const dayOfWeek = date.getUTCDay() || 7;
+    const nativeDate = new Date(Date.UTC(year, month, day));
+    const dayOfWeek = nativeDate.getUTCDay() || 7;
     const nearestThursday = day + 4 - dayOfWeek;
-    date.setUTCDate(nearestThursday);
-    const thursYearStart = Date.UTC(date.getUTCFullYear(), 0, 1);
-    const millisecondsDiff = date.getTime() - thursYearStart;
-    const daysDiff = Math.floor(millisecondsDiff / 86400000);
+    nativeDate.setUTCDate(nearestThursday);
+    const thursYearStart = Date.UTC(nativeDate.getUTCFullYear(), 0, 1);
+    const millisecondsDiff = nativeDate.getTime() - thursYearStart;
+    const daysDiff = Math.floor(millisecondsDiff / millisecondsInOneDay);
     return Math.ceil((daysDiff + 1) / 7);
 }
 

package/dist/date/getters/getYear.cjs

@@ -6,15 +6,15 @@ var toNative = require('../toNative.cjs');
  * {@include date/getYear/index.md}
  */
 function getYear(input, timezone = "UTC") {
-    const nativeDate = toNative.toNative(input);
+    const date = toNative.toNative(input);
     if (timezone === "UTC") {
-        return nativeDate.getUTCFullYear();
+        return date.getUTCFullYear();
     }
     const formatter = new Intl.DateTimeFormat("en-US", {
         timeZone: timezone,
         year: "numeric",
     });
-    return Number(formatter.format(nativeDate));
+    return Number(formatter.format(date));
 }
 
 exports.getYear = getYear;

package/dist/date/getters/getYear.d.ts

@@ -1,26 +1,27 @@
-import { type TheDate, type Timezone } from "..";
+import type { SerializedTheDate } from "../types";
+import { type TheDate } from "../theDate";
+import type { Timezone } from "../timezone";
 /**
- * Returns the year of a date.
+ * Returns the year for a date in a target timezone.
  * 
- * Signature: `getYear(input, timezone)` → returns a value
+ * Signature: `getYear(input, timezone?)` → `number`
  * 
- * If timezone is omitted, UTC is used.
- * 
- * The input value is not mutated.
+ * `input` accepts `TheDate` or `SerializedTheDate`. If `timezone` is omitted, UTC is used.
  * 
  * ```ts
- * const input = D.create("2024-06-20");
- * const result = D.getYear(input);
- * // result: 2024
+ * const input = D.create("2024-12-31", {
+ * 	hour: "23",
+ * 	minute: "30",
+ * });
+ * const utcYear = D.getYear(input);
+ * // utcYear: 2024
  * 
- * const result2 = D.getYear(input, "Europe/Paris");
- * // result2: 2024
+ * const tokyoYear = D.getYear(input, "Asia/Tokyo");
+ * // tokyoYear: 2025
  * 
  * pipe(
  * 	input,
- * 	D.getYear,
- * ); // result: 2024
- * 
+ * 	(value) => D.getYear(value, "UTC"),
  * ```
  * 
  * @see https://utils.duplojs.dev/en/v1/api/date/getYear
@@ -28,4 +29,4 @@ import { type TheDate, type Timezone } from "..";
  * @namespace D
  * 
  */
-export declare function getYear<GenericInput extends TheDate>(input: GenericInput, timezone?: Timezone): number;
+export declare function getYear<GenericInput extends TheDate | SerializedTheDate>(input: GenericInput, timezone?: Timezone): number;

package/dist/date/getters/getYear.mjs

@@ -4,15 +4,15 @@ import { toNative } from '../toNative.mjs';
  * {@include date/getYear/index.md}
  */
 function getYear(input, timezone = "UTC") {
-    const nativeDate = toNative(input);
+    const date = toNative(input);
     if (timezone === "UTC") {
-        return nativeDate.getUTCFullYear();
+        return date.getUTCFullYear();
     }
     const formatter = new Intl.DateTimeFormat("en-US", {
         timeZone: timezone,
         year: "numeric",
     });
-    return Number(formatter.format(nativeDate));
+    return Number(formatter.format(date));
 }
 
 export { getYear };

package/dist/date/index.cjs

@@ -30,11 +30,14 @@ var applyTimezone = require('./applyTimezone.cjs');
 var format = require('./format.cjs');
 var formatTime = require('./formatTime.cjs');
 var makeSafeTimestamp = require('./makeSafeTimestamp.cjs');
-var createTheDate = require('./createTheDate.cjs');
-var createTheTime = require('./createTheTime.cjs');
 var createTime = require('./createTime.cjs');
 var createTimeOrThrow = require('./createTimeOrThrow.cjs');
 var makeSafeTimeValue = require('./makeSafeTimeValue.cjs');
+var theDate = require('./theDate.cjs');
+var theTime = require('./theTime.cjs');
+var isSerializedTheDate = require('./isSerializedTheDate.cjs');
+var isSerializedTheTime = require('./isSerializedTheTime.cjs');
+var serialize = require('./serialize.cjs');
 var getDayOfMonth = require('./getters/getDayOfMonth.cjs');
 var getDayOfWeek = require('./getters/getDayOfWeek.cjs');
 var getFirstDayOfWeek = require('./getters/getFirstDayOfWeek.cjs');
@@ -100,8 +103,8 @@ exports.minTimestamp = constants.minTimestamp;
 exports.minutesInOneHour = constants.minutesInOneHour;
 exports.monthsInOneYear = constants.monthsInOneYear;
 exports.secondsInOneMinute = constants.secondsInOneMinute;
-exports.theDateRegex = constants.theDateRegex;
-exports.theTimeRegex = constants.theTimeRegex;
+exports.serializeTheDateRegex = constants.serializeTheDateRegex;
+exports.serializeTheTimeRegex = constants.serializeTheTimeRegex;
 exports.create = create.create;
 exports.now = now.now;
 exports.today = today.today;
@@ -132,12 +135,15 @@ exports.applyTimezone = applyTimezone.applyTimezone;
 exports.format = format.format;
 exports.formatTime = formatTime.formatTime;
 exports.makeSafeTimestamp = makeSafeTimestamp.makeSafeTimestamp;
-exports.createTheDate = createTheDate.createTheDate;
-exports.createTheTime = createTheTime.createTheTime;
 exports.createTime = createTime.createTime;
 exports.CreateTheTimeError = createTimeOrThrow.CreateTheTimeError;
 exports.createTimeOrThrow = createTimeOrThrow.createTimeOrThrow;
 exports.makeSafeTimeValue = makeSafeTimeValue.makeSafeTimeValue;
+exports.TheDate = theDate.TheDate;
+exports.TheTime = theTime.TheTime;
+exports.isSerializedTheDate = isSerializedTheDate.isSerializedTheDate;
+exports.isSerializedTheTime = isSerializedTheTime.isSerializedTheTime;
+exports.serialize = serialize.serialize;
 exports.getDayOfMonth = getDayOfMonth.getDayOfMonth;
 exports.getDayOfWeek = getDayOfWeek.getDayOfWeek;
 exports.getFirstDayOfWeek = getFirstDayOfWeek.getFirstDayOfWeek;

package/dist/date/index.d.ts

@@ -64,8 +64,11 @@ export * from "./applyTimezone";
 export * from "./format";
 export * from "./formatTime";
 export * from "./makeSafeTimestamp";
-export * from "./createTheDate";
-export * from "./createTheTime";
 export * from "./createTime";
 export * from "./createTimeOrThrow";
 export * from "./makeSafeTimeValue";
+export * from "./theDate";
+export * from "./theTime";
+export * from "./isSerializedTheDate";
+export * from "./isSerializedTheTime";
+export * from "./serialize";

package/dist/date/index.mjs

@@ -1,4 +1,4 @@
-export { daysInOneWeek, hoursInOneDay, isoDateRegex, isoTimeRegex, maxTimeValue, maxTimestamp, millisecondInOneHour, millisecondInOneMinute, millisecondInOneWeek, millisecondsInOneDay, millisecondsInOneSecond, minTimeValue, minTimestamp, minutesInOneHour, monthsInOneYear, secondsInOneMinute, theDateRegex, theTimeRegex } from './constants.mjs';
+export { daysInOneWeek, hoursInOneDay, isoDateRegex, isoTimeRegex, maxTimeValue, maxTimestamp, millisecondInOneHour, millisecondInOneMinute, millisecondInOneWeek, millisecondsInOneDay, millisecondsInOneSecond, minTimeValue, minTimestamp, minutesInOneHour, monthsInOneYear, secondsInOneMinute, serializeTheDateRegex, serializeTheTimeRegex } from './constants.mjs';
 export { create } from './create.mjs';
 export { now } from './now.mjs';
 export { today } from './today.mjs';
@@ -28,11 +28,14 @@ export { applyTimezone } from './applyTimezone.mjs';
 export { format } from './format.mjs';
 export { formatTime } from './formatTime.mjs';
 export { makeSafeTimestamp } from './makeSafeTimestamp.mjs';
-export { createTheDate } from './createTheDate.mjs';
-export { createTheTime } from './createTheTime.mjs';
 export { createTime } from './createTime.mjs';
 export { CreateTheTimeError, createTimeOrThrow } from './createTimeOrThrow.mjs';
 export { makeSafeTimeValue } from './makeSafeTimeValue.mjs';
+export { TheDate } from './theDate.mjs';
+export { TheTime } from './theTime.mjs';
+export { isSerializedTheDate } from './isSerializedTheDate.mjs';
+export { isSerializedTheTime } from './isSerializedTheTime.mjs';
+export { serialize } from './serialize.mjs';
 export { getDayOfMonth } from './getters/getDayOfMonth.mjs';
 export { getDayOfWeek } from './getters/getDayOfWeek.mjs';
 export { getFirstDayOfWeek } from './getters/getFirstDayOfWeek.mjs';

package/dist/date/is.cjs

@@ -1,18 +1,13 @@
 'use strict';
 
-var constants = require('./constants.cjs');
-var isSafeTimestamp = require('./isSafeTimestamp.cjs');
+var theDate = require('./theDate.cjs');
 
 /**
  * {@include date/is/index.md}
  */
 function is(input) {
-    const theDateMatch = input.match(constants.theDateRegex);
-    if (theDateMatch) {
-        const { value, sign } = theDateMatch.groups;
-        return isSafeTimestamp.isSafeTimestamp(Number(sign === "-"
-            ? `-${value}`
-            : value));
+    if (input instanceof theDate.TheDate) {
+        return true;
     }
     return false;
 }

package/dist/date/is.d.ts

@@ -1,26 +1,21 @@
-import { type TheDate } from "./types";
+import { TheDate } from "./theDate";
 /**
- * Checks whether a value is a TheDate.
+ * Checks whether a value is an instance of `TheDate`.
  * 
- * Signature: `is(input)` → returns a value
- * 
- * The input value is not mutated.
+ * Signature: `is(input)` → `input is TheDate`
  * 
  * ```ts
- * const input = D.now() as string;
+ * const input = D.now() as AnyValue;
  * 
  * if (D.is(input)) {
- * 	// input is TheDate
+ * 	// input: TheDate
  * }
  * 
  * pipe(
  * 	input,
- * 	when(
- * 		D.is,
- * 		(value) => {
- * 			// value is TheDate
- * 		},
- * 	),
+ * 	when(D.is, (value) => {
+ * 		// value: TheDate
+ * 	}),
  * );
  * ```
  * 
@@ -29,4 +24,4 @@ import { type TheDate } from "./types";
  * @namespace D
  * 
  */
-export declare function is(input: string): input is TheDate;
+export declare function is(input: unknown): input is TheDate;