datetime-lube 1.0.0

package/types/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.js"],"names":[],"mappings":"AAkDA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,OAAO,WAAU,IAAI,EAhBjB,IAgBiB,EAAE,EAAE,EAfrB,IAeqB,EAAE,IAAI,EAd3B,OAAO,cAAc,EAAE,IAcI,EAAE,IAAI,AAVzC,CACA,EADQ,OAAO,cAAc,EAAE,QAAQ,YAUE,GAT/B,MAAM,CAiFlB"}

package/types/end_of.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Returns a new Date at the last millisecond of the given unit, such as 23:59:59.999 of the day.
+ * A week ends on Sunday, as in ISO 8601.
+ * @param {Date} date
+ * @param {Exclude<import("../public.js").Unit, "sss">} unit
+ * ```
+ * "Y" | "M" | "W" | "D" | "H" | "m" | "s"
+ * ```
+ * @param {import("../public.js").TimeZone=} zone
+ * @returns {Date}
+ * @throws
+ * ```
+ * RangeError(`endOf: Invalid unit "${unit}"`) // The unit is not one of the listed ones
+ * RangeError(`endOf: Invalid time zone "${zone}"`) // Intl.DateTimeFormat rejects the zone
+ * TypeError(`endOf: Expected a Date, got ${typeof date}`)
+ * ```
+ * @example endOf(new Date, "M") //=> Date { last millisecond of this month }
+ */
+export default function (date: Date, unit: Exclude<import("../public.js").Unit, "sss">, zone?: import("../public.js").TimeZone | undefined): Date;
+//# sourceMappingURL=end_of.d.ts.map

