@odoo/o-spreadsheet 17.0.6 → 17.0.7

package/dist/o-spreadsheet.iife.js

@@ -2,9 +2,9 @@
 /**
  * This file is generated by o-spreadsheet build tools. Do not edit it.
  * @see https://github.com/odoo/o-spreadsheet
- * @version 17.0.6
- * @date 2024-01-04T12:23:10.357Z
- * @hash 310ca57
+ * @version 17.0.7
+ * @date 2024-01-12T13:42:04.654Z
+ * @hash cadb817
  */
 
 (function (exports, owl) {
@@ -1202,16 +1202,84 @@
   // -----------------------------------------------------------------------------
   // Date Type
   // -----------------------------------------------------------------------------
+  /**
+   * A DateTime object that can be used to manipulate spreadsheet dates.
+   * Conceptually, a spreadsheet date is simply a number with a date format,
+   * and it is timezone-agnostic.
+   * This DateTime object consistently uses UTC time to represent a naive date and time.
+   */
+  class DateTime {
+      jsDate;
+      constructor(year, month, day, hours = 0, minutes = 0, seconds = 0) {
+          this.jsDate = new Date(Date.UTC(year, month, day, hours, minutes, seconds, 0));
+      }
+      static fromTimestamp(timestamp) {
+          const date = new Date(timestamp);
+          return new DateTime(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate(), date.getUTCHours(), date.getUTCMinutes(), date.getUTCSeconds());
+      }
+      static now() {
+          const now = new Date();
+          return new DateTime(now.getFullYear(), now.getMonth(), now.getDate(), now.getHours(), now.getMinutes(), now.getSeconds());
+      }
+      toString() {
+          return this.jsDate.toString();
+      }
+      toLocaleDateString() {
+          return this.jsDate.toLocaleDateString();
+      }
+      getTime() {
+          return this.jsDate.getTime();
+      }
+      getFullYear() {
+          return this.jsDate.getUTCFullYear();
+      }
+      getMonth() {
+          return this.jsDate.getUTCMonth();
+      }
+      getDate() {
+          return this.jsDate.getUTCDate();
+      }
+      getDay() {
+          return this.jsDate.getUTCDay();
+      }
+      getHours() {
+          return this.jsDate.getUTCHours();
+      }
+      getMinutes() {
+          return this.jsDate.getUTCMinutes();
+      }
+      getSeconds() {
+          return this.jsDate.getUTCSeconds();
+      }
+      setFullYear(year) {
+          return this.jsDate.setUTCFullYear(year);
+      }
+      setMonth(month) {
+          return this.jsDate.setUTCMonth(month);
+      }
+      setDate(date) {
+          return this.jsDate.setUTCDate(date);
+      }
+      setHours(hours) {
+          return this.jsDate.setUTCHours(hours);
+      }
+      setMinutes(minutes) {
+          return this.jsDate.setUTCMinutes(minutes);
+      }
+      setSeconds(seconds) {
+          return this.jsDate.setUTCSeconds(seconds);
+      }
+  }
   // -----------------------------------------------------------------------------
   // Parsing
   // -----------------------------------------------------------------------------
-  const INITIAL_1900_DAY = new Date(1899, 11, 30);
+  const INITIAL_1900_DAY = new DateTime(1899, 11, 30);
   const MS_PER_DAY = 24 * 60 * 60 * 1000;
   const CURRENT_MILLENIAL = 2000; // note: don't forget to update this in 2999
-  const CURRENT_YEAR = new Date().getFullYear();
-  const CURRENT_MONTH = new Date().getMonth();
-  const INITIAL_JS_DAY = new Date(0);
-  const DATE_JS_1900_OFFSET = INITIAL_JS_DAY - INITIAL_1900_DAY;
+  const CURRENT_YEAR = DateTime.now().getFullYear();
+  const CURRENT_MONTH = DateTime.now().getMonth();
+  const INITIAL_JS_DAY = DateTime.fromTimestamp(0);
+  const DATE_JS_1900_OFFSET = INITIAL_JS_DAY.getTime() - INITIAL_1900_DAY.getTime();
   const mdyDateRegexp = /^\d{1,2}(\/|-|\s)\d{1,2}((\/|-|\s)\d{1,4})?$/;
   const ymdDateRegexp = /^\d{3,4}(\/|-|\s)\d{1,2}(\/|-|\s)\d{1,2}$/;
   const dateSeparatorsRegex = /\/|-|\s/;
@@ -1272,7 +1340,7 @@
           return {
               value: date.value + time.value,
               format: date.format + " " + (time.format === "hhhh:mm:ss" ? "hh:mm:ss" : time.format),
-              jsDate: new Date(date.jsDate.getFullYear() + time.jsDate.getFullYear() - 1899, date.jsDate.getMonth() + time.jsDate.getMonth() - 11, date.jsDate.getDate() + time.jsDate.getDate() - 30, date.jsDate.getHours() + time.jsDate.getHours(), date.jsDate.getMinutes() + time.jsDate.getMinutes(), date.jsDate.getSeconds() + time.jsDate.getSeconds()),
+              jsDate: new DateTime(date.jsDate.getFullYear() + time.jsDate.getFullYear() - 1899, date.jsDate.getMonth() + time.jsDate.getMonth() - 11, date.jsDate.getDate() + time.jsDate.getDate() - 30, date.jsDate.getHours() + time.jsDate.getHours(), date.jsDate.getMinutes() + time.jsDate.getMinutes(), date.jsDate.getSeconds() + time.jsDate.getSeconds()),
           };
       }
       return date || time;
@@ -1348,12 +1416,12 @@
       // month + 1: months are 0-indexed in JS
       const leadingZero = (monthStr?.length === 2 && month + 1 < 10) || (dayStr?.length === 2 && day < 10);
       const fullYear = yearStr?.length !== 2;
-      const jsDate = new Date(year, month, day);
+      const jsDate = new DateTime(year, month, day);
       if (jsDate.getMonth() !== month || jsDate.getDate() !== day) {
           // invalid date
           return null;
       }
-      const delta = jsDate - INITIAL_1900_DAY;
+      const delta = jsDate.getTime() - INITIAL_1900_DAY.getTime();
       const format = getFormatFromDateParts(parts, separator, leadingZero, fullYear);
       return {
           value: Math.round(delta / MS_PER_DAY),
@@ -1444,7 +1512,7 @@
           if (hours >= 24) {
               format = "hhhh:mm:ss";
           }
-          const jsDate = new Date(1899, 11, 30, hours, minutes, seconds);
+          const jsDate = new DateTime(1899, 11, 30, hours, minutes, seconds);
           return {
               value: hours / 24 + minutes / 1440 + seconds / 86400,
               format: format,
@@ -1458,7 +1526,7 @@
   // -----------------------------------------------------------------------------
   function numberToJsDate(value) {
       const truncValue = Math.trunc(value);
-      let date = new Date(truncValue * MS_PER_DAY - DATE_JS_1900_OFFSET);
+      let date = DateTime.fromTimestamp(truncValue * MS_PER_DAY - DATE_JS_1900_OFFSET);
       let time = value - truncValue;
       time = time < 0 ? 1 + time : time;
       const hours = Math.round(time * 24);
@@ -1478,7 +1546,7 @@
   }
   /** Return the number of days in the current month of the given date */
   function getDaysInMonth(date) {
-      return new Date(date.getFullYear(), date.getMonth() + 1, 0).getDate();
+      return new DateTime(date.getFullYear(), date.getMonth() + 1, 0).getDate();
   }
   function isLastDayOfMonth(date) {
       return getDaysInMonth(date) === date.getDate();
@@ -1496,7 +1564,7 @@
       const yStart = date.getFullYear();
       const mStart = date.getMonth();
       const dStart = date.getDate();
-      const jsDate = new Date(yStart, mStart + months);
+      const jsDate = new DateTime(yStart, mStart + months, 1);
       if (keepEndOfMonth && dStart === getDaysInMonth(date)) {
           jsDate.setDate(getDaysInMonth(jsDate));
       }
@@ -2719,20 +2787,20 @@
   }
 
   function toCriterionDateNumber(dateValue) {
-      const today = new Date();
+      const today = DateTime.now();
       switch (dateValue) {
           case "today":
               return jsDateToNumber(today);
           case "yesterday":
-              return jsDateToNumber(new Date(today.setDate(today.getDate() - 1)));
+              return jsDateToNumber(DateTime.fromTimestamp(today.setDate(today.getDate() - 1)));
           case "tomorrow":
-              return jsDateToNumber(new Date(today.setDate(today.getDate() + 1)));
+              return jsDateToNumber(DateTime.fromTimestamp(today.setDate(today.getDate() + 1)));
           case "lastWeek":
-              return jsDateToNumber(new Date(today.setDate(today.getDate() - 7)));
+              return jsDateToNumber(DateTime.fromTimestamp(today.setDate(today.getDate() - 7)));
           case "lastMonth":
-              return jsDateToNumber(new Date(today.setMonth(today.getMonth() - 1)));
+              return jsDateToNumber(DateTime.fromTimestamp(today.setMonth(today.getMonth() - 1)));
           case "lastYear":
-              return jsDateToNumber(new Date(today.setFullYear(today.getFullYear() - 1)));
+              return jsDateToNumber(DateTime.fromTimestamp(today.setFullYear(today.getFullYear() - 1)));
       }
   }
   /** Get all the dates values of a criterion converted to numbers, converting date values such as "today" to actual dates  */
@@ -3090,7 +3158,7 @@
           .map((p) => {
           switch (p) {
               case "hhhh":
-                  const helapsedHours = Math.floor((jsDate.getTime() - INITIAL_1900_DAY) / (60 * 60 * 1000));
+                  const helapsedHours = Math.floor((jsDate.getTime() - INITIAL_1900_DAY.getTime()) / (60 * 60 * 1000));
                   return helapsedHours.toString();
               case "hh":
                   return hours.toString().padStart(2, "0");
@@ -10910,6 +10978,9 @@
   function makeArg(str, description) {
       let parts = str.match(ARG_REGEXP);
       let name = parts[1].trim();
+      if (!name) {
+          throw new Error(`Function argument definition is missing a name: '${str}'.`);
+      }
       let types = [];
       let isOptional = false;
       let isRepeating = false;
@@ -14615,7 +14686,7 @@
           if (_year < 1900) {
               _year += 1900;
           }
-          const jsDate = new Date(_year, _month - 1, _day);
+          const jsDate = new DateTime(_year, _month - 1, _day);
           const result = jsDateToRoundNumber(jsDate);
           assert(() => result >= 0, _t("The function [[FUNCTION_NAME]] result must be greater than or equal 01/01/1900."));
           return result;
@@ -14658,7 +14729,7 @@
                   // See: https://support.microsoft.com/en-us/office/datedif-function-25dba1a4-2812-480b-84dd-8b32a451b35c
                   let days = jsEndDate.getDate() - jsStartDate.getDate();
                   if (days < 0) {
-                      const monthBeforeEndMonth = new Date(jsEndDate.getFullYear(), jsEndDate.getMonth() - 1, 1);
+                      const monthBeforeEndMonth = new DateTime(jsEndDate.getFullYear(), jsEndDate.getMonth() - 1, 1);
                       const daysInMonthBeforeEndMonth = getDaysInMonth(monthBeforeEndMonth);
                       days = daysInMonthBeforeEndMonth - Math.abs(days);
                   }
@@ -14667,7 +14738,7 @@
                   if (areTwoDatesWithinOneYear(_startDate, _endDate)) {
                       return getTimeDifferenceInWholeDays(jsStartDate, jsEndDate);
                   }
-                  const endDateWithinOneYear = new Date(jsStartDate.getFullYear(), jsEndDate.getMonth(), jsEndDate.getDate());
+                  const endDateWithinOneYear = new DateTime(jsStartDate.getFullYear(), jsEndDate.getMonth(), jsEndDate.getDate());
                   let days = getTimeDifferenceInWholeDays(jsStartDate, endDateWithinOneYear);
                   if (days < 0) {
                       endDateWithinOneYear.setFullYear(jsStartDate.getFullYear() + 1);
@@ -14784,7 +14855,7 @@
           const _months = Math.trunc(toNumber(months, this.locale));
           const yStart = _startDate.getFullYear();
           const mStart = _startDate.getMonth();
-          const jsDate = new Date(yStart, mStart + _months + 1, 0);
+          const jsDate = new DateTime(yStart, mStart + _months + 1, 0);
           return jsDateToRoundNumber(jsDate);
       },
       isExported: true,
@@ -14821,17 +14892,17 @@
           // The first week of the year is the week that contains the first
           // Thursday of the year.
           let firstThursday = 1;
-          while (new Date(y, 0, firstThursday).getDay() !== 4) {
+          while (new DateTime(y, 0, firstThursday).getDay() !== 4) {
               firstThursday += 1;
           }
-          const firstDayOfFirstWeek = new Date(y, 0, firstThursday - 3);
+          const firstDayOfFirstWeek = new DateTime(y, 0, firstThursday - 3);
           // The last week of the year is the week that contains the last Thursday of
           // the year.
           let lastThursday = 31;
-          while (new Date(y, 11, lastThursday).getDay() !== 4) {
+          while (new DateTime(y, 11, lastThursday).getDay() !== 4) {
               lastThursday -= 1;
           }
-          const lastDayOfLastWeek = new Date(y, 11, lastThursday + 3);
+          const lastDayOfLastWeek = new DateTime(y, 11, lastThursday + 3);
           // B - If our date > lastDayOfLastWeek then it's in the weeks of the year after
           // If our date < firstDayOfFirstWeek then it's in the weeks of the year before
           let offsetYear;
@@ -14857,17 +14928,17 @@
               case 1:
                   // firstDay is the 1st day of the 1st week of the year after
                   // firstDay = lastDayOfLastWeek + 1 Day
-                  firstDay = new Date(y, 11, lastThursday + 3 + 1);
+                  firstDay = new DateTime(y, 11, lastThursday + 3 + 1);
                   break;
               case -1:
                   // firstDay is the 1st day of the 1st week of the previous year.
                   // The first week of the previous year is the week that contains the
                   // first Thursday of the previous year.
                   let firstThursdayPreviousYear = 1;
-                  while (new Date(y - 1, 0, firstThursdayPreviousYear).getDay() !== 4) {
+                  while (new DateTime(y - 1, 0, firstThursdayPreviousYear).getDay() !== 4) {
                       firstThursdayPreviousYear += 1;
                   }
-                  firstDay = new Date(y - 1, 0, firstThursdayPreviousYear - 3);
+                  firstDay = new DateTime(y - 1, 0, firstThursdayPreviousYear - 3);
                   break;
           }
           const diff = (_date.getTime() - firstDay.getTime()) / MS_PER_DAY;
@@ -15002,8 +15073,8 @@
               });
           }
           const invertDate = _startDate.getTime() > _endDate.getTime();
-          const stopDate = new Date((invertDate ? _startDate : _endDate).getTime());
-          let stepDate = new Date((invertDate ? _endDate : _startDate).getTime());
+          const stopDate = DateTime.fromTimestamp((invertDate ? _startDate : _endDate).getTime());
+          let stepDate = DateTime.fromTimestamp((invertDate ? _endDate : _startDate).getTime());
           const timeStopDate = stopDate.getTime();
           let timeStepDate = stepDate.getTime();
           let netWorkingDay = 0;
@@ -15029,8 +15100,7 @@
           return getDateTimeFormat(this.locale);
       },
       compute: function () {
-          let today = new Date();
-          today.setMilliseconds(0);
+          let today = DateTime.now();
           const delta = today.getTime() - INITIAL_1900_DAY.getTime();
           const time = today.getHours() / 24 + today.getMinutes() / 1440 + today.getSeconds() / 86400;
           return Math.floor(delta / MS_PER_DAY) + time;
@@ -15104,8 +15174,8 @@
           return this.locale.dateFormat;
       },
       compute: function () {
-          const today = new Date();
-          const jsDate = new Date(today.getFullYear(), today.getMonth(), today.getDate());
+          const today = DateTime.now();
+          const jsDate = new DateTime(today.getFullYear(), today.getMonth(), today.getDate());
           return jsDateToRoundNumber(jsDate);
       },
       isExported: true,
@@ -15160,10 +15230,10 @@
           }
           const y = _date.getFullYear();
           let dayStart = 1;
-          let startDayOfFirstWeek = new Date(y, 0, dayStart);
+          let startDayOfFirstWeek = new DateTime(y, 0, dayStart);
           while (startDayOfFirstWeek.getDay() !== startDayOfWeek) {
               dayStart += 1;
-              startDayOfFirstWeek = new Date(y, 0, dayStart);
+              startDayOfFirstWeek = new DateTime(y, 0, dayStart);
           }
           const dif = (_date.getTime() - startDayOfFirstWeek.getTime()) / MS_PER_DAY;
           if (dif < 0) {
@@ -15221,7 +15291,7 @@
                   timesHoliday.add(holiday.getTime());
               });
           }
-          let stepDate = new Date(_startDate.getTime());
+          let stepDate = DateTime.fromTimestamp(_startDate.getTime());
           let timeStepDate = stepDate.getTime();
           const unitDay = Math.sign(_numDays);
           let stepDay = Math.abs(_numDays);
@@ -15285,7 +15355,7 @@
           const _startDate = toJsDate(date, this.locale);
           const yStart = _startDate.getFullYear();
           const mStart = _startDate.getMonth();
-          const jsDate = new Date(yStart, mStart, 1);
+          const jsDate = new DateTime(yStart, mStart, 1);
           return jsDateToRoundNumber(jsDate);
       },
   };
