@tmlmobilidade/dates 20260616.1147.27 → 20260616.2238.2

package/dist/dates.d.ts

@@ -1,8 +1,9 @@
 import { type DatesFormat } from './lib/date-format.js';
 import { type TimezoneIdentified } from './lib/timezone-identified.js';
-import { type OperationalDate, type UnixTimestamp } from '@tmlmobilidade/types';
+import { CalendarDate, type OperationalDate, type UnixTimestamp } from '@tmlmobilidade/types';
 import { type DateObjectUnits, type DateTimeUnit, type DurationObjectUnits } from 'luxon';
 interface DatesConstructor {
+    calendar_date: CalendarDate;
     iso: null | string;
     js_date: Date;
     operational_date: OperationalDate;
@@ -20,7 +21,17 @@ export interface CalendarEntry {
     period: '1' | '2' | '3';
 }
 export declare class Dates {
-    static readonly STANDARD_WINDOW_HOURS = 10;
+    static readonly standardWindowHours = 10;
+    calendar_date: CalendarDate;
+    iso: null | string;
+    js_date: Date;
+    operational_date: OperationalDate;
+    std_window: {
+        end: UnixTimestamp;
+        start: UnixTimestamp;
+    };
+    unix_timestamp: UnixTimestamp;
+    constructor(params: DatesConstructor);
     static get FORMATS(): {
         DATE_FULL: DatesFormat;
         DATE_FULL_WITH_YEAR: DatesFormat;
@@ -39,15 +50,6 @@ export declare class Dates {
     };
     static get TIMEZONE_LIST(): readonly ["Africa/Abidjan", "Africa/Accra", "Africa/Algiers", "Africa/Bissau", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/El_Aaiun", "Africa/Johannesburg", "Africa/Juba", "Africa/Khartoum", "Africa/Lagos", "Africa/Maputo", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Sao_Tome", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Asuncion", "America/Atikokan", "America/Bahia_Banderas", "America/Bahia", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Cayenne", "America/Chicago", "America/Chihuahua", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson_Creek", "America/Dawson", "America/Denver", "America/Detroit", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Fort_Nelson", "America/Fortaleza", "America/Glace_Bay", "America/Goose_Bay", "America/Grand_Turk", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Juneau", "America/Kentucky", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Maceio", "America/Managua", "America/Manaus", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port_of_Spain", "America/Port-au-Prince", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Sitka", "America/St_Johns", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Vancouver", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Atyrau", "Asia/Baghdad", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Chita", "Asia/Choibalsan", "Asia/Colombo", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kathmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Riyadh", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ulaanbaatar", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faroe", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/Stanley", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/Perth", "Australia/Sydney", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belgrade", "Europe/Berlin", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Helsinki", "Europe/Istanbul", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Paris", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/Saratov", "Europe/Simferopol", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zaporozhye", "Europe/Zurich", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Reunion", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Wake", "Pacific/Wallis"];
     static get TIMEZONE_LIST_VALUES(): import("zod").Values<["Africa/Abidjan", "Africa/Accra", "Africa/Algiers", "Africa/Bissau", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/El_Aaiun", "Africa/Johannesburg", "Africa/Juba", "Africa/Khartoum", "Africa/Lagos", "Africa/Maputo", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Sao_Tome", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Asuncion", "America/Atikokan", "America/Bahia_Banderas", "America/Bahia", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Cayenne", "America/Chicago", "America/Chihuahua", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson_Creek", "America/Dawson", "America/Denver", "America/Detroit", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Fort_Nelson", "America/Fortaleza", "America/Glace_Bay", "America/Goose_Bay", "America/Grand_Turk", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Juneau", "America/Kentucky", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Maceio", "America/Managua", "America/Manaus", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port_of_Spain", "America/Port-au-Prince", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Sitka", "America/St_Johns", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Vancouver", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Atyrau", "Asia/Baghdad", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Chita", "Asia/Choibalsan", "Asia/Colombo", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kathmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Riyadh", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ulaanbaatar", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faroe", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/Stanley", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/Perth", "Australia/Sydney", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belgrade", "Europe/Berlin", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Helsinki", "Europe/Istanbul", "Europe/Kaliningrad", "Europe/Kiev", "Europe/Kirov", "Europe/Lisbon", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Paris", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/Saratov", "Europe/Simferopol", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zaporozhye", "Europe/Zurich", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Reunion", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Wake", "Pacific/Wallis"]>;
-    iso: null | string;
-    js_date: Date;
-    operational_date: OperationalDate;
-    std_window: {
-        end: UnixTimestamp;
-        start: UnixTimestamp;
-    };
-    unix_timestamp: UnixTimestamp;
-    constructor({ iso, js_date, operational_date, std_window, unix_timestamp }: DatesConstructor);
     /**
      * Creates a Dates object from a date/time string in a specific format.
      * @param text The date/time string to parse.

package/dist/dates.js

@@ -1,34 +1,28 @@
-/* * */
-import { FORMATS, OPERATIONAL_DATE_FORMAT } from './lib/date-format.js';
+/* eslint-disable @typescript-eslint/naming-convention */
+import { CALENDAR_DATE_FORMAT, FORMATS, OPERATIONAL_DATE_FORMAT } from './lib/date-format.js';
 import { TimezoneIdentifiedSchema, TimezoneIdentifiedValues } from './lib/timezone-identified.js';
 import { DateTime } from 'luxon';
 /* * */
 export class Dates {
     //
-    //
-    // Static properties
-    static STANDARD_WINDOW_HOURS = 10;
-    static get FORMATS() { return FORMATS; }
-    static get TIMEZONE_LIST() { return TimezoneIdentifiedValues; }
-    static get TIMEZONE_LIST_VALUES() { return TimezoneIdentifiedSchema.Values; }
-    //
-    // Instance properties
+    static standardWindowHours = 10;
+    calendar_date;
     iso;
     js_date;
     operational_date;
     std_window;
     unix_timestamp;
-    //
-    // Constructor
-    constructor({ iso, js_date, operational_date, std_window, unix_timestamp }) {
-        this.iso = iso ?? null;
-        this.js_date = js_date;
-        this.operational_date = operational_date;
-        this.std_window = std_window;
-        this.unix_timestamp = unix_timestamp;
+    constructor(params) {
+        this.calendar_date = params.calendar_date;
+        this.iso = params.iso ?? null;
+        this.js_date = params.js_date;
+        this.operational_date = params.operational_date;
+        this.std_window = params.std_window;
+        this.unix_timestamp = params.unix_timestamp;
     }
-    //
-    // Static methods
+    static get FORMATS() { return FORMATS; }
+    static get TIMEZONE_LIST() { return TimezoneIdentifiedValues; }
+    static get TIMEZONE_LIST_VALUES() { return TimezoneIdentifiedSchema.Values; }
     /**
      * Creates a Dates object from a date/time string in a specific format.
      * @param text The date/time string to parse.
@@ -42,6 +36,7 @@ export class Dates {
             .fromFormat(text, format, { setZone: true })
             .setZone(timezone, { keepLocalTime: true });
         return new Dates({
+            calendar_date: dateTime.toFormat(CALENDAR_DATE_FORMAT),
             iso: dateTime.toISO(),
             js_date: dateTime.toJSDate(),
             operational_date: this.prototype.getOperationalDate(dateTime.toISO()),
@@ -58,6 +53,7 @@ export class Dates {
     static fromISO(isoText) {
         const dateTime = DateTime.fromISO(isoText, { setZone: true });
         return new Dates({
+            calendar_date: dateTime.toFormat(CALENDAR_DATE_FORMAT),
             iso: dateTime.toISO(),
             js_date: dateTime.toJSDate(),
             operational_date: this.prototype.getOperationalDate(dateTime.toISO()),
@@ -75,6 +71,7 @@ export class Dates {
             .fromJSDate(date)
             .setZone('utc', { keepLocalTime: false });
         return new Dates({
+            calendar_date: dateTime.toFormat(CALENDAR_DATE_FORMAT),
             iso: dateTime.toISO(),
             js_date: dateTime.toJSDate(),
             operational_date: this.prototype.getOperationalDate(dateTime.toISO()),
@@ -94,6 +91,7 @@ export class Dates {
             .setZone(timezone, { keepLocalTime: true })
             .set({ hour: 4, millisecond: 0, minute: 0, second: 0 }); // Start of the operational date
         return new Dates({
+            calendar_date: dateTime.toFormat(CALENDAR_DATE_FORMAT),
             iso: dateTime.toISO(),
             js_date: dateTime.toJSDate(),
             operational_date: this.prototype.getOperationalDate(dateTime.toISO()),
@@ -111,6 +109,7 @@ export class Dates {
             .fromSeconds(seconds)
             .setZone('utc', { keepLocalTime: false });
         return new Dates({
+            calendar_date: dateTime.toFormat(CALENDAR_DATE_FORMAT),
             iso: dateTime.toISO(),
             js_date: dateTime.toJSDate(),
             operational_date: this.prototype.getOperationalDate(dateTime.toISO()),
@@ -128,6 +127,7 @@ export class Dates {
             .fromMillis(millis)
             .setZone('utc', { keepLocalTime: false });
         return new Dates({
+            calendar_date: dateTime.toFormat(CALENDAR_DATE_FORMAT),
             iso: dateTime.toISO(),
             js_date: dateTime.toJSDate(),
             operational_date: this.prototype.getOperationalDate(dateTime.toISO()),
@@ -145,6 +145,7 @@ export class Dates {
             .now()
             .setZone(timezone, { keepLocalTime: false });
         return new Dates({
+            calendar_date: dateTime.toFormat(CALENDAR_DATE_FORMAT),
             iso: dateTime.toISO(),
             js_date: dateTime.toJSDate(),
             operational_date: this.prototype.getOperationalDate(dateTime.toISO()),
@@ -157,15 +158,15 @@ export class Dates {
      * Returns an empty array if the request fails
      */
     static async fetchCalendarData() {
-        let calendarJson = [];
         try {
+            let calendarJson = [];
             const response = await fetch('https://go.carrismetropolitana.pt/api/dates/public');
             calendarJson = !response.ok ? [] : await response.json();
+            return calendarJson;
         }
         catch (error) {
             console.error('Error fetching calendar data:', error);
         }
-        return calendarJson;
     }
     /**
      * Returns the difference between this date and another date.
@@ -192,6 +193,7 @@ export class Dates {
             .fromISO(this.iso, { setZone: true })
             .endOf(unit);
         return new Dates({
+            calendar_date: dateTime.toFormat(CALENDAR_DATE_FORMAT),
             iso: dateTime.toISO(),
             js_date: dateTime.toJSDate(),
             operational_date: this.getOperationalDate(dateTime.toISO()),
@@ -211,6 +213,7 @@ export class Dates {
             .fromISO(this.iso, { setZone: true })
             .minus(duration);
         return new Dates({
+            calendar_date: dateTime.toFormat(CALENDAR_DATE_FORMAT),
             iso: dateTime.toISO(),
             js_date: dateTime.toJSDate(),
             operational_date: this.getOperationalDate(dateTime.toISO()),
@@ -230,6 +233,7 @@ export class Dates {
             .fromISO(this.iso, { setZone: true })
             .plus(duration);
         return new Dates({
+            calendar_date: dateTime.toFormat(CALENDAR_DATE_FORMAT),
             iso: dateTime.toISO(),
             js_date: dateTime.toJSDate(),
             operational_date: this.getOperationalDate(dateTime.toISO()),
@@ -249,6 +253,7 @@ export class Dates {
             .fromISO(this.iso, { setZone: true })
             .set(dateOrTime);
         return new Dates({
+            calendar_date: dateTime.toFormat(CALENDAR_DATE_FORMAT),
             iso: dateTime.toISO(),
             js_date: dateTime.toJSDate(),
             operational_date: this.getOperationalDate(dateTime.toISO()),
@@ -271,6 +276,7 @@ export class Dates {
             .fromISO(this.iso, { setZone: true })
             .setZone(timezone, { keepLocalTime: method === 'rebase_utc' });
         return new Dates({
+            calendar_date: dateTime.toFormat(CALENDAR_DATE_FORMAT),
             iso: dateTime.toISO(),
             js_date: dateTime.toJSDate(),
             operational_date: this.getOperationalDate(dateTime.toISO()),
@@ -290,6 +296,7 @@ export class Dates {
             .fromISO(this.iso, { setZone: true })
             .startOf(unit);
         return new Dates({
+            calendar_date: dateTime.toFormat(CALENDAR_DATE_FORMAT),
             iso: dateTime.toISO(),
             js_date: dateTime.toJSDate(),
             operational_date: this.getOperationalDate(dateTime.toISO()),
@@ -304,11 +311,14 @@ export class Dates {
      * @returns { minutes: number, hours: number, days: number }
      */
     timeUntil(unixTimestamp) {
+        // Calculate the difference in milliseconds
         const now = Date.now();
         const diffMs = unixTimestamp - now;
+        // Calculate the time remaining
         const minutes = diffMs / (1000 * 60);
         const hours = diffMs / (1000 * 60 * 60);
         const days = diffMs / (1000 * 60 * 60 * 24);
+        // Return the time components
         return { days, hours, minutes };
     }
     /**
@@ -364,36 +374,32 @@ export class Dates {
             dateTime.setLocale(locale);
         return dateTime.toLocaleString(format, { locale: locale });
     }
-    //
-    // Private methods
     /**
      * Returns the operational date based on the provided timestamp and format.
      * @param timestamp - The timestamp to be parsed.
      * @returns The operational date in the yyyyLLdd format.
      */
     getOperationalDate(isoDate) {
+        // Skip if the ISO date is not set
         if (!isoDate)
             throw new Error('ISO date is not set.');
-        //
         // Get the date object
         const dateObject = DateTime.fromISO(isoDate, { setZone: true });
-        //
         // Check if the time is between 00:00 and 03:59.
         // The operational date is between 04:00 and 03:59 of the following day.
         let operationalDate;
         if (dateObject.hour < 4) {
-            // If true, return the previous day in the yyyyLLdd format
-            const previousDay = dateObject.minus({ days: 1 });
+            // If true, unwind the clock by 12 hours to
+            // return the previous day in the yyyyLLdd format
+            const previousDay = dateObject.minus({ hours: 12 });
             operationalDate = previousDay.toFormat(OPERATIONAL_DATE_FORMAT);
         }
         else {
             // Else, return the current day in the yyyyLLdd format
             operationalDate = dateObject.toFormat(OPERATIONAL_DATE_FORMAT);
         }
-        //
-        // Validate the operational date and return it
+        // Return the date as an operational date
         return operationalDate;
-        //
     }
     /**
      * This function returns the start and end of the standard window interval for a given timestamp.
@@ -407,8 +413,8 @@ export class Dates {
             throw new Error('ISO date is not set.');
         const dateTime = DateTime.fromISO(isoDate, { setZone: true });
         return {
-            end: dateTime.plus({ hours: Dates.STANDARD_WINDOW_HOURS }).toMillis(),
-            start: dateTime.minus({ hours: Dates.STANDARD_WINDOW_HOURS }).toMillis(),
+            end: dateTime.plus({ hours: Dates.standardWindowHours }).toMillis(),
+            start: dateTime.minus({ hours: Dates.standardWindowHours }).toMillis(),
         };
     }
 }

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

@@ -9,6 +9,7 @@ export interface DatesFormat {
     year?: '2-digit' | 'numeric';
 }
 export declare const OPERATIONAL_DATE_FORMAT = "yyyyMMdd";
+export declare const CALENDAR_DATE_FORMAT = "yyyy-MM-dd";
 export declare const FORMATS: {
     DATE_FULL: DatesFormat;
     DATE_FULL_WITH_YEAR: DatesFormat;

package/dist/lib/date-format.js

@@ -82,6 +82,7 @@ const DATETIME_FULL_WITH_SECONDS = {
     year: n,
 };
 export const OPERATIONAL_DATE_FORMAT = 'yyyyMMdd';
+export const CALENDAR_DATE_FORMAT = 'yyyy-MM-dd';
 export const FORMATS = {
     DATE_FULL,
     DATE_FULL_WITH_YEAR,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/dates",
-	"version": "20260616.1147.27",
+	"version": "20260616.2238.2",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"