@develia/commons 0.4.16 → 0.4.19

package/src/timespan.ts

@@ -1,399 +1,413 @@
-/**
- * Represents a duration of time in milliseconds.
- */
-export default class TimeSpan {
-    public milliseconds: number;
-
-    private constructor(milliseconds: number) {
-        this.milliseconds = milliseconds;
-    }
-
-
-    /**
-     * Gets the time interval in seconds.
-     * @returns {number} The duration in seconds.
-     */
-    seconds(): number {
-        return this.milliseconds / 1000;
-    }
-
-    /**
-     * Gets the time interval in minutes.
-     * @returns {number} The duration in minutes.
-     */
-    minutes(): number {
-        return this.milliseconds / (1000 * 60);
-    }
-
-    /**
-     * Gets the time interval in hours.
-     * @returns {number} The duration in hours.
-     */
-    hours(): number {
-        return this.milliseconds / (1000 * 60 * 60);
-    }
-
-    /**
-     * Gets the time interval in days.
-     * @returns {number} The duration in days.
-     */
-    days(): number {
-        return this.milliseconds / (1000 * 60 * 60 * 24);
-    }
-
-    /**
-     * Gets the time interval in weeks.
-     * @returns {number} The duration in weeks.
-     */
-    weeks(): number {
-        return this.milliseconds / (1000 * 60 * 60 * 24 * 7);
-    }
-
-    /**
-     * Creates a TimeSpan from a specified number of milliseconds.
-     * @param {number} milliseconds - The number of milliseconds.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    static fromMilliseconds(milliseconds: number): TimeSpan {
-        return new TimeSpan(milliseconds);
-    }
-
-    /**
-     * Creates a TimeSpan from a specified number of seconds.
-     * @param {number} seconds - The number of seconds.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    static fromSeconds(seconds: number): TimeSpan {
-        return new TimeSpan(seconds * 1000);
-    }
-
-    /**
-     * Creates a TimeSpan from a specified number of minutes.
-     * @param {number} minutes - The number of minutes.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    static fromMinutes(minutes: number): TimeSpan {
-        return new TimeSpan(minutes * 1000 * 60);
-    }
-
-    /**
-     * Creates a TimeSpan from a specified number of hours.
-     * @param {number} hours - The number of hours.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    static fromHours(hours: number): TimeSpan {
-        return new TimeSpan(hours * 1000 * 60 * 60);
-    }
-
-    /**
-     * Creates a TimeSpan from a specified number of days.
-     * @param {number} days - The number of days.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    static fromDays(days: number): TimeSpan {
-        return new TimeSpan(days * 1000 * 60 * 60 * 24);
-    }
-
-    /**
-     * Creates a TimeSpan from a specified number of weeks.
-     * @param {number} weeks - The number of weeks.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    static fromWeeks(weeks: number): TimeSpan {
-        return new TimeSpan(weeks * 1000 * 60 * 60 * 24 * 7);
-    }
-
-    /**
-     * Returns a new TimeSpan that adds the specified number of milliseconds to this instance.
-     * @param {number} milliseconds - The milliseconds to add.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    addMilliseconds(milliseconds: number): TimeSpan {
-        return new TimeSpan(this.milliseconds + milliseconds);
-    }
-
-    /**
-     * Returns a new TimeSpan that adds the specified number of seconds to this instance.
-     * @param {number} seconds - The seconds to add.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    addSeconds(seconds: number): TimeSpan {
-        return this.addMilliseconds(seconds * 1000);
-    }
-
-    /**
-     * Returns a new TimeSpan that adds the specified number of minutes to this instance.
-     * @param {number} minutes - The minutes to add.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    addMinutes(minutes: number): TimeSpan {
-        return this.addMilliseconds(minutes * 1000 * 60);
-    }
-
-    /**
-     * Returns a new TimeSpan that adds the specified number of hours to this instance.
-     * @param {number} hours - The hours to add.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    addHours(hours: number): TimeSpan {
-        return this.addMilliseconds(hours * 1000 * 60 * 60);
-    }
-
-    /**
-     * Returns a new TimeSpan that adds the specified number of days to this instance.
-     * @param {number} days - The days to add.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    addDays(days: number): TimeSpan {
-        return this.addMilliseconds(days * 1000 * 60 * 60 * 24);
-    }
-
-    /**
-     * Returns a new TimeSpan that adds the specified number of weeks to this instance.
-     * @param {number} weeks - The weeks to add.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    addWeeks(weeks: number): TimeSpan {
-        return this.addMilliseconds(weeks * 1000 * 60 * 60 * 24 * 7);
-    }
-
-    /**
-     * Returns a new TimeSpan that subtracts the specified number of milliseconds from this instance.
-     * @param {number} milliseconds - The milliseconds to subtract.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    subtractMilliseconds(milliseconds: number): TimeSpan {
-        return new TimeSpan(this.milliseconds - milliseconds);
-    }
-
-    /**
-     * Returns a new TimeSpan that subtracts the specified number of seconds from this instance.
-     * @param {number} seconds - The seconds to subtract.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    subtractSeconds(seconds: number): TimeSpan {
-        return this.subtractMilliseconds(seconds * 1000);
-    }
-
-    /**
-     * Returns a new TimeSpan that subtracts the specified number of minutes from this instance.
-     * @param {number} minutes - The minutes to subtract.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    subtractMinutes(minutes: number): TimeSpan {
-        return this.subtractMilliseconds(minutes * 1000 * 60);
-    }
-
-    /**
-     * Returns a new TimeSpan that subtracts the specified number of hours from this instance.
-     * @param {number} hours - The hours to subtract.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    subtractHours(hours: number): TimeSpan {
-        return this.subtractMilliseconds(hours * 1000 * 60 * 60);
-    }
-
-    /**
-     * Returns a new TimeSpan that subtracts the specified number of days from this instance.
-     * @param {number} days - The days to subtract.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    subtractDays(days: number): TimeSpan {
-        return this.subtractMilliseconds(days * 1000 * 60 * 60 * 24);
-    }
-
-    /**
-     * Returns a new TimeSpan that subtracts the specified number of weeks from this instance.
-     * @param {number} weeks - The weeks to subtract.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    subtractWeeks(weeks: number): TimeSpan {
-        return this.subtractMilliseconds(weeks * 1000 * 60 * 60 * 24 * 7);
-    }
-
-    /**
-     * Returns a new TimeSpan that adds the specified TimeSpan to this instance.
-     * @param {TimeSpan} other - The TimeSpan to add.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    add(other: TimeSpan): TimeSpan {
-        return new TimeSpan(this.milliseconds + other.milliseconds);
-    }
-
-    /**
-     * Returns a new TimeSpan that subtracts the specified TimeSpan from this instance.
-     * @param {TimeSpan} other - The TimeSpan to subtract.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    subtract(other: TimeSpan): TimeSpan {
-        return new TimeSpan(this.milliseconds - other.milliseconds);
-    }
-
-    /**
-     * Adds this TimeSpan to a specified Date.
-     * @param {Date} date - The date to add to.
-     * @returns {Date} A new Date instance.
-     */
-    addTo(date: Date): Date {
-        return new Date(date.getTime() + this.milliseconds);
-    }
-
-    /**
-     * Subtracts this TimeSpan from a specified Date.
-     * @param {Date} date - The date to subtract from.
-     * @returns {Date} A new Date instance.
-     */
-    subtractFrom(date: Date): Date {
-        return new Date(date.getTime() - this.milliseconds);
-    }
-
-    /**
-     * Creates a TimeSpan from the difference between two dates.
-     * @param {Date} earlierDate - The earlier date.
-     * @param {Date} laterDate - The later date.
-     * @returns {TimeSpan} A new TimeSpan instance representing the difference.
-     */
-    static fromDifference(earlierDate: Date, laterDate: Date): TimeSpan {
-        return new TimeSpan(laterDate.getTime() - earlierDate.getTime());
-    }
-
-    /**
-     * Formats the TimeSpan as a string.
-     * Supported tokens: hh, h, mm, m, ss, s.
-     * @param {string} format - The format string (default: 'hh:mm:ss').
-     * @returns {string} The formatted string.
-     */
-    format(format: string = 'hh:mm:ss'): string {
-        const formatLower = format.toLowerCase();
-        const hasHours = formatLower.includes("h");
-        const hasMinutes = formatLower.includes("m");
-
-        let hours = 0, minutes = 0, seconds = Math.floor(this.milliseconds / 1000);
-
-        if (hasHours) {
-            hours = Math.floor(seconds / 3600);
-            seconds -= hours * 3600;
-        }
-        if (hasMinutes) {
-            minutes = Math.floor(seconds / 60);
-            seconds -= minutes * 60;
-        }
-
-        const hoursPadded = String(hours).padStart(2, '0');
-        const minutesPadded = String(minutes).padStart(2, '0');
-        const secondsPadded = String(seconds).padStart(2, '0');
-
-        return formatLower
-            .replace('hh', hoursPadded)
-            .replace('h', hours.toString())
-            .replace('mm', minutesPadded)
-            .replace('m', minutes.toString())
-            .replace('ss', secondsPadded)
-            .replace('s', seconds.toString());
-    }
-
-    /**
-     * Checks if this TimeSpan is equal to another.
-     * @param {TimeSpan} other - The other TimeSpan.
-     * @returns {boolean} True if equal.
-     */
-    eq(other: TimeSpan): boolean {
-        return this.milliseconds === other.milliseconds;
-    }
-
-    /**
-     * Checks if this TimeSpan is less than or equal to another.
-     * @param {TimeSpan} other - The other TimeSpan.
-     * @returns {boolean} True if less than or equal.
-     */
-    le(other: TimeSpan): boolean {
-        return this.milliseconds <= other.milliseconds;
-    }
-
-    /**
-     * Checks if this TimeSpan is less than another.
-     * @param {TimeSpan} other - The other TimeSpan.
-     * @returns {boolean} True if less than.
-     */
-    lt(other: TimeSpan): boolean {
-        return this.milliseconds < other.milliseconds;
-    }
-
-    /**
-     * Checks if this TimeSpan is greater than or equal to another.
-     * @param {TimeSpan} other - The other TimeSpan.
-     * @returns {boolean} True if greater than or equal.
-     */
-    ge(other: TimeSpan): boolean {
-        return this.milliseconds >= other.milliseconds;
-    }
-
-    /**
-     * Checks if this TimeSpan is greater than another.
-     * @param {TimeSpan} other - The other TimeSpan.
-     * @returns {boolean} True if greater than.
-     */
-    gt(other: TimeSpan): boolean {
-        return this.milliseconds > other.milliseconds;
-    }
-
-    /**
-     * Multiplies the TimeSpan by a number.
-     * @param {number} number - The multiplier.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    multiply(number: number): TimeSpan {
-        return new TimeSpan(this.milliseconds * number);
-    }
-
-    /**
-     * Divides the TimeSpan by a number.
-     * @param {number} number - The divisor.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    divide(number: number): TimeSpan {
-        return new TimeSpan(this.milliseconds / number);
-    }
-
-    /**
-     * Returns the absolute value of the TimeSpan.
-     * @returns {TimeSpan} A new TimeSpan instance.
-     */
-    abs(): TimeSpan {
-        return new TimeSpan(Math.abs(this.milliseconds));
-    }
-
-    /**
-     * Infinite duration.
-     */
-    static readonly INFINITE = new TimeSpan(Number.POSITIVE_INFINITY);
-
-    /**
-     * Negative infinite duration.
-     */
-    static readonly NEGATIVE_INFINITE = new TimeSpan(Number.NEGATIVE_INFINITY);
-
-    /**
-     * Checks if the TimeSpan is infinite.
-     * @returns {boolean} True if infinite.
-     */
-    isInfinite() {
-        return this.milliseconds === Number.POSITIVE_INFINITY || this.milliseconds === Number.NEGATIVE_INFINITY
-    }
-
-    /**
-     * Checks if the TimeSpan is positive infinite.
-     * @returns {boolean} True if positive infinite.
-     */
-    isPositiveInfinite(): boolean {
-        return this.milliseconds === Number.POSITIVE_INFINITY;
-    }
-
-    /**
-     * Checks if the TimeSpan is negative infinite.
-     * @returns {boolean} True if negative infinite.
-     */
-    isNegativeInfinite(): boolean {
-        return this.milliseconds === Number.NEGATIVE_INFINITY;
-    }
+/**
+ * Represents a duration of time in milliseconds.
+ */
+export default class TimeSpan {
+    public milliseconds: number;
+
+    private constructor(milliseconds: number) {
+        this.milliseconds = milliseconds;
+    }
+
+
+    /**
+     * Gets the time interval in seconds.
+     * @returns {number} The duration in seconds.
+     */
+    seconds(): number {
+        return this.milliseconds / 1000;
+    }
+
+    /**
+     * Gets the time interval in minutes.
+     * @returns {number} The duration in minutes.
+     */
+    minutes(): number {
+        return this.milliseconds / (1000 * 60);
+    }
+
+    /**
+     * Gets the time interval in hours.
+     * @returns {number} The duration in hours.
+     */
+    hours(): number {
+        return this.milliseconds / (1000 * 60 * 60);
+    }
+
+    /**
+     * Gets the time interval in days.
+     * @returns {number} The duration in days.
+     */
+    days(): number {
+        return this.milliseconds / (1000 * 60 * 60 * 24);
+    }
+
+    /**
+     * Gets the time interval in weeks.
+     * @returns {number} The duration in weeks.
+     */
+    weeks(): number {
+        return this.milliseconds / (1000 * 60 * 60 * 24 * 7);
+    }
+
+    /**
+     * Creates a TimeSpan from a specified number of milliseconds.
+     * @param {number} milliseconds - The number of milliseconds.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    static fromMilliseconds(milliseconds: number): TimeSpan {
+        return new TimeSpan(milliseconds);
+    }
+
+    /**
+     * Creates a TimeSpan from a specified number of seconds.
+     * @param {number} seconds - The number of seconds.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    static fromSeconds(seconds: number): TimeSpan {
+        return new TimeSpan(seconds * 1000);
+    }
+
+    /**
+     * Creates a TimeSpan from a specified number of minutes.
+     * @param {number} minutes - The number of minutes.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    static fromMinutes(minutes: number): TimeSpan {
+        return new TimeSpan(minutes * 1000 * 60);
+    }
+
+    /**
+     * Creates a TimeSpan from a specified number of hours.
+     * @param {number} hours - The number of hours.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    static fromHours(hours: number): TimeSpan {
+        return new TimeSpan(hours * 1000 * 60 * 60);
+    }
+
+    /**
+     * Creates a TimeSpan from a specified number of days.
+     * @param {number} days - The number of days.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    static fromDays(days: number): TimeSpan {
+        return new TimeSpan(days * 1000 * 60 * 60 * 24);
+    }
+
+    /**
+     * Creates a TimeSpan from a specified number of weeks.
+     * @param {number} weeks - The number of weeks.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    static fromWeeks(weeks: number): TimeSpan {
+        return new TimeSpan(weeks * 1000 * 60 * 60 * 24 * 7);
+    }
+
+    /**
+     * Returns a new TimeSpan that adds the specified number of milliseconds to this instance.
+     * @param {number} milliseconds - The milliseconds to add.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    addMilliseconds(milliseconds: number): TimeSpan {
+        return new TimeSpan(this.milliseconds + milliseconds);
+    }
+
+    /**
+     * Returns a new TimeSpan that adds the specified number of seconds to this instance.
+     * @param {number} seconds - The seconds to add.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    addSeconds(seconds: number): TimeSpan {
+        return this.addMilliseconds(seconds * 1000);
+    }
+
+    /**
+     * Returns a new TimeSpan that adds the specified number of minutes to this instance.
+     * @param {number} minutes - The minutes to add.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    addMinutes(minutes: number): TimeSpan {
+        return this.addMilliseconds(minutes * 1000 * 60);
+    }
+
+    /**
+     * Returns a new TimeSpan that adds the specified number of hours to this instance.
+     * @param {number} hours - The hours to add.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    addHours(hours: number): TimeSpan {
+        return this.addMilliseconds(hours * 1000 * 60 * 60);
+    }
+
+    /**
+     * Returns a new TimeSpan that adds the specified number of days to this instance.
+     * @param {number} days - The days to add.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    addDays(days: number): TimeSpan {
+        return this.addMilliseconds(days * 1000 * 60 * 60 * 24);
+    }
+
+    /**
+     * Returns a new TimeSpan that adds the specified number of weeks to this instance.
+     * @param {number} weeks - The weeks to add.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    addWeeks(weeks: number): TimeSpan {
+        return this.addMilliseconds(weeks * 1000 * 60 * 60 * 24 * 7);
+    }
+
+    /**
+     * Returns a new TimeSpan that subtracts the specified number of milliseconds from this instance.
+     * @param {number} milliseconds - The milliseconds to subtract.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    subtractMilliseconds(milliseconds: number): TimeSpan {
+        return new TimeSpan(this.milliseconds - milliseconds);
+    }
+
+    /**
+     * Returns a new TimeSpan that subtracts the specified number of seconds from this instance.
+     * @param {number} seconds - The seconds to subtract.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    subtractSeconds(seconds: number): TimeSpan {
+        return this.subtractMilliseconds(seconds * 1000);
+    }
+
+    /**
+     * Returns a new TimeSpan that subtracts the specified number of minutes from this instance.
+     * @param {number} minutes - The minutes to subtract.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    subtractMinutes(minutes: number): TimeSpan {
+        return this.subtractMilliseconds(minutes * 1000 * 60);
+    }
+
+    /**
+     * Returns a new TimeSpan that subtracts the specified number of hours from this instance.
+     * @param {number} hours - The hours to subtract.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    subtractHours(hours: number): TimeSpan {
+        return this.subtractMilliseconds(hours * 1000 * 60 * 60);
+    }
+
+    /**
+     * Returns a new TimeSpan that subtracts the specified number of days from this instance.
+     * @param {number} days - The days to subtract.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    subtractDays(days: number): TimeSpan {
+        return this.subtractMilliseconds(days * 1000 * 60 * 60 * 24);
+    }
+
+    /**
+     * Returns a new TimeSpan that subtracts the specified number of weeks from this instance.
+     * @param {number} weeks - The weeks to subtract.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    subtractWeeks(weeks: number): TimeSpan {
+        return this.subtractMilliseconds(weeks * 1000 * 60 * 60 * 24 * 7);
+    }
+
+    /**
+     * Returns a new TimeSpan that adds the specified TimeSpan to this instance.
+     * @param {TimeSpan} other - The TimeSpan to add.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    add(other: TimeSpan): TimeSpan {
+        return new TimeSpan(this.milliseconds + other.milliseconds);
+    }
+
+    /**
+     * Returns a new TimeSpan that subtracts the specified TimeSpan from this instance.
+     * @param {TimeSpan} other - The TimeSpan to subtract.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    subtract(other: TimeSpan): TimeSpan {
+        return new TimeSpan(this.milliseconds - other.milliseconds);
+    }
+
+    /**
+     * Adds this TimeSpan to a specified Date.
+     * @param {Date} date - The date to add to.
+     * @returns {Date} A new Date instance.
+     */
+    addTo(date: Date): Date {
+        return new Date(date.getTime() + this.milliseconds);
+    }
+
+    /**
+     * Subtracts this TimeSpan from a specified Date.
+     * @param {Date} date - The date to subtract from.
+     * @returns {Date} A new Date instance.
+     */
+    subtractFrom(date: Date): Date {
+        return new Date(date.getTime() - this.milliseconds);
+    }
+
+    /**
+     * Creates a TimeSpan from the difference between two dates.
+     * @param {Date} earlierDate - The earlier date.
+     * @param {Date} laterDate - The later date.
+     * @returns {TimeSpan} A new TimeSpan instance representing the difference.
+     */
+    static fromDifference(earlierDate: Date, laterDate: Date): TimeSpan {
+        return new TimeSpan(laterDate.getTime() - earlierDate.getTime());
+    }
+
+    /**
+     * Formats the TimeSpan as a string.
+     * Supported tokens: hh, h, mm, m, ss, s.
+     * @param {string} format - The format string (default: 'hh:mm:ss').
+     * @returns {string} The formatted string.
+     */
+    format(format: string = 'hh:mm:ss'): string {
+        const formatLower = format.toLowerCase();
+        const hasHours = formatLower.includes("h");
+        const hasMinutes = formatLower.includes("m");
+
+        const sign = this.milliseconds < 0 ? "-" : "";
+        let hours = 0, minutes = 0, seconds = Math.floor(Math.abs(this.milliseconds) / 1000);
+
+        if (hasHours) {
+            hours = Math.floor(seconds / 3600);
+            seconds -= hours * 3600;
+        }
+        if (hasMinutes) {
+            minutes = Math.floor(seconds / 60);
+            seconds -= minutes * 60;
+        }
+
+        const hoursPadded = String(hours).padStart(2, '0');
+        const minutesPadded = String(minutes).padStart(2, '0');
+        const secondsPadded = String(seconds).padStart(2, '0');
+
+        const formatted = formatLower.replace(/hh|h|mm|m|ss|s/g, token => {
+            switch (token) {
+                case 'hh':
+                    return hoursPadded;
+                case 'h':
+                    return hours.toString();
+                case 'mm':
+                    return minutesPadded;
+                case 'm':
+                    return minutes.toString();
+                case 'ss':
+                    return secondsPadded;
+                case 's':
+                    return seconds.toString();
+                default:
+                    return token;
+            }
+        });
+
+        return sign + formatted;
+    }
+
+    /**
+     * Checks if this TimeSpan is equal to another.
+     * @param {TimeSpan} other - The other TimeSpan.
+     * @returns {boolean} True if equal.
+     */
+    eq(other: TimeSpan): boolean {
+        return this.milliseconds === other.milliseconds;
+    }
+
+    /**
+     * Checks if this TimeSpan is less than or equal to another.
+     * @param {TimeSpan} other - The other TimeSpan.
+     * @returns {boolean} True if less than or equal.
+     */
+    le(other: TimeSpan): boolean {
+        return this.milliseconds <= other.milliseconds;
+    }
+
+    /**
+     * Checks if this TimeSpan is less than another.
+     * @param {TimeSpan} other - The other TimeSpan.
+     * @returns {boolean} True if less than.
+     */
+    lt(other: TimeSpan): boolean {
+        return this.milliseconds < other.milliseconds;
+    }
+
+    /**
+     * Checks if this TimeSpan is greater than or equal to another.
+     * @param {TimeSpan} other - The other TimeSpan.
+     * @returns {boolean} True if greater than or equal.
+     */
+    ge(other: TimeSpan): boolean {
+        return this.milliseconds >= other.milliseconds;
+    }
+
+    /**
+     * Checks if this TimeSpan is greater than another.
+     * @param {TimeSpan} other - The other TimeSpan.
+     * @returns {boolean} True if greater than.
+     */
+    gt(other: TimeSpan): boolean {
+        return this.milliseconds > other.milliseconds;
+    }
+
+    /**
+     * Multiplies the TimeSpan by a number.
+     * @param {number} number - The multiplier.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    multiply(number: number): TimeSpan {
+        return new TimeSpan(this.milliseconds * number);
+    }
+
+    /**
+     * Divides the TimeSpan by a number.
+     * @param {number} number - The divisor.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    divide(number: number): TimeSpan {
+        return new TimeSpan(this.milliseconds / number);
+    }
+
+    /**
+     * Returns the absolute value of the TimeSpan.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
+    abs(): TimeSpan {
+        return new TimeSpan(Math.abs(this.milliseconds));
+    }
+
+    /**
+     * Infinite duration.
+     */
+    static readonly INFINITE = new TimeSpan(Number.POSITIVE_INFINITY);
+
+    /**
+     * Negative infinite duration.
+     */
+    static readonly NEGATIVE_INFINITE = new TimeSpan(Number.NEGATIVE_INFINITY);
+
+    /**
+     * Checks if the TimeSpan is infinite.
+     * @returns {boolean} True if infinite.
+     */
+    isInfinite() {
+        return this.milliseconds === Number.POSITIVE_INFINITY || this.milliseconds === Number.NEGATIVE_INFINITY
+    }
+
+    /**
+     * Checks if the TimeSpan is positive infinite.
+     * @returns {boolean} True if positive infinite.
+     */
+    isPositiveInfinite(): boolean {
+        return this.milliseconds === Number.POSITIVE_INFINITY;
+    }
+
+    /**
+     * Checks if the TimeSpan is negative infinite.
+     * @returns {boolean} True if negative infinite.
+     */
+    isNegativeInfinite(): boolean {
+        return this.milliseconds === Number.NEGATIVE_INFINITY;
+    }
 }