@@ -15327,7 +15397,7 @@
       compute: function (date) {
           const quarter = QUARTER.compute.bind(this)(date);
           const year = YEAR.compute.bind(this)(date);
-          const jsDate = new Date(year, (quarter - 1) * 3, 1);
+          const jsDate = new DateTime(year, (quarter - 1) * 3, 1);
           return jsDateToRoundNumber(jsDate);
       },
   };
@@ -15344,7 +15414,7 @@
       compute: function (date) {
           const quarter = QUARTER.compute.bind(this)(date);
           const year = YEAR.compute.bind(this)(date);
-          const jsDate = new Date(year, quarter * 3, 0);
+          const jsDate = new DateTime(year, quarter * 3, 0);
           return jsDateToRoundNumber(jsDate);
       },
   };
@@ -15360,7 +15430,7 @@
       },
       compute: function (date) {
           const year = YEAR.compute.bind(this)(date);
-          const jsDate = new Date(year, 0, 1);
+          const jsDate = new DateTime(year, 0, 1);
           return jsDateToRoundNumber(jsDate);
       },
   };
@@ -15376,7 +15446,7 @@
       },
       compute: function (date) {
           const year = YEAR.compute.bind(this)(date);
-          const jsDate = new Date(year + 1, 0, 0);
+          const jsDate = new DateTime(year + 1, 0, 0);
           return jsDateToRoundNumber(jsDate);
       },
   };
