@tmlmobilidade/go-utils-dates 20260828.1831.23 → 20260829.23.20

package/dist/dates.d.ts

@@ -1,4 +1,4 @@
-import { type CalendarDate, DateFormat, type OperationalDateInt, type TimezoneIdentified, type UnixTimestamp } from '@tmlmobilidade/go-types-shared';
+import { type CalendarDate, DateFormat, type OperationalDateInt, type TimezoneIdentified, type UnixMilliseconds } from '@tmlmobilidade/go-types-shared';
 import { type DateObjectUnits, type DateTimeUnit, type DurationObjectUnits } from 'luxon';
 interface DatesConstructor {
     calendar_date: CalendarDate;
@@ -6,10 +6,10 @@ interface DatesConstructor {
     js_date: Date;
     operational_date_int: OperationalDateInt;
     std_window: {
-        end: UnixTimestamp;
-        start: UnixTimestamp;
+        end: UnixMilliseconds;
+        start: UnixMilliseconds;
     };
-    unix_timestamp: UnixTimestamp;
+    unix_milliseconds: UnixMilliseconds;
 }
 export declare class Dates {
     static readonly standardWindowHours = 10;
@@ -19,10 +19,10 @@ export declare class Dates {
     js_date: Date;
     operational_date_int: OperationalDateInt;
     std_window: {
-        end: UnixTimestamp;
-        start: UnixTimestamp;
+        end: UnixMilliseconds;
+        start: UnixMilliseconds;
     };
-    unix_timestamp: UnixTimestamp;
+    unix_milliseconds: UnixMilliseconds;
     constructor(params: DatesConstructor);
     /**
      * Creates a Dates object from a date/time string in a specific format.
@@ -64,7 +64,7 @@ export declare class Dates {
      * @param millis The number of milliseconds since Unix epoch. Unix timestamp is always in UTC.
      * @returns A new Dates object created from the milliseconds timestamp.
      */
-    static fromUnixTimestamp(millis: number | UnixTimestamp): Dates;
+    static fromUnixMilliseconds(millis: number | UnixMilliseconds): Dates;
     /**
      * Creates a Dates object with the current date and time.
      * @param timezone The timezone to set for the Dates object.
@@ -118,12 +118,12 @@ export declare class Dates {
      */
     startOf(unit: DateTimeUnit): Dates;
     /**
-     * Returns the time remaining until a given unix_timestamp (in ms) from now,
+     * Returns the time remaining until a given unix_milliseconds (in ms) from now,
      * as an object with minutes, hours, and days (all as floats, not rounded).
-     * @param unixTimestamp The target timestamp in milliseconds
+     * @param unixMilliseconds The target timestamp in milliseconds
      * @returns { minutes: number, hours: number, days: number }
      */
-    timeUntil(unixTimestamp: UnixTimestamp): {
+    timeUntil(unixMilliseconds: UnixMilliseconds): {
         days: number;
         hours: number;
         minutes: number;

package/dist/dates.js

@@ -12,14 +12,14 @@ export class Dates {
     js_date;
     operational_date_int;
     std_window;
-    unix_timestamp;
+    unix_milliseconds;
     constructor(params) {
         this.calendar_date = params.calendar_date;
         this.iso = params.iso ?? null;
         this.js_date = params.js_date;
         this.operational_date_int = params.operational_date_int;
         this.std_window = params.std_window;
-        this.unix_timestamp = params.unix_timestamp;
+        this.unix_milliseconds = params.unix_milliseconds;
     }
     /**
      * Creates a Dates object from a date/time string in a specific format.
@@ -39,7 +39,7 @@ export class Dates {
             js_date: dateTime.toJSDate(),
             operational_date_int: this.prototype.getOperationalDateInt(dateTime.toISO()),
             std_window: this.prototype.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
+            unix_milliseconds: dateTime.toMillis(),
         });
     }
     /**
@@ -56,7 +56,7 @@ export class Dates {
             js_date: dateTime.toJSDate(),
             operational_date_int: this.prototype.getOperationalDateInt(dateTime.toISO()),
             std_window: this.prototype.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
+            unix_milliseconds: dateTime.toMillis(),
         });
     }
     /**
@@ -74,7 +74,7 @@ export class Dates {
             js_date: dateTime.toJSDate(),
             operational_date_int: this.prototype.getOperationalDateInt(dateTime.toISO()),
             std_window: this.prototype.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
+            unix_milliseconds: dateTime.toMillis(),
         });
     }
     /**
@@ -94,7 +94,7 @@ export class Dates {
             js_date: dateTime.toJSDate(),
             operational_date_int: this.prototype.getOperationalDateInt(dateTime.toISO()),
             std_window: this.prototype.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
+            unix_milliseconds: dateTime.toMillis(),
         });
     }
     /**
@@ -112,7 +112,7 @@ export class Dates {
             js_date: dateTime.toJSDate(),
             operational_date_int: this.prototype.getOperationalDateInt(dateTime.toISO()),
             std_window: this.prototype.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
+            unix_milliseconds: dateTime.toMillis(),
         });
     }
     /**
@@ -120,7 +120,7 @@ export class Dates {
      * @param millis The number of milliseconds since Unix epoch. Unix timestamp is always in UTC.
      * @returns A new Dates object created from the milliseconds timestamp.
      */
-    static fromUnixTimestamp(millis) {
+    static fromUnixMilliseconds(millis) {
         const dateTime = DateTime
             .fromMillis(millis)
             .setZone('utc', { keepLocalTime: false });
@@ -130,7 +130,7 @@ export class Dates {
             js_date: dateTime.toJSDate(),
             operational_date_int: this.prototype.getOperationalDateInt(dateTime.toISO()),
             std_window: this.prototype.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
+            unix_milliseconds: dateTime.toMillis(),
         });
     }
     /**
@@ -148,7 +148,7 @@ export class Dates {
             js_date: dateTime.toJSDate(),
             operational_date_int: this.prototype.getOperationalDateInt(dateTime.toISO()),
             std_window: this.prototype.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
+            unix_milliseconds: dateTime.toMillis(),
         });
     }
     /**
@@ -181,7 +181,7 @@ export class Dates {
             js_date: dateTime.toJSDate(),
             operational_date_int: this.getOperationalDateInt(dateTime.toISO()),
             std_window: this.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
+            unix_milliseconds: dateTime.toMillis(),
         });
     }
     /**
@@ -201,7 +201,7 @@ export class Dates {
             js_date: dateTime.toJSDate(),
             operational_date_int: this.getOperationalDateInt(dateTime.toISO()),
             std_window: this.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
+            unix_milliseconds: dateTime.toMillis(),
         });
     }
     /**
@@ -221,7 +221,7 @@ export class Dates {
             js_date: dateTime.toJSDate(),
             operational_date_int: this.getOperationalDateInt(dateTime.toISO()),
             std_window: this.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
+            unix_milliseconds: dateTime.toMillis(),
         });
     }
     /**
@@ -241,7 +241,7 @@ export class Dates {
             js_date: dateTime.toJSDate(),
             operational_date_int: this.getOperationalDateInt(dateTime.toISO()),
             std_window: this.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
+            unix_milliseconds: dateTime.toMillis(),
         });
     }
     /**
@@ -264,7 +264,7 @@ export class Dates {
             js_date: dateTime.toJSDate(),
             operational_date_int: this.getOperationalDateInt(dateTime.toISO()),
             std_window: this.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
+            unix_milliseconds: dateTime.toMillis(),
         });
     }
     /**
@@ -284,19 +284,19 @@ export class Dates {
             js_date: dateTime.toJSDate(),
             operational_date_int: this.getOperationalDateInt(dateTime.toISO()),
             std_window: this.getStandardWindowInterval(dateTime.toISO()),
-            unix_timestamp: dateTime.toMillis(),
+            unix_milliseconds: dateTime.toMillis(),
         });
     }
     /**
-     * Returns the time remaining until a given unix_timestamp (in ms) from now,
+     * Returns the time remaining until a given unix_milliseconds (in ms) from now,
      * as an object with minutes, hours, and days (all as floats, not rounded).
-     * @param unixTimestamp The target timestamp in milliseconds
+     * @param unixMilliseconds The target timestamp in milliseconds
      * @returns { minutes: number, hours: number, days: number }
      */
-    timeUntil(unixTimestamp) {
+    timeUntil(unixMilliseconds) {
         // Calculate the difference in milliseconds
         const now = Date.now();
-        const diffMs = unixTimestamp - now;
+        const diffMs = unixMilliseconds - now;
         // Calculate the time remaining
         const minutes = diffMs / (1000 * 60);
         const hours = diffMs / (1000 * 60 * 60);

package/dist/helpers/split-time-intervals.d.ts

@@ -1,4 +1,4 @@
-import { type UnixTimestamp } from '@tmlmobilidade/go-types-shared';
+import { type UnixMilliseconds } from '@tmlmobilidade/go-types-shared';
 /**
  * Splits a time interval into smaller intervals of a given duration.
  * @param from The start timestamp of the interval.
@@ -6,11 +6,11 @@ import { type UnixTimestamp } from '@tmlmobilidade/go-types-shared';
  * @param intervalHrs The duration of the intervals in hours.
  * @returns An array of intervals.
  */
-export declare function splitTimeIntervals(from: UnixTimestamp, to: UnixTimestamp, intervalHrs: number): {
+export declare function splitTimeIntervals(from: UnixMilliseconds, to: UnixMilliseconds, intervalHrs: number): {
     end: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
     start: number & {
-        __brand: "UnixTimestamp";
+        __brand: "UnixMilliseconds";
     };
 }[];

package/dist/helpers/split-time-intervals.js

@@ -1,5 +1,5 @@
 /* * */
-import { UnixTimestampSchema } from '@tmlmobilidade/go-types-shared';
+import { UnixMillisecondsSchema } from '@tmlmobilidade/go-types-shared';
 /**
  * Splits a time interval into smaller intervals of a given duration.
  * @param from The start timestamp of the interval.
@@ -28,7 +28,7 @@ export function splitTimeIntervals(from, to, intervalHrs) {
     // Handle the first, potentially shorter interval.
     // If there is a remainder, create an interval with the remainder as the duration.
     if (remainder > 0) {
-        const startTimestamp = UnixTimestampSchema.parse(Math.max(from, endTimestamp - remainder));
+        const startTimestamp = UnixMillisecondsSchema.parse(Math.max(from, endTimestamp - remainder));
         finalIntervals.push({ end: endTimestamp, start: startTimestamp });
         endTimestamp = startTimestamp;
     }
@@ -37,7 +37,7 @@ export function splitTimeIntervals(from, to, intervalHrs) {
     // If the end timestamp is greater than the start timestamp,
     // create an interval with the duration of the interval.
     while (endTimestamp > from) {
-        const startTimestamp = UnixTimestampSchema.parse(Math.max(from, endTimestamp - intervalMs));
+        const startTimestamp = UnixMillisecondsSchema.parse(Math.max(from, endTimestamp - intervalMs));
         finalIntervals.push({ end: endTimestamp, start: startTimestamp });
         endTimestamp = startTimestamp;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/go-utils-dates",
-	"version": "20260828.1831.23",
+	"version": "20260829.23.20",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"