@nivinjoseph/n-date 1.0.1

package/.yarnrc.yml

@@ -0,0 +1,8 @@
+approvedGitRepositories:
+  - "**"
+
+enableScripts: false
+
+nodeLinker: node-modules
+
+yarnPath: .yarn/releases/yarn-4.14.1.cjs

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nivin Joseph
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# n-date
+
+Date utility functions for TypeScript/JavaScript applications.
+
+## Installation
+
+```bash
+npm install @nivinjoseph/n-date
+
+# or
+
+yarn add @nivinjoseph/n-date
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/dist/date-time-format.d.ts

@@ -0,0 +1,11 @@
+export declare enum DateTimeFormat {
+    yearMonthDayHourMinuteSecond = "yyyy-MM-dd HH:mm:ss",
+    yearMonthDayHourMinute = "yyyy-MM-dd HH:mm",
+    yearMonthDayHour = "yyyy-MM-dd HH",
+    yearMonthDay = "yyyy-MM-dd",
+    yearMonth = "yyyy-MM",
+    year = "yyyy"
+}
+export declare const DateTimeFormat_DEFAULT = DateTimeFormat.yearMonthDayHourMinuteSecond;
+export type DateTimeFormatExt = "DD HH:mm:ss" | "MMMM d, HH:mm:ss" | "DD HH:mm" | "MMMM d, HH:mm" | "yyyy/LL/dd" | "yyyy/LL/dd HH:mm:ss" | "yyyy/LL/dd HH:mm" | "yyyy-MM-dd" | "HH:mm:ss" | "HH:mm" | "DDD" | "DD" | "yyyy-MM" | "MMMM yyyy" | "DDDD" | "EEEE DD" | "LLL yyyy" | "LLLL yyyy" | "MMMM d" | "LLL d";
+//# sourceMappingURL=date-time-format.d.ts.map

package/dist/date-time-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-time-format.d.ts","sourceRoot":"","sources":["../src/date-time-format.ts"],"names":[],"mappings":"AAAA,oBAAY,cAAc;IAEtB,4BAA4B,wBAAwB;IACpD,sBAAsB,qBAAqB;IAC3C,gBAAgB,kBAAkB;IAClC,YAAY,eAAe;IAC3B,SAAS,YAAY;IACrB,IAAI,SAAS;CAChB;AAED,eAAO,MAAM,sBAAsB,8CAA8C,CAAC;AAGlF,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACX,kBAAkB,GAClB,UAAU,GACV,eAAe,GACf,YAAY,GACZ,qBAAqB,GACrB,kBAAkB,GAClB,YAAY,GACZ,UAAU,GACV,OAAO,GACP,KAAK,GACL,IAAI,GACJ,SAAS,GACT,WAAW,GACX,MAAM,GACN,SAAS,GACT,UAAU,GACV,WAAW,GACX,QAAQ,GACR,OAAO,CACR"}

package/dist/date-time-format.js

@@ -0,0 +1,11 @@
+export var DateTimeFormat;
+(function (DateTimeFormat) {
+    DateTimeFormat["yearMonthDayHourMinuteSecond"] = "yyyy-MM-dd HH:mm:ss";
+    DateTimeFormat["yearMonthDayHourMinute"] = "yyyy-MM-dd HH:mm";
+    DateTimeFormat["yearMonthDayHour"] = "yyyy-MM-dd HH";
+    DateTimeFormat["yearMonthDay"] = "yyyy-MM-dd";
+    DateTimeFormat["yearMonth"] = "yyyy-MM";
+    DateTimeFormat["year"] = "yyyy";
+})(DateTimeFormat || (DateTimeFormat = {}));
+export const DateTimeFormat_DEFAULT = DateTimeFormat.yearMonthDayHourMinuteSecond;
+//# sourceMappingURL=date-time-format.js.map

package/dist/date-time-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-time-format.js","sourceRoot":"","sources":["../src/date-time-format.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,cAQX;AARD,WAAY,cAAc;IAEtB,sEAAoD,CAAA;IACpD,6DAA2C,CAAA;IAC3C,oDAAkC,CAAA;IAClC,6CAA2B,CAAA;IAC3B,uCAAqB,CAAA;IACrB,+BAAa,CAAA;AACjB,CAAC,EARW,cAAc,KAAd,cAAc,QAQzB;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,cAAc,CAAC,4BAA4B,CAAC"}

package/dist/date-time-span.d.ts

@@ -0,0 +1,70 @@
+import { DateTime } from "./date-time.js";
+import { Serializable, Duration, Schema } from "@nivinjoseph/n-util";
+export declare class DateTimeSpan extends Serializable<DateTimeSpanSchema> {
+    private readonly _start;
+    private readonly _end;
+    get start(): DateTime;
+    get end(): DateTime;
+    get duration(): Duration;
+    constructor(data: DateTimeSpanSchema);
+    /**
+    Checks if the given DateTime is within this DateTimeSpan (inclusive of start and end).
+
+    Use cases:
+
+        this: start ─────────────── end
+                    ↑
+                    dateTime
+
+    Args:
+
+        dateTime (DateTime): The DateTime to check.
+
+    Returns:
+
+        boolean: True if dateTime is within the span [start, end], false otherwise.
+    */
+    contains(dateTime: DateTime): boolean;
+    /**
+    Checks if this DateTimeSpan completely encompasses another DateTimeSpan.
+
+    Use cases:
+
+        this: start ─────────────────────── end
+        other:      start ─── end
+
+    Returns:
+
+        boolean: True if this span completely contains the other span.
+    */
+    encompasses(other: DateTimeSpan): boolean;
+    /**
+    Checks if two DateTimeSpans have any intersection or overlap.
+
+    Use cases:
+
+        This encompasses other:
+        this: start ─────────────────────── end
+        other:      start ─── end
+
+        Other encompasses this:
+        this:       start ─── end
+        other: start ─────────────────────── end
+
+        Partial overlap - this starts in other:
+        this:           start ─────── end
+        other: start ─────── end
+
+        Partial overlap - this ends in other:
+        this:  start ─────── end
+        other:       start ─────── end
+
+    Returns:
+
+        boolean: True if spans overlap or intersect, false if completely separate.
+    */
+    infringes(other: DateTimeSpan): boolean;
+    equals(other: DateTimeSpan | null): boolean;
+}
+export type DateTimeSpanSchema = Schema<DateTimeSpan, "start" | "end">;
+//# sourceMappingURL=date-time-span.d.ts.map

package/dist/date-time-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-time-span.d.ts","sourceRoot":"","sources":["../src/date-time-span.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAa,QAAQ,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGhF,qBACa,YAAa,SAAQ,YAAY,CAAC,kBAAkB,CAAC;IAE9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAGhC,IACW,KAAK,IAAI,QAAQ,CAAwB;IAEpD,IACW,GAAG,IAAI,QAAQ,CAAsB;IAEhD,IAAW,QAAQ,IAAI,QAAQ,CAA4C;gBAGxD,IAAI,EAAE,kBAAkB;IAe3C;;;;;;;;;;;;;;;;MAgBE;IACK,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAO5C;;;;;;;;;;;MAWE;IACK,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAKhD;;;;;;;;;;;;;;;;;;;;;;;;MAwBE;IACK,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAYvC,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO;CAYrD;AAGD,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,YAAY,EAAE,OAAO,GAAG,KAAK,CAAC,CAAC"}

package/dist/date-time-span.js

@@ -0,0 +1,122 @@
+import { __esDecorate, __runInitializers } from "tslib";
+import { given } from "@nivinjoseph/n-defensive";
+import { DateTime } from "./date-time.js";
+import { Serializable, serialize } from "@nivinjoseph/n-util";
+let DateTimeSpan = (() => {
+    let _classDecorators = [serialize("Ndate")];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = Serializable;
+    let _instanceExtraInitializers = [];
+    let _get_start_decorators;
+    let _get_end_decorators;
+    var DateTimeSpan = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _get_start_decorators = [serialize];
+            _get_end_decorators = [serialize];
+            __esDecorate(this, null, _get_start_decorators, { kind: "getter", name: "start", static: false, private: false, access: { has: obj => "start" in obj, get: obj => obj.start }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _get_end_decorators, { kind: "getter", name: "end", static: false, private: false, access: { has: obj => "end" in obj, get: obj => obj.end }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            DateTimeSpan = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        _start = __runInitializers(this, _instanceExtraInitializers);
+        _end;
+        get start() { return this._start; }
+        get end() { return this._end; }
+        get duration() { return this._end.timeDiff(this._start); }
+        constructor(data) {
+            super(data);
+            const { start, end } = data;
+            given(start, "start").ensureHasValue().ensureIsType(DateTime);
+            this._start = start;
+            given(end, "end").ensureHasValue().ensureIsType(DateTime)
+                .ensure(t => t.isSameOrAfter(start), "must be same or after start");
+            this._end = end;
+        }
+        /**
+        Checks if the given DateTime is within this DateTimeSpan (inclusive of start and end).
+    
+        Use cases:
+    
+            this: start ─────────────── end
+                        ↑
+                        dateTime
+    
+        Args:
+    
+            dateTime (DateTime): The DateTime to check.
+    
+        Returns:
+    
+            boolean: True if dateTime is within the span [start, end], false otherwise.
+        */
+        contains(dateTime) {
+            given(dateTime, "dateTime").ensureHasValue().ensureIsObject();
+            return dateTime.isBetween(this._start, this._end);
+        }
+        /**
+        Checks if this DateTimeSpan completely encompasses another DateTimeSpan.
+    
+        Use cases:
+    
+            this: start ─────────────────────── end
+            other:      start ─── end
+    
+        Returns:
+    
+            boolean: True if this span completely contains the other span.
+        */
+        encompasses(other) {
+            return this._start.isSameOrBefore(other._start) && this._end.isSameOrAfter(other._end);
+        }
+        /**
+        Checks if two DateTimeSpans have any intersection or overlap.
+    
+        Use cases:
+    
+            This encompasses other:
+            this: start ─────────────────────── end
+            other:      start ─── end
+    
+            Other encompasses this:
+            this:       start ─── end
+            other: start ─────────────────────── end
+    
+            Partial overlap - this starts in other:
+            this:           start ─────── end
+            other: start ─────── end
+    
+            Partial overlap - this ends in other:
+            this:  start ─────── end
+            other:       start ─────── end
+    
+        Returns:
+    
+            boolean: True if spans overlap or intersect, false if completely separate.
+        */
+        infringes(other) {
+            // if start and end of self is contained in other
+            // or other encompasses self
+            // or self encompasses other
+            if (this.encompasses(other) || other.encompasses(this))
+                return true;
+            return other.contains(this._start) || other.contains(this._end);
+        }
+        equals(other) {
+            given(other, "other").ensureIsType(DateTimeSpan);
+            if (other == null)
+                return false;
+            if (other === this)
+                return true;
+            return this._start.equals(other._start) && this._end.equals(other._end);
+        }
+    };
+    return DateTimeSpan = _classThis;
+})();
+export { DateTimeSpan };
+//# sourceMappingURL=date-time-span.js.map

package/dist/date-time-span.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-time-span.js","sourceRoot":"","sources":["../src/date-time-span.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAoB,MAAM,qBAAqB,CAAC;IAInE,YAAY;4BADxB,SAAS,CAAC,OAAO,CAAC;;;;sBACe,YAAY;;;;4BAApB,SAAQ,WAAgC;;;;qCAM7D,SAAS;mCAGT,SAAS;YAFV,sKAAW,KAAK,6DAAoC;YAGpD,gKAAW,GAAG,6DAAkC;YAVpD,6KAwHC;;;YAxHY,uDAAY;;QAEJ,MAAM,GAFd,mDAAY,CAEa;QACjB,IAAI,CAAW;QAIhC,IAAW,KAAK,KAAe,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAGpD,IAAW,GAAG,KAAe,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEhD,IAAW,QAAQ,KAAe,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAG3E,YAAmB,IAAwB;YAEvC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEZ,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;YAE5B,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,cAAc,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC9D,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YAEpB,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,cAAc,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC;iBACpD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,6BAA6B,CAAC,CAAC;YACxE,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QACpB,CAAC;QAGD;;;;;;;;;;;;;;;;UAgBE;QACK,QAAQ,CAAC,QAAkB;YAE9B,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,cAAc,EAAE,CAAC,cAAc,EAAE,CAAC;YAE9D,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC;QAED;;;;;;;;;;;UAWE;QACK,WAAW,CAAC,KAAmB;YAElC,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3F,CAAC;QAED;;;;;;;;;;;;;;;;;;;;;;;;UAwBE;QACK,SAAS,CAAC,KAAmB;YAEhC,iDAAiD;YACjD,4BAA4B;YAC5B,4BAA4B;YAE5B,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;gBAClD,OAAO,IAAI,CAAC;YAEhB,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,CAAC;QAEM,MAAM,CAAC,KAA0B;YAEpC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;YAEjD,IAAI,KAAK,IAAI,IAAI;gBACb,OAAO,KAAK,CAAC;YAEjB,IAAI,KAAK,KAAK,IAAI;gBACd,OAAO,IAAI,CAAC;YAEhB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5E,CAAC;;;;SAvHQ,YAAY"}

package/dist/date-time.d.ts

@@ -0,0 +1,391 @@
+import { Serializable, Duration, Schema } from "@nivinjoseph/n-util";
+import { DateTimeFormat, DateTimeFormatExt } from "./date-time-format.js";
+/**
+ * A robust date and time handling system with timezone support.
+ * This class provides comprehensive functionality for date/time manipulation, comparison, and formatting.
+ *
+ * @example
+ * ```typescript
+ * const now = DateTime.now("UTC");
+ * const future = now.addTime(Duration.fromHours(2));
+ * const isAfter = future.isAfter(now);
+ * ```
+ */
+export declare class DateTime extends Serializable<DateTimeSchema> {
+    private static _fixedNow;
+    private static _relativeNow;
+    private readonly _value;
+    private readonly _zone;
+    private readonly _dateTime;
+    private readonly _timestamp;
+    private readonly _dateCode;
+    private readonly _timeCode;
+    private readonly _dateValue;
+    private readonly _timeValue;
+    /**
+     * Gets the system's local timezone.
+     *
+     * @returns The local timezone identifier.
+     */
+    static get currentZone(): string;
+    /**
+     * Gets the formatted date and time string.
+     */
+    get value(): string;
+    /**
+     * Gets the timezone identifier.
+     */
+    get zone(): string;
+    /**
+     * Gets the Unix timestamp in seconds.
+     */
+    get timestamp(): number;
+    /**
+     * Gets the date code in YYYYMMDD format.
+     */
+    get dateCode(): string;
+    /**
+     * Gets the time code in HHMMSS format.
+     */
+    get timeCode(): string;
+    /**
+     * Gets the date value in YYYY-MM-DD format.
+     */
+    get dateValue(): string;
+    /**
+     * Gets the time value in HH:mm:ss format.
+     */
+    get timeValue(): string;
+    /**
+     * Gets whether this DateTime is in the past.
+     */
+    get isPast(): boolean;
+    /**
+     * Gets whether this DateTime is in the future.
+     */
+    get isFuture(): boolean;
+    /**
+     * Creates a new DateTime instance.
+     *
+     * @param data - The DateTime data containing value and zone.
+     * @throws Error if the value or zone is invalid.
+     */
+    constructor(data: DateTimeSchema);
+    /**
+     * Sets a fixed timestamp for testing purposes. All calls to DateTime.now() will return this fixed time.
+     *
+     * @param timestamp - The Unix timestamp in seconds to use as the fixed "now" time.
+     * @throws Error if timestamp is not a valid number.
+     */
+    static useFixedNow(timestamp: number): void;
+    /**
+     * Sets a relative timestamp for testing purposes. DateTime.now() will return times relative to this base timestamp,
+     * advancing as real time advances.
+     *
+     * @param timestamp - The Unix timestamp in seconds to use as the base "now" time.
+     * @throws Error if timestamp is not a valid number.
+     */
+    static useRelativeNow(timestamp: number): void;
+    /**
+     * Resets any fixed or relative "now" time set by useFixedNow or useRelativeNow.
+     * DateTime.now() will return the actual current time after calling this method.
+     */
+    static resetFixedOrRelativeNow(): void;
+    /**
+     * Creates a DateTime instance for the current time.
+     *
+     * @param zone - The timezone identifier. If not specified, UTC is used.
+     * @returns A new DateTime instance representing the current time.
+     */
+    static now(zone?: string): DateTime;
+    /**
+     * Creates a DateTime from a Unix timestamp.
+     *
+     * @param timestamp - The number of seconds since the Unix epoch.
+     * @param zone - The timezone identifier.
+     * @returns A new DateTime instance.
+     */
+    static createFromTimestamp(timestamp: number, zone: string): DateTime;
+    /**
+     * Creates a DateTime from milliseconds since the Unix epoch.
+     *
+     * @param milliseconds - The number of milliseconds since the Unix epoch.
+     * @param zone - The timezone identifier.
+     * @returns A new DateTime instance.
+     */
+    static createFromMilliSecondsSinceEpoch(milliseconds: number, zone: string): DateTime;
+    /**
+     * Creates a DateTime from date and time codes.
+     *
+     * @param dateCode - The date code in YYYYMMDD format.
+     * @param timeCode - The time code in HHMM format.
+     * @param zone - The timezone identifier.
+     * @returns A new DateTime instance.
+     */
+    static createFromCodes(dateCode: string, timeCode: string, zone: string): DateTime;
+    /**
+     * Creates a DateTime from date and time values.
+     *
+     * @param dateValue - The date in YYYY-MM-DD format.
+     * @param timeValue - The time in HH:mm format.
+     * @param zone - The timezone identifier.
+     * @returns A new DateTime instance.
+     */
+    static createFromValues(dateValue: string, timeValue: string, zone: string): DateTime;
+    /**
+     * Returns the earlier of two DateTime instances.
+     *
+     * @param dateTime1 - The first DateTime instance.
+     * @param dateTime2 - The second DateTime instance.
+     * @returns The earlier DateTime instance.
+     */
+    static min(dateTime1: DateTime, dateTime2: DateTime): DateTime;
+    /**
+     * Returns the later of two DateTime instances.
+     *
+     * @param dateTime1 - The first DateTime instance.
+     * @param dateTime2 - The second DateTime instance.
+     * @returns The later DateTime instance.
+     */
+    static max(dateTime1: DateTime, dateTime2: DateTime): DateTime;
+    /**
+     * Validates if a string matches the DateTime format "yyyy-MM-dd HH:mm".
+     *
+     * @param value - The string to validate.
+     * @returns True if the string matches the format, false otherwise.
+     */
+    static validateDateTimeFormat(value: string, format: DateTimeFormat): boolean;
+    /**
+     * Validates if a string matches the date format "yyyy-MM-dd".
+     *
+     * @param value - The string to validate.
+     * @returns True if the string matches the format, false otherwise.
+     */
+    static validateDateFormat(value: string): boolean;
+    /**
+     * Validates if a string matches the time format  "HH:mm".
+     *
+     * @param value - The string to validate.
+     * @returns True if the string matches the format, false otherwise.
+     */
+    static validateTimeFormat(value: string): boolean;
+    /**
+     * Validates if a string is a valid timezone.
+     *
+     * @param zone - The timezone string to validate.
+     * @returns True if the timezone is valid, false otherwise.
+     */
+    static validateTimeZone(zone: string): boolean;
+    /**
+     * Validates a timezone string.
+     *
+     * @param zone - The timezone string to validate.
+     * @throws Error if the timezone is invalid.
+     * @private
+     */
+    private static _validateZone;
+    /**
+     * Gets the numeric value of this DateTime.
+     *
+     * @returns The milliseconds since the Unix epoch.
+     */
+    valueOf(): number;
+    /**
+     * Compares this DateTime with another for equality.
+     *
+     * @param value - The DateTime to compare with.
+     * @returns True if the DateTime instances are equal, false otherwise.
+     */
+    equals(value?: DateTime | null): boolean;
+    /**
+     * Returns the string representation of this DateTime.
+     *
+     * @returns The string representation in the format "YYYY-MM-DD HH:mm:ss zone".
+     */
+    toString(): string;
+    /**
+     * Returns the date and time string.
+     *
+     * @returns The string in the format "YYYY-MM-DD HH:mm:ss".
+     */
+    toStringDateTime(): string;
+    /**
+     * Returns the ISO string representation.
+     *
+     * @returns The ISO 8601 string representation.
+     */
+    toStringISO(): string;
+    /**
+     * Formats a DateTime object to a string using the specified format
+     * @param dateTime The DateTime object to format
+     * @param format The format to use (defaults to yearMonthDayHourMinute: "yyyy-MM-dd HH:mm")
+     * @returns The formatted datetime string
+     */
+    format(format?: DateTimeFormat): string;
+    /**
+     * Formats a DateTime object to a string using extended format capabilities.
+     * This method leverages Luxon's full formatting capabilities for more complex formatting needs.
+     *
+     * @param format - The format string to use. Can be a predefined DateTimeFormatExt or any custom Luxon format string.
+     * @returns The formatted datetime string.
+     *
+     * @example
+     * ```typescript
+     * const dt = DateTime.now("America/New_York");
+     * dt.formatExt("DD HH:mm:ss"); // "Jul 2, 2023 15:30:20"
+     * dt.formatExt("MMMM d, yyyy"); // "July 2, 2023"
+     * dt.formatExt("EEEE DD"); // "Friday Jul 2, 2023"
+     *
+     * export type DateTimeFormatExt =
+        "DD HH:mm:ss" // Jul 2, 2023 15:30:20
+        | "MMMM d, HH:mm:ss"  // Jul 2 15:30:20
+        | "DD HH:mm" // Jul 2, 2023 15:30
+        | "MMMM d, HH:mm"  // Jul 2 15:30
+        | "yyyy/LL/dd" // 2023/07/21
+        | "yyyy/LL/dd HH:mm:ss"
+        | "yyyy/LL/dd HH:mm"
+        | "yyyy-MM-dd" // 2023-07-21
+        | "HH:mm:ss" // 15:30:20
+        | "HH:mm" // 15:30
+        | "DDD" // July 21, 2023
+        | "DD" // Jul 21, 2023
+        | "yyyy-MM" // 2023-07
+        | "MMMM yyyy" // July 2023
+        | "DDDD" // Sunday, July 9, 2023
+        | "EEEE DD" // Friday Aug 4, 2023
+        | "LLL yyyy" // Jul 2025
+        | "LLLL yyyy" // July 2025
+        | "MMMM d" // November 2
+        | "LLL d" // Nov 2
+        ;
+     *
+     * ```
+     */
+    formatExt(format: DateTimeFormatExt | string): string;
+    /**
+     * Checks if this DateTime represents the same instant as another.
+     *
+     * @param value - The DateTime to compare with.
+     * @returns True if the DateTime instances represent the same instant, false otherwise.
+     */
+    isSame(value: DateTime): boolean;
+    /**
+     * Checks if this DateTime is before another.
+     *
+     * @param value - The DateTime to compare with.
+     * @returns True if this DateTime is before the other, false otherwise.
+     */
+    isBefore(value: DateTime): boolean;
+    /**
+     * Checks if this DateTime is the same or before another.
+     *
+     * @param value - The DateTime to compare with.
+     * @returns True if this DateTime is the same or before the other, false otherwise.
+     */
+    isSameOrBefore(value: DateTime): boolean;
+    /**
+     * Checks if this DateTime is after another.
+     *
+     * @param value - The DateTime to compare with.
+     * @returns True if this DateTime is after the other, false otherwise.
+     */
+    isAfter(value: DateTime): boolean;
+    /**
+     * Checks if this DateTime is the same or after another.
+     *
+     * @param value - The DateTime to compare with.
+     * @returns True if this DateTime is the same or after the other, false otherwise.
+     */
+    isSameOrAfter(value: DateTime): boolean;
+    /**
+     * Checks if this DateTime is between two others.
+     *
+     * @param start - The start DateTime.
+     * @param end - The end DateTime.
+     * @returns True if this DateTime is between start and end, false otherwise.
+     * @throws Error if end is before start.
+     */
+    isBetween(start: DateTime, end: DateTime): boolean;
+    /**
+     * Calculates the time difference between this DateTime and another.
+     *
+     * @param value - The DateTime to compare with.
+     * @returns A Duration representing the time difference.
+     */
+    timeDiff(value: DateTime): Duration;
+    /**
+     * Calculates the days difference between this DateTime and another.
+     *
+     * @param value - The DateTime to compare with.
+     * @returns The number of days difference.
+     */
+    daysDiff(value: DateTime): number;
+    /**
+     * Checks if this DateTime is on the same day as another.
+     *
+     * @param value - The DateTime to compare with.
+     * @returns True if the DateTime instances are on the same day, false otherwise.
+     */
+    isSameDay(value: DateTime): boolean;
+    /**
+     * Adds a duration to this DateTime. this accounts for shift in DST
+     *
+     * @param time - The duration to add.
+     * @returns A new DateTime instance with the duration added.
+     */
+    addTime(time: Duration): DateTime;
+    /**
+     * Subtracts a duration from this DateTime. this accounts for shift in DST
+     *
+     * @param time - The duration to subtract.
+     * @returns A new DateTime instance with the duration subtracted.
+     */
+    subtractTime(time: Duration): DateTime;
+    /**
+     * Adds days to this DateTime. this doesn't change time based on DST
+     *
+     * @param days - The number of days to add.
+     * @returns A new DateTime instance with the days added.
+     * @throws Error if days is not a positive integer.
+     */
+    addDays(days: number): DateTime;
+    /**
+     * Subtracts days from this DateTime. this doesn't change time based on DST
+     *
+     * @param days - The number of days to subtract.
+     * @returns A new DateTime instance with the days subtracted.
+     * @throws Error if days is not a positive integer.
+     */
+    subtractDays(days: number): DateTime;
+    /**
+     * Gets an array of DateTime instances for each day of the month.
+     *
+     * @returns An array of DateTime instances, where:
+     * - First element is the start of the month (e.g., "2023-06-01 00:00")
+     * - Last element is the end of the month (e.g., "2023-06-30 23:59")
+     * - Elements in between represent the start of each day (e.g., "2023-06-11 00:00")
+     */
+    getDaysOfMonth(): Array<DateTime>;
+    /**
+     * Converts this DateTime to a different timezone.
+     *
+     * @param zone - The target timezone.
+     * @returns A new DateTime instance in the specified timezone.
+     * @throws Error if the timezone is invalid.
+     */
+    convertToZone(zone: string): DateTime;
+    /**
+     * Checks if this DateTime is within a time range.
+     *
+     * @param startTimeCode - The start time code in HHMM format.
+     * @param endTimeCode - The end time code in HHMM format.
+     * @returns True if this DateTime is within the time range, false otherwise.
+     * @throws Error if the time codes are invalid or if endTimeCode is before startTimeCode.
+     */
+    isWithinTimeRange(startTimeCode: string, endTimeCode: string): boolean;
+}
+/**
+ * Schema type for DateTime serialization.
+ */
+export type DateTimeSchema = Schema<DateTime, "value" | "zone">;
+//# sourceMappingURL=date-time.d.ts.map