@@ -15424,8 +15494,8 @@
   const DELTA = {
       description: _t("Compare two numeric values, returning 1 if they're equal."),
       args: [
-          arg(" (number)", _t("The first number to compare.")),
-          arg(` (number, default=${DEFAULT_DELTA_ARG})`, _t("The second number to compare.")),
+          arg("number1 (number)", _t("The first number to compare.")),
+          arg(`number2 (number, default=${DEFAULT_DELTA_ARG})`, _t("The second number to compare.")),
       ],
       returns: ["NUMBER"],
       compute: function (number1, number2 = DEFAULT_DELTA_ARG) {
@@ -15852,7 +15922,7 @@
   function assertSettlementLessThanOneYearBeforeMaturity(settlement, maturity, locale) {
       const startDate = toJsDate(settlement, locale);
       const endDate = toJsDate(maturity, locale);
-      const startDatePlusOneYear = new Date(startDate);
+      const startDatePlusOneYear = toJsDate(settlement, locale);
       startDatePlusOneYear.setFullYear(startDate.getFullYear() + 1);
       assert(() => endDate.getTime() <= startDatePlusOneYear.getTime(), _t("The settlement date (%s) must at most one year after the maturity date (%s).", settlement.toString(), maturity.toString()));
   }
@@ -15987,7 +16057,7 @@
           arg("salvage (number)", _t("The value of the asset at the end of depreciation.")),
           arg("period (number)", _t("The single period within life for which to calculate depreciation.")),
           arg("rate (number)", _t("The deprecation rate.")),
-          arg(" (number, optional)", _t("An indicator of what day count method to use.")),
+          arg("day_count_convention (number, optional)", _t("An indicator of what day count method to use.")),
       ],
       returns: ["NUMBER"],
       compute: function (cost, purchaseDate, firstPeriodEnd, salvage, period, rate, dayCountConvention = DEFAULT_DAY_COUNT_CONVENTION) {
@@ -19011,8 +19081,8 @@
       description: _t("A segment of a string."),
       args: [
           arg("text (string)", _t("The string to extract a segment from.")),
-          arg(" (number)", _t("The index from the left of string from which to begin extracting. The first character in string has the index 1.")),
-          arg(" (number)", _t("The length of the segment to extract.")),
+          arg("starting_at (number)", _t("The index from the left of string from which to begin extracting. The first character in string has the index 1.")),
+          arg("extract_length (number)", _t("The length of the segment to extract.")),
       ],
       returns: ["STRING"],
       compute: function (text, starting_at, extract_length) {
@@ -24206,7 +24276,7 @@
               return false;
           }
           if (["lastWeek", "lastMonth", "lastYear"].includes(criterion.dateValue)) {
-              const today = jsDateToRoundNumber(new Date());
+              const today = jsDateToRoundNumber(DateTime.now());
               return isDateBetween(dateValue, today, criterionValue);
           }
           return areDatesSameDay(dateValue, criterionValue);
@@ -56698,9 +56768,9 @@
   exports.tokenize = tokenize;
 
 
-  __info__.version = "17.0.6";
-  __info__.date = "2024-01-04T12:23:10.357Z";
-  __info__.hash = "310ca57";
+  __info__.version = "17.0.7";
+  __info__.date = "2024-01-12T13:42:04.654Z";
+  __info__.hash = "cadb817";
 
 
 })(this.o_spreadsheet = this.o_spreadsheet || {}, owl);