@atlantjs/arch 15.7.7 → 15.7.8

package/src/objects/datetime/edges/datetime.edge.js

@@ -0,0 +1,675 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatetimeEdge = void 0;
+const date_holidays_1 = __importDefault(require("date-holidays"));
+const moment_1 = __importDefault(require("moment"));
+const guardian_1 = require("../../../@tool-box/utils/type-guard/guardian");
+const day_name_to_english_mapper_1 = require("../../../objects/datetime/edges/locale/day/day-name-to-english.mapper");
+const day_name_to_portuguese_mapper_1 = require("../../../objects/datetime/edges/locale/day/day-name-to-portuguese.mapper");
+const today_to_language_mapper_1 = require("../../../objects/datetime/edges/locale/day/today-to-language.mapper");
+const month_to_english_mapper_1 = require("../../../objects/datetime/edges/locale/month/month-to-english.mapper");
+const month_to_portuguese_mapper_1 = require("../../../objects/datetime/edges/locale/month/month-to-portuguese.mapper");
+const week_day_enum_1 = require("../../../objects/datetime/points/week-day.enum");
+const language_point_1 = require("../../../objects/language/points/language.point");
+class DatetimeEdge {
+    value;
+    date;
+    constructor(value) {
+        this.value = value;
+        let dateValue;
+        if (guardian_1._.isUndefined(this.value)) {
+            dateValue = new Date(Date.now());
+        }
+        else if (guardian_1._.isTypeOf(this.value, "string")) {
+            const parsedDate = new Date(this.value);
+            if (Number.isNaN(parsedDate.getTime())) {
+                throw new Error(`Invalid date string: ${this.value}`);
+            }
+            dateValue = parsedDate;
+        }
+        else {
+            dateValue = this.value;
+        }
+        this.date = (0, moment_1.default)(dateValue);
+        this.validate();
+    }
+    /**
+     * Returns a human-friendly date string in the format "Day, Mon DD".
+     * Uses day and month names in the specified locale.
+     * @returns A formatted string such as "Sunday, Mar 29" or "Today, Apr 1"
+     * @example
+     * new DatetimeEdge(new Date("2026-03-29")).toFriendlyString() // "Sunday, Mar 29"
+     * new DatetimeEdge(new Date()).toFriendlyString() // "Today, Apr 1"
+     */
+    toFriendlyString(language) {
+        let dayOfWeekLabel = this.getDayOfWeek(language);
+        const monthLabel = this.getNameOfMonth(language);
+        if (this.isToday()) {
+            dayOfWeekLabel = new today_to_language_mapper_1.TodayToLanguageMapper().toMap(language);
+        }
+        const dayOfMonth = this.getDayOfMonth();
+        return `${dayOfWeekLabel}, ${monthLabel} ${dayOfMonth}`;
+    }
+    // ==================== Comparações ====================
+    /**
+     * Checks whether this date is later than another date.
+     * @param datetime - Date to compare against.
+     * @returns `true` if this date is greater than `datetime`; otherwise, `false`.
+     * @example
+     * new DatetimeEdge(new Date("2026-12-01")).isAfter(new DatetimeEdge(new Date("2026-01-01"))) // true
+     */
+    isAfter(datetime) {
+        return this.date.isAfter(datetime.toDate());
+    }
+    /**
+     * Checks whether this date is earlier than another date.
+     * @param datetime - Date to compare against.
+     * @returns `true` if this date is less than `datetime`; otherwise, `false`.
+     * @example
+     * new DatetimeEdge(new Date("2026-01-01")).isBefore(new DatetimeEdge(new Date("2026-12-01"))) // true
+     */
+    isBefore(datetime) {
+        return this.date.isBefore(datetime.toDate());
+    }
+    /**
+     * Checks whether this date is equal to another date.
+     * @param datetime - Date to compare against.
+     * @returns `true` if the dates are equal; otherwise, `false`.
+     * @example
+     * new DatetimeEdge(new Date("2026-01-01")).isEquals(new DatetimeEdge(new Date("2026-01-01"))) // true
+     */
+    isEquals(datetime) {
+        return this.date.isSame(datetime.toDate());
+    }
+    /**
+     * Verifica se esta data está entre duas outras datas (exclusivo).
+     * @param initialDate - Data inicial do intervalo
+     * @param finalDate - Data final do intervalo
+     * @returns true se this está entre initialDate e finalDate, false caso contrário
+     * @example
+     * new DatetimeEdge(new Date("2026-06-15")).isBetween(
+     *   new DatetimeEdge(new Date("2026-01-01")),
+     *   new DatetimeEdge(new Date("2026-12-31"))
+     * ) // true
+     */
+    isBetween(initialDate, finalDate) {
+        return this.date.isBetween(initialDate.toDate(), finalDate.toDate());
+    }
+    // ==================== Verificações de Dia ====================
+    /**
+     * Checks whether this date falls on a weekend (Saturday or Sunday).
+     * @returns `true` if the date is a Saturday or Sunday; otherwise, `false`.
+     * @example
+     * new DatetimeEdge(new Date("2026-03-14")).isWeekend() // true (Saturday)
+     * new DatetimeEdge(new Date("2026-03-12")).isWeekend() // false (Thursday)
+     */
+    isWeekend() {
+        return [week_day_enum_1.WeekDayEnum.saturday, week_day_enum_1.WeekDayEnum.sunday].includes(this.getStandardDayOfWeek());
+    }
+    /**
+     * Checks whether this date is a holiday in the specified country.
+     * @param country - The country whose holiday calendar will be used for validation.
+     * @returns `true` if the date is a holiday in the specified country; otherwise, `false`.
+     * @example
+     * new DatetimeEdge(new Date("2026-12-25")).isHoliday("BR") // true (Christmas Day)
+     * new DatetimeEdge(new Date("2026-03-12")).isHoliday("BR") // false
+     */
+    isHoliday(country) {
+        const holidays = new date_holidays_1.default(country);
+        return holidays.isHoliday(this.date.toDate()) !== false;
+    }
+    /**
+     * Checks whether the date is a business day (not a weekend or a holiday).
+     * @param country - The country whose holiday calendar will be used for validation.
+     * @returns `true` if the date is a business day; otherwise, `false`.
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).isBusinessDay("BR") // true (Thursday)
+     * new DatetimeEdge(new Date("2026-12-25")).isBusinessDay("BR") // false (Christmas Day)
+     */
+    isBusinessDay(country) {
+        return !this.isWeekend() && !this.isHoliday(country);
+    }
+    /**
+     * Checks whether the date corresponds to today.
+     * @returns `true` if the date is today; otherwise, `false`.
+     * @example
+     * new DatetimeEdge(new Date()).isToday() // true
+     * new DatetimeEdge(new Date("2020-01-01")).isToday() // false
+     */
+    isToday() {
+        return this.date.isSame((0, moment_1.default)(), "day");
+    }
+    /**
+     * Checks whether the date corresponds to yesterday.
+     * @returns `true` if the date is yesterday; otherwise, `false`.
+     * @example
+     * new DatetimeEdge(new Date()).isYesterday() // false
+     */
+    isYesterday() {
+        return this.date.isSame((0, moment_1.default)().subtract(1, "day"), "day");
+    }
+    /**
+     * Checks whether the date corresponds to tomorrow.
+     * @returns `true` if the date is tomorrow; otherwise, `false`.
+     * @example
+     * new DatetimeEdge(new Date()).isTomorrow() // false
+     */
+    isTomorrow() {
+        return this.date.isSame((0, moment_1.default)().add(1, "day"), "day");
+    }
+    /**
+     * Checks whether the date is on the same day as another date.
+     * @param datetime - Date for comparison
+     * @returns `true` if both dates are on the same day, `false` otherwise
+     * @example
+     * const a = new DatetimeEdge(new Date("2026-03-12T08:00"));
+     * const b = new DatetimeEdge(new Date("2026-03-12T22:00"));
+     * a.isSameDay(b) // true
+     */
+    isSameDay(datetime) {
+        return this.date.isSame(datetime.toDate(), "day");
+    }
+    /**
+     * Checks whether the date is on the same month as another date.
+     * @param datetime - Date for comparison
+     * @returns `true` if both dates are on the same month and year, `false` otherwise
+     * @example
+     * const a = new DatetimeEdge(new Date("2026-03-01"));
+     * const b = new DatetimeEdge(new Date("2026-03-31"));
+     * a.isSameMonth(b) // true
+     */
+    isSameMonth(datetime) {
+        return this.date.isSame(datetime.toDate(), "month");
+    }
+    /**
+     * Checks whether the date is on the same year as another date.
+     * @param datetime - Date for comparison
+     * @returns `true` if both dates are on the same year, `false` otherwise
+     * @example
+     * const a = new DatetimeEdge(new Date("2026-01-01"));
+     * const b = new DatetimeEdge(new Date("2026-12-31"));
+     * a.isSameYear(b) // true
+     */
+    isSameYear(datetime) {
+        return this.date.isSame(datetime.toDate(), "year");
+    }
+    // ==================== Getters ====================
+    /**
+     * Returns the day of the week for the date.
+     * @returns Enum WeekDayEnum representing the day of the week
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).getDayOfWeek() // WeekDayEnum.thursday
+     */
+    getDayOfWeek(language) {
+        let dayOfWeek = new day_name_to_english_mapper_1.DayNameToEnglishMapper().toMap(this.date.day());
+        if (guardian_1._.isEqual(language, language_point_1.LanguagePoint.portuguese)) {
+            dayOfWeek = new day_name_to_portuguese_mapper_1.DayNameToPortugueseMapper().toMap(this.date.day());
+        }
+        return dayOfWeek;
+    }
+    /**
+     * Returns the standard day of the week as a {@link WeekDayEnum} value.
+     * This internal method provides the canonical weekday representation
+     * used throughout the class before any localization or formatting is applied.
+     *
+     * @returns The corresponding {@link WeekDayEnum} for the current date.
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).getStandardDayOfWeek() // WeekDayEnum.thursday
+     */
+    getStandardDayOfWeek() {
+        const daysOfWeek = [
+            week_day_enum_1.WeekDayEnum.sunday,
+            week_day_enum_1.WeekDayEnum.monday,
+            week_day_enum_1.WeekDayEnum.tuesday,
+            week_day_enum_1.WeekDayEnum.wednesday,
+            week_day_enum_1.WeekDayEnum.thursday,
+            week_day_enum_1.WeekDayEnum.friday,
+            week_day_enum_1.WeekDayEnum.saturday,
+        ];
+        return daysOfWeek[this.date.day()];
+    }
+    /**
+     * Returns the name of the month for the date.
+     * @returns Enum MonthNameEnum representing the month
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).getNameOfMonth() // MonthNameEnum.march
+     */
+    getNameOfMonth(language) {
+        let month = new month_to_english_mapper_1.MonthNameToEnglishMapper().toMap(this.date.month());
+        if (guardian_1._.isEqual(language, language_point_1.LanguagePoint.portuguese)) {
+            month = new month_to_portuguese_mapper_1.MonthNameToPortugueseMapper().toMap(this.date.month());
+        }
+        return month;
+    }
+    /**
+     * Returns the day of the month for the date.
+     * @returns NNumber of the day (1-31)
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).getDayOfMonth() // 12
+     */
+    getDayOfMonth() {
+        return this.date.date();
+    }
+    /**
+     * Returns the month number for the date (0-11).
+     * @returns Month number (0=January, 11=December)
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).getNumberOfMonth() // 2
+     */
+    getNumberOfMonth() {
+        return this.date.month();
+    }
+    /**
+     * Returns the year of the date.
+     * @returns The year number.
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).getYear() // 2026
+     */
+    getYear() {
+        return this.date.year();
+    }
+    /**
+     * Returns the hours of the date.
+     * @returns The hour number (0-23)
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12T14:30:00")).getHours() // 14
+     */
+    getHours() {
+        return this.date.hours();
+    }
+    /**
+     * Returns the minutes of the date.
+     * @returns The minute number (0-59)
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12T14:30:00")).getMinutes() // 30
+     */
+    getMinutes() {
+        return this.date.minutes();
+    }
+    /**
+     * Returns the seconds of the date.
+     * @returns The second number (0-59)
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12T14:30:45")).getSeconds() // 45
+     */
+    getSeconds() {
+        return this.date.seconds();
+    }
+    // ==================== Operações Aritméticas ====================
+    /**
+     * Adds days to the date and returns a new instance.
+     * @param days - NNumber of days to add
+     * @returns New instance with the updated date
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).addDays(5) // DatetimeEdge("2026-03-17")
+     */
+    addDays(days) {
+        return new DatetimeEdge(this.date.clone().add(days, "days").toDate());
+    }
+    /**
+     * Subtracts days from the date and returns a new instance.
+     * @param days - NNumber of days to subtract
+     * @returns New instance with the updated date
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).subtractDays(5) // DatetimeEdge("2026-03-07")
+     */
+    subtractDays(days) {
+        return new DatetimeEdge(this.date.clone().subtract(days, "days").toDate());
+    }
+    /**
+     * Adds months to the date and returns a new instance.
+     * @param months - NNumber of months to add
+     * @returns New instance with the updated date
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).addMonths(2) // DatetimeEdge("2026-05-12")
+     */
+    addMonths(months) {
+        return new DatetimeEdge(this.date.clone().add(months, "months").toDate());
+    }
+    /**
+     * Subtracts months from the date and returns a new instance.
+     * @param months - NNumber of months to subtract
+     * @returns New instance with the updated date
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).subtractMonths(2) // DatetimeEdge("2026-01-12")
+     */
+    subtractMonths(months) {
+        return new DatetimeEdge(this.date.clone().subtract(months, "months").toDate());
+    }
+    /**
+     * Adds years to the date and returns a new instance.
+     * @param years - NNumber of years to add
+     * @returns New instance with the updated date
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).addYears(1) // DatetimeEdge("2027-03-12")
+     */
+    addYears(years) {
+        return new DatetimeEdge(this.date.clone().add(years, "years").toDate());
+    }
+    /**
+     * Subtracts years from the date and returns a new instance.
+     * @param years - NNumber of years to subtract
+     * @returns New instance with the updated date
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).subtractYears(1) // DatetimeEdge("2025-03-12")
+     */
+    subtractYears(years) {
+        return new DatetimeEdge(this.date.clone().subtract(years, "years").toDate());
+    }
+    /**
+     * Adds hours to the date and returns a new instance.
+     * @param hours - NNumber of hours to add
+     * @returns New instance with the updated date
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12T08:00")).addHours(3) // DatetimeEdge("2026-03-12T11:00")
+     */
+    addHours(hours) {
+        return new DatetimeEdge(this.date.clone().add(hours, "hours").toDate());
+    }
+    /**
+     * Adds minutes to the date and returns a new instance.
+     * @param minutes - NNumber of minutes to add
+     * @returns New instance with the updated date
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12T08:00")).addMinutes(30) // DatetimeEdge("2026-03-12T08:30")
+     */
+    addMinutes(minutes) {
+        return new DatetimeEdge(this.date.clone().add(minutes, "minutes").toDate());
+    }
+    /**
+     * Calculates the difference in days between this date and another.
+     * @param datetime - Date to calculate the difference from
+     * @returns NNumber of days difference (positive if this > datetime)
+     * @example
+     * new DatetimeEdge(new Date("2026-03-15")).diffInDays(new DatetimeEdge(new Date("2026-03-10"))) // 5
+     */
+    diffInDays(datetime) {
+        return this.date.diff(datetime.toDate(), "days");
+    }
+    /**
+     * Calculates the difference in months between this date and another.
+     * @param datetime - Date to calculate the difference from
+     * @returns NNumber of months difference (positive if this > datetime)
+     * @example
+     * new DatetimeEdge(new Date("2026-05-12")).diffInMonths(new DatetimeEdge(new Date("2026-03-12"))) // 2
+     */
+    diffInMonths(datetime) {
+        return this.date.diff(datetime.toDate(), "months");
+    }
+    /**
+     * Calculates the difference in years between this date and another date.
+     * @param datetime - Date to calculate the difference against.
+     * @returns The number of years between the dates (positive if this date is later than `datetime`).
+     * @example
+     * new DatetimeEdge(new Date("2028-03-12")).diffInYears(new DatetimeEdge(new Date("2026-03-12"))) // 2
+     */
+    diffInYears(datetime) {
+        return this.date.diff(datetime.toDate(), "years");
+    }
+    /**
+     * Calcula a diferença em horas entre esta data e outra.
+     * @param datetime - Data para calcular a diferença
+     * @returns Número de horas de diferença (positivo se this > datetime)
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12T14:00")).diffInHours(new DatetimeEdge(new Date("2026-03-12T08:00"))) // 6
+     */
+    diffInHours(datetime) {
+        return this.date.diff(datetime.toDate(), "hours");
+    }
+    /**
+     * Calculates the difference in minutes between this date and another date.
+     * @param datetime - Date to calculate the difference against.
+     * @returns The number of minutes between the dates (positive if this date is later than `datetime`).
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12T08:45")).diffInMinutes(new DatetimeEdge(new Date("2026-03-12T08:00"))) // 45
+     */
+    diffInMinutes(datetime) {
+        return this.date.diff(datetime.toDate(), "minutes");
+    }
+    /**
+     * Returns a human-readable difference between this date and the current moment.
+     * @returns A descriptive string such as "3 days ago.", "2 hours ago.", etc.
+     * @example
+     * new DatetimeEdge(new Date("2025-03-12")).diffFromNow() // "1 year ago."
+     */
+    diffFromNow() {
+        const now = (0, moment_1.default)();
+        const diffInSeconds = now.diff(this.date, "seconds");
+        const diffInMinutes = now.diff(this.date, "minutes");
+        const diffInHours = now.diff(this.date, "hours");
+        const diffInDays = now.diff(this.date, "days");
+        const diffInMonths = now.diff(this.date, "months");
+        const diffInYears = now.diff(this.date, "years");
+        if (diffInSeconds < 60) {
+            return `Há ${diffInSeconds} segundo${diffInSeconds === 1 ? "" : "s"}.`;
+        }
+        if (diffInMinutes < 60) {
+            return `Há ${diffInMinutes} minuto${diffInMinutes === 1 ? "" : "s"}.`;
+        }
+        if (diffInHours < 24) {
+            return `Há ${diffInHours} hora${diffInHours === 1 ? "" : "s"}.`;
+        }
+        if (diffInDays < 30) {
+            return `Há ${diffInDays} dia${diffInDays === 1 ? "" : "s"}.`;
+        }
+        if (diffInMonths < 12) {
+            return `Há ${diffInMonths} mês${diffInMonths === 1 ? "" : "es"}.`;
+        }
+        return `Há ${diffInYears} ano${diffInYears === 1 ? "" : "s"}.`;
+    }
+    // ==================== Início e Fim de Período ====================
+    /**
+     * Returns the start of the day (00:00:00.000) as a new instance.
+     * @returns A new instance with the time set to the beginning of the day
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12T14:30")).startOfDay()
+     * // DatetimeEdge("2026-03-12T00:00:00.000")
+     */
+    startOfDay() {
+        return new DatetimeEdge(this.date.clone().startOf("day").toDate());
+    }
+    /**
+     * Returns the end of the day (23:59:59.999) as a new instance.
+     * @returns A new instance with the time set to the end of the day
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12T08:00")).endOfDay()
+     * // DatetimeEdge("2026-03-12T23:59:59.999")
+     */
+    endOfDay() {
+        return new DatetimeEdge(this.date.clone().endOf("day").toDate());
+    }
+    /**
+     * Returns the start of the month as a new instance.
+     * @returns A new instance pointing to the first day of the month at midnight
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).startOfMonth()
+     * // DatetimeEdge("2026-03-01T00:00:00.000")
+     */
+    startOfMonth() {
+        return new DatetimeEdge(this.date.clone().startOf("month").toDate());
+    }
+    /**
+     * Returns the end of the month as a new instance.
+     * @returns A new instance pointing to the last day of the month at the end of the day
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).endOfMonth()
+     * // DatetimeEdge("2026-03-31T23:59:59.999")
+     */
+    endOfMonth() {
+        return new DatetimeEdge(this.date.clone().endOf("month").toDate());
+    }
+    /**
+     * Returns the start of the year as a new instance.
+     * @returns A new instance pointing to the first day of the year at midnight
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).startOfYear()
+     * // DatetimeEdge("2026-01-01T00:00:00.000")
+     */
+    startOfYear() {
+        return new DatetimeEdge(this.date.clone().startOf("year").toDate());
+    }
+    /**
+     * Returns the end of the year as a new instance.
+     * @returns A new instance pointing to the last day of the year at the end of the day
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).endOfYear()
+     * // DatetimeEdge("2026-12-31T23:59:59.999")
+     */
+    endOfYear() {
+        return new DatetimeEdge(this.date.clone().endOf("year").toDate());
+    }
+    // ==================== Clonagem e Imutabilidade ====================
+    /**
+     * Creates an independent copy of this DatetimeEdge instance.
+     * @returns A new instance with the same date value
+     * @example
+     * const dt1 = new DatetimeEdge(new Date("2026-03-12"));
+     * const dt2 = dt1.clone(); // independent instance
+     */
+    clone() {
+        return new DatetimeEdge(this.date.toDate());
+    }
+    /**
+     * Returns a new instance with the date changed, keeping the time.
+     * @param date - New Date object
+     * @returns New instance with the provided value
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).withDate(new Date("2026-12-25"))
+     * // DatetimeEdge("2026-12-25")
+     */
+    withDate(date) {
+        return new DatetimeEdge(date);
+    }
+    // ==================== Formatação ====================
+    /**
+     * Returns the date in ISO 8601 format.
+     * @returns String in the format "YYYY-MM-DDTHH:mm:ss.sssZ"
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).toISOString() // "2026-03-12T00:00:00.000Z"
+     */
+    toISOString() {
+        return this.date.toISOString();
+    }
+    /**
+     * Returns the date as a native Date object.
+     * @returns Date object representing this date
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).toDate() // Date object
+     */
+    toDate() {
+        return this.date.toDate();
+    }
+    /**
+     * Returns the date in YYYY-MM-DD format.
+     * @returns String in the format "YYYY-MM-DD"
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).toYYYYMMDD() // "2026-03-12"
+     */
+    toYYYYMMDD() {
+        return this.date.format("YYYY-MM-DD");
+    }
+    /**
+     * Returns the date in DD/MM/YYYY format (Brazilian standard).
+     * @returns String no formato "DD/MM/YYYY"
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).toDDMMYYYY() // "12/03/2026"
+     */
+    toDDMMYYYY() {
+        return this.date.format("DD/MM/YYYY");
+    }
+    /**
+     * Returns the date and time in the format DD/MM/YYYY HH:mm.
+     * @returns A string in the format "DD/MM/YYYY HH:mm".
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12T14:30")).toDDMMYYYYHHmm() // "12/03/2026 14:30"
+     */
+    toDDMMYYYYHHmm() {
+        return this.date.format("DD/MM/YYYY HH:mm");
+    }
+    /**
+     * Returns the date formatted with a custom pattern from moment.js.
+     * @param format - Formatting pattern (e.g., "YYYY-MM-DD HH:mm:ss")
+     * @returns Formatted string according to the provided pattern
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12T14:30")).format("MMMM Do YYYY") // "March 12th 2026"
+     */
+    format(format) {
+        return this.date.format(format);
+    }
+    /**
+     * Returns the timestamp in milliseconds of the date.
+     * @returns NNumber of milliseconds since 01/01/1970 UTC
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).timestamp() // 1773273600000
+     */
+    timestamp() {
+        return this.date.valueOf();
+    }
+    /**
+     * Returns the Unix timestamp in seconds of the date.
+     * @returns NNumber of seconds since 01/01/1970 UTC
+     * @example
+     * new DatetimeEdge(new Date("2026-03-12")).unix() // 1773273600
+     */
+    unix() {
+        return this.date.unix();
+    }
+    // ==================== Métodos Estáticos ====================
+    /**
+     * Creates a new DatetimeEdge representing the current moment.
+     * @returns New instance with the current date and time
+     * @example
+     * DatetimeEdge.now() // DatetimeEdge with the current date and time
+     */
+    static now() {
+        return new DatetimeEdge(new Date());
+    }
+    /**
+     * Returns the latest (most recent) date from an array.
+     * @param dates - Array of DatetimeEdge instances to compare
+     * @returns The instance with the latest date
+     * @throws {Error} If the array is empty
+     * @example
+     * DatetimeEdge.max([
+     *   new DatetimeEdge(new Date("2026-01-01")),
+     *   new DatetimeEdge(new Date("2026-06-15")),
+     * ]) // DatetimeEdge("2026-06-15")
+     */
+    static max(dates) {
+        if (dates.length === 0) {
+            throw new Error("Cannot find max of an empty array of dates.");
+        }
+        return dates.reduce((max, date) => (date.isAfter(max) ? date : max));
+    }
+    /**
+     * Returns the earliest (oldest) date from an array.
+     * @param dates - Array of DatetimeEdge instances to compare
+     * @returns The instance with the earliest date
+     * @throws {Error} If the array is empty
+     * @example
+     * DatetimeEdge.min([
+     *   new DatetimeEdge(new Date("2026-01-01")),
+     *   new DatetimeEdge(new Date("2026-06-15")),
+     * ]) // DatetimeEdge("2026-01-01")
+     */
+    static min(dates) {
+        if (dates.length === 0) {
+            throw new Error("Cannot find min of an empty array of dates.");
+        }
+        return dates.reduce((min, date) => (date.isBefore(min) ? date : min));
+    }
+    // ==================== Privados ====================
+    /**
+     * Validates whether the date provided to the constructor is a valid date.
+     * @throws {Error} If the date is invalid.
+     */
+    validate() {
+        if (!(0, moment_1.default)(this.date).isValid()) {
+            throw new Error(`${this.constructor.name} should be valid.`);
+        }
+    }
+}
+exports.DatetimeEdge = DatetimeEdge;

package/src/objects/datetime/edges/locale/day/day-name-to-english.mapper.d.ts

@@ -1,5 +1,4 @@
-import { MapAbstract } from "#/@tool-box/utils/map/map.abstract";
+import { MapAbstract } from "../../../../../@tool-box/utils/map/map.abstract";
 export declare class DayNameToEnglishMapper extends MapAbstract<number, string> {
     protected map: Map<number, string>;
 }
-//# sourceMappingURL=day-name-to-english.mapper.d.ts.map