package/types/end_of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"end_of.d.ts","sourceRoot":"","sources":["../src/end_of.js"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,WAAU,IAAI,EAfjB,IAeiB,EAAE,IAAI,EAdvB,OAAO,CAAC,OAAO,cAAc,EAAE,IAAI,EAAE,KAAK,CAcnB,EAAE,IAAI,AAVrC,CACA,EADQ,OAAO,cAAc,EAAE,QAAQ,YAUF,GAT3B,IAAI,CAsFhB"}

package/types/index.d.ts

@@ -0,0 +1,10 @@
+export { default as add } from "./add.js";
+export { default as dateToString } from "./date_to_string.js";
+export { default as diff } from "./diff.js";
+export { default as endOf } from "./end_of.js";
+export { default as startOf } from "./start_of.js";
+export { default as stringToDate } from "./string_to_date.js";
+export { default as timeUnit } from "./time_unit.js";
+export { default as timeZoneOffset } from "./time_zone_offset.js";
+export * from "../public.js"
+//# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,uBAAuB,CAAA"}

package/types/start_of.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Returns a new Date at the start of the given unit, such as midnight of the same day.
+ * A week starts on Monday, as in ISO 8601.
+ * @param {Date} date
+ * @param {Exclude<import("../public.js").Unit, "sss">} unit
+ * ```
+ * "Y" | "M" | "W" | "D" | "H" | "m" | "s"
+ * ```
+ * @param {import("../public.js").TimeZone=} zone
+ * @returns {Date}
+ * @throws
+ * ```
+ * RangeError(`startOf: Invalid unit "${unit}"`) // The unit is not one of the listed ones
+ * RangeError(`startOf: Invalid time zone "${zone}"`) // Intl.DateTimeFormat rejects the zone
+ * TypeError(`startOf: Expected a Date, got ${typeof date}`)
+ * ```
+ * @example startOf(new Date, "D", "Asia/Seoul") //=> Date { midnight in Seoul }
+ */
+export default function (date: Date, unit: Exclude<import("../public.js").Unit, "sss">, zone?: import("../public.js").TimeZone | undefined): Date;
+//# sourceMappingURL=start_of.d.ts.map

package/types/start_of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start_of.d.ts","sourceRoot":"","sources":["../src/start_of.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,WAAU,IAAI,EAfjB,IAeiB,EAAE,IAAI,EAdvB,OAAO,CAAC,OAAO,cAAc,EAAE,IAAI,EAAE,KAAK,CAcnB,EAAE,IAAI,AAVrC,CACA,EADQ,OAAO,cAAc,EAAE,QAAQ,YAUF,GAT3B,IAAI,CAqFhB"}

package/types/string_to_date.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Converts a date string to a Date object based on the provided format.
+ * Without a format the platform parser reads the string, so an offset such as `"Z"` is applied,
+ * while a date without a time is read as midnight. Out-of-range values give an invalid Date only in an
+ * ECMAScript date string: V8 rolls `"2025/02/30"` over to March 2, so check user input with a format.
+ * With a format, letters that are not a time unit only reserve their place, and a unit reads up to its own length of digits (`"sss"` reads them as a fraction, so `".5"` is 500 ms).
+ * `"YYYY"` also reads an expanded year such as `"+012345"`, and text left after the format gives an invalid Date.
+ * Missing units default to 0000-01-01T00:00:00.000, where a time zone is at its local mean time, so
+ * read a time alone in `"UTC"`. An invalid value returns an invalid Date.
+ * A wall clock inside a daylight saving gap moves forward, and one that occurs twice takes the
+ * first occurrence, as `new Date(year, month, day, hour)` does.
+ * @param {string} date
+ * @param {string=} format
+ * ```js
+ * e.g. "YYYY-MM-DDTHH:mm:ss.sss"
+ * ```
+ *
+ * Supported time units:
+ * - "YYYY": Years
+ * - "MM": Months
+ * - "DD": Days
+ * - "HH": Hours
+ * - "mm": Minutes
+ * - "ss": Seconds
+ * - "sss": Milliseconds
+ * @param {import("../public.js").TimeZone=} zone
+ * @returns {Date}
+ * @throws
+ * ```
+ * RangeError(`stringToDate: Invalid time zone "${zone}"`) // Intl.DateTimeFormat rejects the zone
+ * TypeError(`stringToDate: Expected a string, got ${typeof date}`)
+ * ```
+ * @example stringToDate("2024-07-15 09:00", "YYYY-MM-DD HH:mm", "Asia/Seoul")
+ */
+export default function (date: string, format?: string | undefined, zone?: import("../public.js").TimeZone | undefined): Date;
+//# sourceMappingURL=string_to_date.d.ts.map

package/types/string_to_date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string_to_date.d.ts","sourceRoot":"","sources":["../src/string_to_date.js"],"names":[],"mappings":"AAuDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,OAAO,WAAU,IAAI,EAvBjB,MAuBiB,EAAE,MAAM,AAtBjC,CAaA,EAbQ,MAAM,YAsBmB,EAAE,IAAI,AATvC,CACA,EADQ,OAAO,cAAc,EAAE,QAAQ,YASA,GAR7B,IAAI,CAgGhB"}

package/types/time_of.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @param {string} name
+ * @param {Date} date
+ * @returns {number}
+ */
+export default function (name: string, date: Date): number;
+//# sourceMappingURL=time_of.d.ts.map

package/types/time_of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time_of.d.ts","sourceRoot":"","sources":["../src/time_of.js"],"names":[],"mappings":"AACA;;;;GAIG;AACH,MAAM,CAAC,OAAO,WAAU,IAAI,EAJjB,MAIiB,EAAE,IAAI,EAHvB,IAGuB,GAFrB,MAAM,CAUlB"}

package/types/time_unit.d.ts

@@ -0,0 +1,8 @@
+declare const _default: {
+    readonly DD: 86400000;
+    readonly HH: 3600000;
+    readonly mm: 60000;
+    readonly ss: 1000;
+};
+export default _default;
+//# sourceMappingURL=time_unit.d.ts.map

package/types/time_unit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time_unit.d.ts","sourceRoot":"","sources":["../src/time_unit.js"],"names":[],"mappings":";aACC,EAAE,EAAE,QAAQ;aACZ,EAAE,EAAE,OAAO;aACX,EAAE,EAAE,KAAK;aACT,EAAE,EAAE,IAAI"}

package/types/time_zone_offset.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Returns the offset of the time zone at the given date in milliseconds, east of UTC positive.
+ * Daylight saving time is taken from the given date, so a summer date gives the summer offset.
+ * @param {Date} date
+ * @param {import("../public.js").TimeZone} zone
+ * @returns {number}
+ * @throws
+ * ```
+ * RangeError(`timeZoneOffset: Invalid time zone "${zone}"`) // Intl.DateTimeFormat rejects the zone
+ * TypeError(`timeZoneOffset: Expected a Date, got ${typeof date}`)
+ * ```
+ * @example timeZoneOffset(new Date, "Asia/Seoul") //=> 32400000
+ */
+export default function (date: Date, zone: import("../public.js").TimeZone): number;
+//# sourceMappingURL=time_zone_offset.d.ts.map

package/types/time_zone_offset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time_zone_offset.d.ts","sourceRoot":"","sources":["../src/time_zone_offset.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,WAAU,IAAI,EAVjB,IAUiB,EAAE,IAAI,EATvB,OAAO,cAAc,EAAE,QASA,GARrB,MAAM,CAclB"}

package/types/zone.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @param {string} name
+ * @param {string=} zone
+ */
+declare function check_zone(name: string, zone?: string | undefined): void;
+/**
+ * @param {number[]} fields
+ * @param {string=} zone
+ * @returns {Date}
+ */
+declare function date_of(fields: number[], zone?: string | undefined): Date;
+/**
+ * @param {number} wall
+ * @param {number} end
+ * @param {number} time
+ * @param {string=} zone
+ * @returns {number}
+ */
+declare function end_at(wall: number, end: number, time: number, zone?: string | undefined): number;
+/**
+ * @param {Date} date
+ * @param {string=} zone
+ * @returns {number[]}
+ */
+declare function fields_of(date: Date, zone?: string | undefined): number[];
+/**
+ * @param {number} wall
+ * @param {string} zone
+ * @param {boolean=} exact
+ * @returns {number}
+ */
+declare function instant_of(wall: number, zone: string, exact?: boolean | undefined): number;
+/**
+ * @param {number} time
+ * @param {string=} zone
+ * @returns {number}
+ */
+declare function offset_in(time: number, zone?: string | undefined): number;
+/**
+ * @param {number} time
+ * @param {string} zone
+ * @returns {number}
+ */
+declare function offset_of(time: number, zone: string): number;
+/**
+ * @param {number} from
+ * @param {number} to
+ * @param {string=} zone
+ * @returns {number}
+ */
+declare function transition_of(from: number, to: number, zone?: string | undefined): number;
+/**
+ * @param {number} time
+ * @param {number} ms
+ * @param {string=} zone
+ * @returns {number}
+ */
+declare function unit_end(time: number, ms: number, zone?: string | undefined): number;
+/**
+ * @param {number} time
+ * @param {number} ms
+ * @param {string=} zone
+ * @returns {number}
+ */
+declare function unit_start(time: number, ms: number, zone?: string | undefined): number;
+export { check_zone, date_of, end_at, fields_of, instant_of, offset_in, offset_of, transition_of, unit_end, unit_start };
+//# sourceMappingURL=zone.d.ts.map

package/types/zone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone.d.ts","sourceRoot":"","sources":["../src/zone.js"],"names":[],"mappings":"AAMA;;;GAGG;AACH,iBAAS,UAAU,CAAC,IAAI,EAHb,MAGa,EAAE,IAAI,AAF3B,CACF,EADU,MAAM,YAEa,QAU7B;AACD;;;;GAIG;AACH,iBAAS,OAAO,CAAC,MAAM,EAJZ,MAAM,EAIM,EAAE,IAAI,AAH1B,CACA,EADQ,MAAM,YAGY,GAFhB,IAAI,CA2BhB;AACD;;;;;;GAMG;AACH,iBAAS,MAAM,CAAC,IAAI,EANT,MAMS,EAAE,GAAG,EALd,MAKc,EAAE,IAAI,EAJpB,MAIoB,EAAE,IAAI,AAHlC,CACA,EADQ,MAAM,YAGoB,GAFxB,MAAM,CAWlB;AACD;;;;GAIG;AACH,iBAAS,SAAS,CAAC,IAAI,EAJZ,IAIY,EAAE,IAAI,AAH1B,CACA,EADQ,MAAM,YAGY,GAFhB,MAAM,EAAE,CAepB;AA2BD;;;;;GAKG;AACH,iBAAS,UAAU,CAAC,IAAI,EALb,MAKa,EAAE,IAAI,EAJnB,MAImB,EAAE,KAAK,AAHlC,CACA,EADQ,OAAO,YAGmB,GAFxB,MAAM,CAalB;AACD;;;;GAIG;AACH,iBAAS,SAAS,CAAC,IAAI,EAJZ,MAIY,EAAE,IAAI,AAH1B,CACA,EADQ,MAAM,YAGY,GAFhB,MAAM,CAMlB;AACD;;;;GAIG;AACH,iBAAS,SAAS,CAAC,IAAI,EAJZ,MAIY,EAAE,IAAI,EAHlB,MAGkB,GAFhB,MAAM,CAiBlB;AACD;;;;;GAKG;AACH,iBAAS,aAAa,CAAC,IAAI,EALhB,MAKgB,EAAE,EAAE,EAJpB,MAIoB,EAAE,IAAI,AAHlC,CACA,EADQ,MAAM,YAGoB,GAFxB,MAAM,CAUlB;AACD;;;;;GAKG;AACH,iBAAS,QAAQ,CAAC,IAAI,EALX,MAKW,EAAE,EAAE,EAJf,MAIe,EAAE,IAAI,AAH7B,CACA,EADQ,MAAM,YAGe,GAFnB,MAAM,CAiBlB;AACD;;;;;GAKG;AACH,iBAAS,UAAU,CAAC,IAAI,EALb,MAKa,EAAE,EAAE,EAJjB,MAIiB,EAAE,IAAI,AAH/B,CACA,EADQ,MAAM,YAGiB,GAFrB,MAAM,CAkBlB;AACD,OAAO,EACN,UAAU,EACV,OAAO,EACP,MAAM,EACN,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,aAAa,EACb,QAAQ,EACR,UAAU,EACV,CAAA"}