@atlantjs/arch 15.6.5 → 15.6.7

package/{objects → src/objects}/datetime/edges/datetime.edge.js

@@ -6,9 +6,13 @@ 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 index_1 = require("../../../index");
-const month_name_enum_1 = require("../points/month-name.enum");
-const week_day_enum_1 = require("../points/week-day.enum");
+const index_1 = require("#/index");
+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");
 class DatetimeEdge {
     constructor(value) {
         this.value = value;
@@ -30,75 +34,52 @@ class DatetimeEdge {
         this.validate();
     }
     /**
-     * Retorna uma string amigável da data no formato "Dia, Mês DD".
-     * Usa nomes de dias e meses no idioma português brasileiro.
-     * @returns String formatada como "Domingo, Mar 29" ou "Hoje, Abr 1"
+     * 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() // "Domingo, Mar 29"
-     * new DatetimeEdge(new Date()).toFriendlyString() // "Hoje, Abr 1"
+     * new DatetimeEdge(new Date("2026-03-29")).toFriendlyString() // "Sunday, Mar 29"
+     * new DatetimeEdge(new Date()).toFriendlyString() // "Today, Apr 1"
      */
     toFriendlyString(language) {
-        const dayNames = [
-            "Domingo",
-            "Segunda",
-            "Terça",
-            "Quarta",
-            "Quinta",
-            "Sexta",
-            "Sábado",
-        ];
-        const monthAbbr = [
-            "Jan",
-            "Fev",
-            "Mar",
-            "Abr",
-            "Mai",
-            "Jun",
-            "Jul",
-            "Ago",
-            "Set",
-            "Out",
-            "Nov",
-            "Dez",
-        ];
-        let dayLabel = dayNames[this.date.day()];
+        let dayOfWeekLabel = this.getDayOfWeek(language);
+        const monthLabel = this.getNameOfMonth(language);
         if (this.isToday()) {
-            dayLabel = "Hoje";
+            dayOfWeekLabel = new today_to_language_mapper_1.TodayToLanguageMapper().toMap(language);
         }
-        const month = monthAbbr[this.date.month()];
-        const day = this.date.date();
-        return `${dayLabel}, ${month} ${day}`;
+        const dayOfMonth = this.getDayOfMonth();
+        return `${dayOfWeekLabel}, ${monthLabel} ${dayOfMonth}`;
     }
     // ==================== Comparações ====================
     /**
-     * Verifica se esta data é posterior a outra.
-     * @param other - Data para comparação
-     * @returns true se this > other, false caso contrário
+     * 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(other) {
-        return this.date.isAfter(other.toDate());
+    isAfter(datetime) {
+        return this.date.isAfter(datetime.toDate());
     }
     /**
-     * Verifica se esta data é anterior a outra.
-     * @param other - Data para comparação
-     * @returns true se this < other, false caso contrário
+     * 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(other) {
-        return this.date.isBefore(other.toDate());
+    isBefore(datetime) {
+        return this.date.isBefore(datetime.toDate());
     }
     /**
-     * Verifica se esta data é igual a outra.
-     * @param other - Data para comparação
-     * @returns true se as datas são iguais, false caso contrário
+     * 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(other) {
-        return this.date.isSame(other.toDate());
+    isEquals(datetime) {
+        return this.date.isSame(datetime.toDate());
     }
     /**
      * Verifica se esta data está entre duas outras datas (exclusivo).
@@ -116,39 +97,41 @@ class DatetimeEdge {
     }
     // ==================== Verificações de Dia ====================
     /**
-     * Verifica se a data cai em um fim de semana (sábado ou domingo).
-     * @returns true se a data é sábado ou domingo, false caso contrário
+     * 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 (sábado)
-     * new DatetimeEdge(new Date("2026-03-12")).isWeekend() // false (quinta-feira)
+     * 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.getDayOfWeek());
+        return [week_day_enum_1.WeekDayEnum.saturday, week_day_enum_1.WeekDayEnum.sunday].includes(this.getStandardDayOfWeek());
     }
     /**
-     * Verifica se a data é um feriado no Brasil.
-     * @returns true se a data é um feriado nacional, false caso contrário
+     * 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() // true (Natal)
-     * new DatetimeEdge(new Date("2026-03-12")).isHoliday() // false
+     * new DatetimeEdge(new Date("2026-12-25")).isHoliday("BR") // true (Christmas Day)
+     * new DatetimeEdge(new Date("2026-03-12")).isHoliday("BR") // false
      */
-    isHoliday() {
-        const holidays = new date_holidays_1.default("BR");
+    isHoliday(country) {
+        const holidays = new date_holidays_1.default(country);
         return holidays.isHoliday(this.date.toDate()) !== false;
     }
     /**
-     * Verifica se a data é um dia útil (não é fim de semana nem feriado).
-     * @returns true se a data é um dia útil, false caso contrário
+     * 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() // true (quinta-feira)
-     * new DatetimeEdge(new Date("2026-12-25")).isBusinessDay() // false (Natal)
+     * new DatetimeEdge(new Date("2026-03-12")).isBusinessDay("BR") // true (Thursday)
+     * new DatetimeEdge(new Date("2026-12-25")).isBusinessDay("BR") // false (Christmas Day)
      */
-    isBusinessDay() {
-        return !this.isWeekend() && !this.isHoliday();
+    isBusinessDay(country) {
+        return !this.isWeekend() && !this.isHoliday(country);
     }
     /**
-     * Verifica se a data corresponde ao dia de hoje.
-     * @returns true se a data é hoje, false caso contrário
+     * 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
@@ -157,8 +140,8 @@ class DatetimeEdge {
         return this.date.isSame((0, moment_1.default)(), "day");
     }
     /**
-     * Verifica se a data corresponde a ontem.
-     * @returns true se a data é ontem, false caso contrário
+     * Checks whether the date corresponds to yesterday.
+     * @returns `true` if the date is yesterday; otherwise, `false`.
      * @example
      * new DatetimeEdge(new Date()).isYesterday() // false
      */
@@ -166,8 +149,8 @@ class DatetimeEdge {
         return this.date.isSame((0, moment_1.default)().subtract(1, "day"), "day");
     }
     /**
-     * Verifica se a data corresponde a amanhã.
-     * @returns true se a data é amanhã, false caso contrário
+     * Checks whether the date corresponds to tomorrow.
+     * @returns `true` if the date is tomorrow; otherwise, `false`.
      * @example
      * new DatetimeEdge(new Date()).isTomorrow() // false
      */
@@ -175,49 +158,65 @@ class DatetimeEdge {
         return this.date.isSame((0, moment_1.default)().add(1, "day"), "day");
     }
     /**
-     * Verifica se a data está no mesmo dia que outra.
-     * @param other - Data para comparação
-     * @returns true se ambas as datas estão no mesmo dia, false caso contrário
+     * 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(other) {
-        return this.date.isSame(other.toDate(), "day");
+    isSameDay(datetime) {
+        return this.date.isSame(datetime.toDate(), "day");
     }
     /**
-     * Verifica se a data está no mesmo mês que outra.
-     * @param other - Data para comparação
-     * @returns true se ambas as datas estão no mesmo mês e ano, false caso contrário
+     * 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(other) {
-        return this.date.isSame(other.toDate(), "month");
+    isSameMonth(datetime) {
+        return this.date.isSame(datetime.toDate(), "month");
     }
     /**
-     * Verifica se a data está no mesmo ano que outra.
-     * @param other - Data para comparação
-     * @returns true se ambas as datas estão no mesmo ano, false caso contrário
+     * 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(other) {
-        return this.date.isSame(other.toDate(), "year");
+    isSameYear(datetime) {
+        return this.date.isSame(datetime.toDate(), "year");
     }
     // ==================== Getters ====================
     /**
-     * Retorna o dia da semana da data.
-     * @returns Enum WeekDayEnum representando o dia da semana
+     * 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() {
+    getDayOfWeek(language) {
+        let dayOfWeek = new day_name_to_english_mapper_1.DayNameToEnglishMapper().toMap(this.date.day());
+        if (index_1._.isEqual(language, index_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,
@@ -230,31 +229,21 @@ class DatetimeEdge {
         return daysOfWeek[this.date.day()];
     }
     /**
-     * Retorna o nome do mês da data.
-     * @returns Enum MonthNameEnum representando o mês
+     * 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() {
-        const months = [
-            month_name_enum_1.MonthNameEnum.january,
-            month_name_enum_1.MonthNameEnum.february,
-            month_name_enum_1.MonthNameEnum.march,
-            month_name_enum_1.MonthNameEnum.april,
-            month_name_enum_1.MonthNameEnum.may,
-            month_name_enum_1.MonthNameEnum.june,
-            month_name_enum_1.MonthNameEnum.july,
-            month_name_enum_1.MonthNameEnum.august,
-            month_name_enum_1.MonthNameEnum.september,
-            month_name_enum_1.MonthNameEnum.october,
-            month_name_enum_1.MonthNameEnum.november,
-            month_name_enum_1.MonthNameEnum.december,
-        ];
-        return months[this.date.month()];
+    getNameOfMonth(language) {
+        let month = new month_to_english_mapper_1.MonthNameToEnglishMapper().toMap(this.date.month());
+        if (index_1._.isEqual(language, index_1.LanguagePoint.portuguese)) {
+            month = new month_to_portuguese_mapper_1.MonthNameToPortugueseMapper().toMap(this.date.month());
+        }
+        return month;
     }
     /**
-     * Retorna o número do dia no mês.
-     * @returns Número do dia (1-31)
+     * 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
      */
@@ -262,8 +251,8 @@ class DatetimeEdge {
         return this.date.date();
     }
     /**
-     * Retorna o número do mês (base 0).
-     * @returns Número do mês (0=janeiro, 11=dezembro)
+     * 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
      */
@@ -271,8 +260,8 @@ class DatetimeEdge {
         return this.date.month();
     }
     /**
-     * Retorna o ano da data.
-     * @returns Número do ano
+     * Returns the year of the date.
+     * @returns The year number.
      * @example
      * new DatetimeEdge(new Date("2026-03-12")).getYear() // 2026
      */
@@ -280,8 +269,8 @@ class DatetimeEdge {
         return this.date.year();
     }
     /**
-     * Retorna as horas da data.
-     * @returns Número da hora (0-23)
+     * Returns the hours of the date.
+     * @returns The hour number (0-23)
      * @example
      * new DatetimeEdge(new Date("2026-03-12T14:30:00")).getHours() // 14
      */
@@ -289,8 +278,8 @@ class DatetimeEdge {
         return this.date.hours();
     }
     /**
-     * Retorna os minutos da data.
-     * @returns Número dos minutos (0-59)
+     * Returns the minutes of the date.
+     * @returns The minute number (0-59)
      * @example
      * new DatetimeEdge(new Date("2026-03-12T14:30:00")).getMinutes() // 30
      */
@@ -298,8 +287,8 @@ class DatetimeEdge {
         return this.date.minutes();
     }
     /**
-     * Retorna os segundos da data.
-     * @returns Número dos segundos (0-59)
+     * Returns the seconds of the date.
+     * @returns The second number (0-59)
      * @example
      * new DatetimeEdge(new Date("2026-03-12T14:30:45")).getSeconds() // 45
      */
@@ -308,9 +297,9 @@ class DatetimeEdge {
     }
     // ==================== Operações Aritméticas ====================
     /**
-     * Adiciona dias à data e retorna uma nova instância.
-     * @param days - Número de dias a adicionar
-     * @returns Nova instância com a data atualizada
+     * 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")
      */
@@ -318,9 +307,9 @@ class DatetimeEdge {
         return new DatetimeEdge(this.date.clone().add(days, "days").toDate());
     }
     /**
-     * Subtrai dias da data e retorna uma nova instância.
-     * @param days - Número de dias a subtrair
-     * @returns Nova instância com a data atualizada
+     * 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")
      */
@@ -328,9 +317,9 @@ class DatetimeEdge {
         return new DatetimeEdge(this.date.clone().subtract(days, "days").toDate());
     }
     /**
-     * Adiciona meses à data e retorna uma nova instância.
-     * @param months - Número de meses a adicionar
-     * @returns Nova instância com a data atualizada
+     * 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")
      */
@@ -338,9 +327,9 @@ class DatetimeEdge {
         return new DatetimeEdge(this.date.clone().add(months, "months").toDate());
     }
     /**
-     * Subtrai meses da data e retorna uma nova instância.
-     * @param months - Número de meses a subtrair
-     * @returns Nova instância com a data atualizada
+     * 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")
      */
@@ -348,9 +337,9 @@ class DatetimeEdge {
         return new DatetimeEdge(this.date.clone().subtract(months, "months").toDate());
     }
     /**
-     * Adiciona anos à data e retorna uma nova instância.
-     * @param years - Número de anos a adicionar
-     * @returns Nova instância com a data atualizada
+     * 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")
      */
@@ -358,9 +347,9 @@ class DatetimeEdge {
         return new DatetimeEdge(this.date.clone().add(years, "years").toDate());
     }
     /**
-     * Subtrai anos da data e retorna uma nova instância.
-     * @param years - Número de anos a subtrair
-     * @returns Nova instância com a data atualizada
+     * 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")
      */
@@ -368,9 +357,9 @@ class DatetimeEdge {
         return new DatetimeEdge(this.date.clone().subtract(years, "years").toDate());
     }
     /**
-     * Adiciona horas à data e retorna uma nova instância.
-     * @param hours - Número de horas a adicionar
-     * @returns Nova instância com a data atualizada
+     * 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")
      */
@@ -378,9 +367,9 @@ class DatetimeEdge {
         return new DatetimeEdge(this.date.clone().add(hours, "hours").toDate());
     }
     /**
-     * Adiciona minutos à data e retorna uma nova instância.
-     * @param minutes - Número de minutos a adicionar
-     * @returns Nova instância com a data atualizada
+     * 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")
      */
@@ -388,60 +377,60 @@ class DatetimeEdge {
         return new DatetimeEdge(this.date.clone().add(minutes, "minutes").toDate());
     }
     /**
-     * Calcula a diferença em dias entre esta data e outra.
-     * @param other - Data para calcular a diferença
-     * @returns Número de dias de diferença (positivo se this > other)
+     * 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(other) {
-        return this.date.diff(other.toDate(), "days");
+    diffInDays(datetime) {
+        return this.date.diff(datetime.toDate(), "days");
     }
     /**
-     * Calcula a diferença em meses entre esta data e outra.
-     * @param other - Data para calcular a diferença
-     * @returns Número de meses de diferença (positivo se this > other)
+     * 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(other) {
-        return this.date.diff(other.toDate(), "months");
+    diffInMonths(datetime) {
+        return this.date.diff(datetime.toDate(), "months");
     }
     /**
-     * Calcula a diferença em anos entre esta data e outra.
-     * @param other - Data para calcular a diferença
-     * @returns Número de anos de diferença (positivo se this > other)
+     * 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(other) {
-        return this.date.diff(other.toDate(), "years");
+    diffInYears(datetime) {
+        return this.date.diff(datetime.toDate(), "years");
     }
     /**
      * Calcula a diferença em horas entre esta data e outra.
-     * @param other - Data para calcular a diferença
-     * @returns Número de horas de diferença (positivo se this > other)
+     * @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(other) {
-        return this.date.diff(other.toDate(), "hours");
+    diffInHours(datetime) {
+        return this.date.diff(datetime.toDate(), "hours");
     }
     /**
-     * Calcula a diferença em minutos entre esta data e outra.
-     * @param other - Data para calcular a diferença
-     * @returns Número de minutos de diferença (positivo se this > other)
+     * 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(other) {
-        return this.date.diff(other.toDate(), "minutes");
+    diffInMinutes(datetime) {
+        return this.date.diff(datetime.toDate(), "minutes");
     }
     /**
-     * Retorna a diferença legível entre esta data e o momento atual.
-     * @returns String descritiva como "Há 3 dias.", "Há 2 horas.", etc.
+     * 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() // "Há 1 ano."
+     * new DatetimeEdge(new Date("2025-03-12")).diffFromNow() // "1 year ago."
      */
     diffFromNow() {
         const now = (0, moment_1.default)();
@@ -470,8 +459,8 @@ class DatetimeEdge {
     }
     // ==================== Início e Fim de Período ====================
     /**
-     * Retorna o início do dia (00:00:00.000) como nova instância.
-     * @returns Nova instância com o horário zerado para o início do dia
+     * 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")
@@ -480,8 +469,8 @@ class DatetimeEdge {
         return new DatetimeEdge(this.date.clone().startOf("day").toDate());
     }
     /**
-     * Retorna o fim do dia (23:59:59.999) como nova instância.
-     * @returns Nova instância com o horário ajustado para o fim do dia
+     * 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")
@@ -490,8 +479,8 @@ class DatetimeEdge {
         return new DatetimeEdge(this.date.clone().endOf("day").toDate());
     }
     /**
-     * Retorna o início do mês como nova instância.
-     * @returns Nova instância apontando para o primeiro dia do mês à meia-noite
+     * 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")
@@ -500,8 +489,8 @@ class DatetimeEdge {
         return new DatetimeEdge(this.date.clone().startOf("month").toDate());
     }
     /**
-     * Retorna o fim do mês como nova instância.
-     * @returns Nova instância apontando para o último dia do mês ao fim do dia
+     * 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")
@@ -510,8 +499,8 @@ class DatetimeEdge {
         return new DatetimeEdge(this.date.clone().endOf("month").toDate());
     }
     /**
-     * Retorna o início do ano como nova instância.
-     * @returns Nova instância apontando para o primeiro dia do ano à meia-noite
+     * 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")
@@ -520,8 +509,8 @@ class DatetimeEdge {
         return new DatetimeEdge(this.date.clone().startOf("year").toDate());
     }
     /**
-     * Retorna o fim do ano como nova instância.
-     * @returns Nova instância apontando para o último dia do ano ao fim do dia
+     * 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")
@@ -531,19 +520,19 @@ class DatetimeEdge {
     }
     // ==================== Clonagem e Imutabilidade ====================
     /**
-     * Cria uma cópia independente desta instância de DatetimeEdge.
-     * @returns Nova instância com o mesmo valor de data
+     * 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(); // instância independente
+     * const dt2 = dt1.clone(); // independent instance
      */
     clone() {
         return new DatetimeEdge(this.date.toDate());
     }
     /**
-     * Retorna uma nova instância com a data alterada, mantendo o horário.
-     * @param date - Novo objeto Date
-     * @returns Nova instância com o valor fornecido
+     * 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")
@@ -553,8 +542,8 @@ class DatetimeEdge {
     }
     // ==================== Formatação ====================
     /**
-     * Retorna a data no formato ISO 8601.
-     * @returns String no formato "YYYY-MM-DDTHH:mm:ss.sssZ"
+     * 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"
      */
@@ -562,8 +551,8 @@ class DatetimeEdge {
         return this.date.toISOString();
     }
     /**
-     * Retorna a data como objeto Date nativo.
-     * @returns Objeto Date representando esta data
+     * 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
      */
@@ -571,8 +560,8 @@ class DatetimeEdge {
         return this.date.toDate();
     }
     /**
-     * Retorna a data no formato YYYY-MM-DD.
-     * @returns String no formato "YYYY-MM-DD"
+     * 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"
      */
@@ -580,7 +569,7 @@ class DatetimeEdge {
         return this.date.format("YYYY-MM-DD");
     }
     /**
-     * Retorna a data no formato DD/MM/YYYY (padrão brasileiro).
+     * 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"
@@ -589,8 +578,8 @@ class DatetimeEdge {
         return this.date.format("DD/MM/YYYY");
     }
     /**
-     * Retorna a data e hora no formato DD/MM/YYYY HH:mm.
-     * @returns String no formato "DD/MM/YYYY HH:mm"
+     * 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"
      */
@@ -598,9 +587,9 @@ class DatetimeEdge {
         return this.date.format("DD/MM/YYYY HH:mm");
     }
     /**
-     * Retorna a data formatada com um padrão customizado do moment.js.
-     * @param format - Padrão de formatação (ex: "YYYY-MM-DD HH:mm:ss")
-     * @returns String formatada conforme o padrão fornecido
+     * 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"
      */
@@ -608,8 +597,8 @@ class DatetimeEdge {
         return this.date.format(format);
     }
     /**
-     * Retorna o timestamp em milissegundos da data.
-     * @returns Número de milissegundos desde 01/01/1970 UTC
+     * 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
      */
@@ -617,8 +606,8 @@ class DatetimeEdge {
         return this.date.valueOf();
     }
     /**
-     * Retorna o timestamp Unix em segundos da data.
-     * @returns Número de segundos desde 01/01/1970 UTC
+     * 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
      */
@@ -627,19 +616,19 @@ class DatetimeEdge {
     }
     // ==================== Métodos Estáticos ====================
     /**
-     * Cria um DatetimeEdge representando o momento atual.
-     * @returns Nova instância com a data e hora atuais
+     * Creates a new DatetimeEdge representing the current moment.
+     * @returns New instance with the current date and time
      * @example
-     * DatetimeEdge.now() // DatetimeEdge com a data e hora do momento da chamada
+     * DatetimeEdge.now() // DatetimeEdge with the current date and time
      */
     static now() {
         return new DatetimeEdge(new Date());
     }
     /**
-     * Retorna a maior (mais recente) data de uma lista.
-     * @param dates - Array de instâncias de DatetimeEdge para comparação
-     * @returns A instância com a data mais recente
-     * @throws {Error} Se o array estiver vazio
+     * 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")),
@@ -653,10 +642,10 @@ class DatetimeEdge {
         return dates.reduce((max, date) => (date.isAfter(max) ? date : max));
     }
     /**
-     * Retorna a menor (mais antiga) data de uma lista.
-     * @param dates - Array de instâncias de DatetimeEdge para comparação
-     * @returns A instância com a data mais antiga
-     * @throws {Error} Se o array estiver vazio
+     * 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")),
@@ -671,8 +660,8 @@ class DatetimeEdge {
     }
     // ==================== Privados ====================
     /**
-     * Valida se a data fornecida no construtor é uma data válida.
-     * @throws {Error} Se a data for inválida
+     * 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()) {