@ui5/webcomponents-localization 1.22.0-rc.1 → 1.22.0-rc.3

package/dist/sap/ui/core/date/Buddhist.js

@@ -1,121 +1,196 @@
-import UniversalDate from './UniversalDate.js';
-import CalendarType from '../CalendarType.js';
-import _Calendars from './_Calendars.js';
-var Buddhist = UniversalDate.extend('sap.ui.core.date.Buddhist', {
-    constructor: function () {
-        var aArgs = arguments;
-        if (aArgs.length > 1) {
-            aArgs = toGregorianArguments(aArgs);
-        }
-        this.oDate = this.createDate(Date, aArgs);
-        this.sCalendarType = CalendarType.Buddhist;
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+// Provides class sap.ui.core.date.Buddhist
+import UniversalDate from "./UniversalDate.js";
+import CalendarType from "../CalendarType.js";
+import _Calendars from "./_Calendars.js";
+/**
+ * The Buddhist date class
+ *
+ * @class
+ * The Buddhist date implements the Thai solar calendar (BE - Buddhist Era). In this calendar
+ * the year is offset by 543 compared to the Gregorian calendar.
+ * e.g. Year 2022 CE corresponds to 2565 BE
+ *
+ *
+ * Before 1941 CE the year start was 1st of April, so Januar to March belong to the previous year.
+ * <pre>
+ * Month | 1-3 | 4-6 | 7-9 | 10-12 | 1-3 | 4-6 | 7-9 | 10-12 | 1-3 | 4-6 | 7-9 | 10-12 | 1-3 | 4-6 | 7-9 | 10-12 |
+ * CE    |       1939              |           1940          |         1941            |          1942           |
+ * BE     2481 |        2482             |      2483         |         2484            |          2485           |
+ * </pre>
+ *
+ * @private
+ * @alias sap.ui.core.date.Buddhist
+ * @extends sap.ui.core.date.UniversalDate
+ */
+var Buddhist = UniversalDate.extend("sap.ui.core.date.Buddhist", /** @lends sap.ui.core.date.Buddhist.prototype */{
+  constructor: function () {
+    var aArgs = arguments;
+    if (aArgs.length > 1) {
+      aArgs = toGregorianArguments(aArgs);
     }
+    this.oDate = this.createDate(Date, aArgs);
+    this.sCalendarType = CalendarType.Buddhist;
+  }
 });
 Buddhist.UTC = function () {
-    var aArgs = toGregorianArguments(arguments);
-    return Date.UTC.apply(Date, aArgs);
+  var aArgs = toGregorianArguments(arguments);
+  return Date.UTC.apply(Date, aArgs);
 };
 Buddhist.now = function () {
-    return Date.now();
+  return Date.now();
 };
+
+/**
+ * Find the matching Buddhist date for the given gregorian date
+ *
+ * @param {{year: int, month: int, day: int}} oGregorian Gregorian date
+ * @return {{year: int, month: int, day: int}} the resulting Buddhist date
+ */
 function toBuddhist(oGregorian) {
-    var iEraStartYear = UniversalDate.getEraStartDate(CalendarType.Buddhist, 0).year, iYear = oGregorian.year - iEraStartYear + 1;
-    if (oGregorian.year < 1941 && oGregorian.month < 3) {
-        iYear -= 1;
-    }
-    if (oGregorian.year === null) {
-        iYear = undefined;
-    }
-    return {
-        year: iYear,
-        month: oGregorian.month,
-        day: oGregorian.day
-    };
+  var iEraStartYear = UniversalDate.getEraStartDate(CalendarType.Buddhist, 0).year,
+    iYear = oGregorian.year - iEraStartYear + 1;
+  // Before 1941 new year started on 1st of April
+  if (oGregorian.year < 1941 && oGregorian.month < 3) {
+    iYear -= 1;
+  }
+  if (oGregorian.year === null) {
+    iYear = undefined;
+  }
+  return {
+    year: iYear,
+    month: oGregorian.month,
+    day: oGregorian.day
+  };
 }
+
+/**
+ * Calculate gregorian year from Buddhist year and month
+ *
+ * @param {{year: int, month: int, day: int}} oBuddhist Buddhist date
+ * @return {{year: int, month: int, day: int}} the resulting Gregorian date
+ */
 function toGregorian(oBuddhist) {
-    var iEraStartYear = UniversalDate.getEraStartDate(CalendarType.Buddhist, 0).year, iYear = oBuddhist.year + iEraStartYear - 1;
-    if (iYear < 1941 && oBuddhist.month < 3) {
-        iYear += 1;
-    }
-    if (oBuddhist.year === null) {
-        iYear = undefined;
-    }
-    return {
-        year: iYear,
-        month: oBuddhist.month,
-        day: oBuddhist.day
-    };
+  var iEraStartYear = UniversalDate.getEraStartDate(CalendarType.Buddhist, 0).year,
+    iYear = oBuddhist.year + iEraStartYear - 1;
+  // Before 1941 new year started on 1st of April
+  if (iYear < 1941 && oBuddhist.month < 3) {
+    iYear += 1;
+  }
+  if (oBuddhist.year === null) {
+    iYear = undefined;
+  }
+  return {
+    year: iYear,
+    month: oBuddhist.month,
+    day: oBuddhist.day
+  };
 }
+
+/**
+ * Convert arguments array from Buddhist date to Gregorian data.
+ *
+ * @param {int[]} aArgs Array with year, month, day (optional) according to Buddhist calendar
+ * @returns {int[]} Array with year, month, day according to Gregorian calendar
+ */
 function toGregorianArguments(aArgs) {
-    var oBuddhist, oGregorian;
-    oBuddhist = {
-        year: aArgs[0],
-        month: aArgs[1],
-        day: aArgs[2] !== undefined ? aArgs[2] : 1
-    };
-    oGregorian = toGregorian(oBuddhist);
-    aArgs[0] = oGregorian.year;
-    return aArgs;
+  var oBuddhist, oGregorian;
+  oBuddhist = {
+    year: aArgs[0],
+    month: aArgs[1],
+    day: aArgs[2] !== undefined ? aArgs[2] : 1
+  };
+  oGregorian = toGregorian(oBuddhist);
+  aArgs[0] = oGregorian.year;
+  return aArgs;
 }
+
+/**
+ * Get the Buddhist year from this.oDate
+ *
+ * @return {object}
+ */
 Buddhist.prototype._getBuddhist = function () {
-    var oGregorian = {
-        year: this.oDate.getFullYear(),
-        month: this.oDate.getMonth(),
-        day: this.oDate.getDate()
-    };
-    return toBuddhist(oGregorian);
+  var oGregorian = {
+    year: this.oDate.getFullYear(),
+    month: this.oDate.getMonth(),
+    day: this.oDate.getDate()
+  };
+  return toBuddhist(oGregorian);
 };
+
+/**
+ * Set the Buddhist year to this.oDate
+ */
 Buddhist.prototype._setBuddhist = function (oBuddhist) {
-    var oGregorian = toGregorian(oBuddhist);
-    return this.oDate.setFullYear(oGregorian.year, oGregorian.month, oGregorian.day);
+  var oGregorian = toGregorian(oBuddhist);
+  return this.oDate.setFullYear(oGregorian.year, oGregorian.month, oGregorian.day);
 };
+
+/**
+ * Get the Buddhist year from this.oDate in UTC
+ *
+ * @return {object}
+ */
 Buddhist.prototype._getUTCBuddhist = function () {
-    var oGregorian = {
-        year: this.oDate.getUTCFullYear(),
-        month: this.oDate.getUTCMonth(),
-        day: this.oDate.getUTCDate()
-    };
-    return toBuddhist(oGregorian);
+  var oGregorian = {
+    year: this.oDate.getUTCFullYear(),
+    month: this.oDate.getUTCMonth(),
+    day: this.oDate.getUTCDate()
+  };
+  return toBuddhist(oGregorian);
 };
+
+/**
+ * Set the Buddhist year to this.oDate in UTC
+ */
 Buddhist.prototype._setUTCBuddhist = function (oBuddhist) {
-    var oGregorian = toGregorian(oBuddhist);
-    return this.oDate.setUTCFullYear(oGregorian.year, oGregorian.month, oGregorian.day);
+  var oGregorian = toGregorian(oBuddhist);
+  return this.oDate.setUTCFullYear(oGregorian.year, oGregorian.month, oGregorian.day);
 };
+
+/*
+ * Override relevant getters/setters
+ */
 Buddhist.prototype.getYear = function () {
-    return this._getBuddhist().year;
+  return this._getBuddhist().year;
 };
 Buddhist.prototype.getFullYear = function () {
-    return this._getBuddhist().year;
+  return this._getBuddhist().year;
 };
 Buddhist.prototype.getUTCFullYear = function () {
-    return this._getUTCBuddhist().year;
+  return this._getUTCBuddhist().year;
 };
 Buddhist.prototype.setYear = function (iYear) {
-    var oBuddhist = this._getBuddhist();
-    oBuddhist.year = iYear;
-    return this._setBuddhist(oBuddhist);
+  var oBuddhist = this._getBuddhist();
+  oBuddhist.year = iYear;
+  return this._setBuddhist(oBuddhist);
 };
 Buddhist.prototype.setFullYear = function (iYear, iMonth, iDay) {
-    var oBuddhist = this._getBuddhist();
-    oBuddhist.year = iYear;
-    if (iMonth !== undefined) {
-        oBuddhist.month = iMonth;
-    }
-    if (iDay !== undefined) {
-        oBuddhist.day = iDay;
-    }
-    return this._setBuddhist(oBuddhist);
+  var oBuddhist = this._getBuddhist();
+  oBuddhist.year = iYear;
+  if (iMonth !== undefined) {
+    oBuddhist.month = iMonth;
+  }
+  if (iDay !== undefined) {
+    oBuddhist.day = iDay;
+  }
+  return this._setBuddhist(oBuddhist);
 };
 Buddhist.prototype.setUTCFullYear = function (iYear, iMonth, iDay) {
-    var oBuddhist = this._getUTCBuddhist();
-    oBuddhist.year = iYear;
-    if (iMonth !== undefined) {
-        oBuddhist.month = iMonth;
-    }
-    if (iDay !== undefined) {
-        oBuddhist.day = iDay;
-    }
-    return this._setUTCBuddhist(oBuddhist);
+  var oBuddhist = this._getUTCBuddhist();
+  oBuddhist.year = iYear;
+  if (iMonth !== undefined) {
+    oBuddhist.month = iMonth;
+  }
+  if (iDay !== undefined) {
+    oBuddhist.day = iDay;
+  }
+  return this._setUTCBuddhist(oBuddhist);
 };
 _Calendars.set(CalendarType.Buddhist, Buddhist);
 export default Buddhist;

package/dist/sap/ui/core/date/CalendarUtils.js

@@ -1,25 +1,65 @@
-import CalendarWeekNumbering from './CalendarWeekNumbering.js';
-import Configuration from '../Configuration.js';
-import LocaleData from '../LocaleData.js';
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+// Provides type sap.ui.core.date.CalendarUtils.
+import CalendarWeekNumbering from "./CalendarWeekNumbering.js";
+import Configuration from "../Configuration.js";
+import LocaleData from "../LocaleData.js";
+/**
+ * Provides calendar-related utilities.
+ *
+ * @namespace
+ * @alias module:sap/ui/core/date/CalendarUtils
+ * @public
+ * @since 1.108.0
+ */
 var CalendarUtils = {
-    getWeekConfigurationValues: function (sCalendarWeekNumbering, oLocale) {
-        var oLocaleData, oWeekConfigurationValues;
-        if (!sCalendarWeekNumbering) {
-            return CalendarUtils.getWeekConfigurationValues(Configuration.getCalendarWeekNumbering(), oLocale);
-        }
-        oWeekConfigurationValues = CalendarWeekNumbering.getWeekConfigurationValues(sCalendarWeekNumbering);
-        if (oWeekConfigurationValues) {
-            return oWeekConfigurationValues;
-        }
-        if (sCalendarWeekNumbering === CalendarWeekNumbering.Default) {
-            oLocale = oLocale || Configuration.getFormatSettings().getFormatLocale();
-            oLocaleData = LocaleData.getInstance(oLocale);
-            return {
-                firstDayOfWeek: oLocaleData.getFirstDayOfWeek(),
-                minimalDaysInFirstWeek: oLocaleData.getMinimalDaysInFirstWeek()
-            };
-        }
-        return undefined;
+  /**
+   * Resolves calendar week configuration.
+   *
+   * Returns an object with the following fields:
+   * <ul>
+   *   <li><code>firstDayOfWeek</code>: specifies the first day of the week starting with
+   *   <code>0</code> (which is Sunday)</li>
+   *   <li><code>minimalDaysInFirstWeek</code>: minimal days at the beginning of the year
+   *   which define the first calendar week</li>
+   * </ul>
+   *
+   * @param {sap.ui.core.date.CalendarWeekNumbering} [sCalendarWeekNumbering]
+   *   The calendar week numbering; if omitted, the calendar week numbering of the Configuration
+   *   is used; see {@link sap.ui.core.Configuration#getCalendarWeekNumbering}. If this value is
+   *   <code>Default</code> the returned calendar week configuration is derived from the given
+   *   <code>oLocale</code>.
+   * @param {sap.ui.core.Locale} [oLocale]
+   *   The locale to use; if not provided, this falls back to the format locale from the
+   *   Configuration; see {@link sap.ui.core.Configuration.FormatSettings#getFormatLocale}.
+   *   Is only used when <code>sCalendarWeekNumbering</code> is set to <code>Default</code>.
+   * @returns {{firstDayOfWeek: int, minimalDaysInFirstWeek: int}|undefined}
+   *   The calendar week configuration, or <code>undefined<code> for an invalid value of
+   *   <code>sap.ui.core.date.CalendarWeekNumbering</code>.
+   * @public
+   * @since 1.108.0
+   */
+  getWeekConfigurationValues: function (sCalendarWeekNumbering, oLocale) {
+    var oLocaleData, oWeekConfigurationValues;
+    if (!sCalendarWeekNumbering) {
+      return CalendarUtils.getWeekConfigurationValues(Configuration.getCalendarWeekNumbering(), oLocale);
     }
+    oWeekConfigurationValues = CalendarWeekNumbering.getWeekConfigurationValues(sCalendarWeekNumbering);
+    if (oWeekConfigurationValues) {
+      return oWeekConfigurationValues;
+    }
+    if (sCalendarWeekNumbering === CalendarWeekNumbering.Default) {
+      oLocale = oLocale || Configuration.getFormatSettings().getFormatLocale();
+      oLocaleData = LocaleData.getInstance(oLocale);
+      return {
+        firstDayOfWeek: oLocaleData.getFirstDayOfWeek(),
+        minimalDaysInFirstWeek: oLocaleData.getMinimalDaysInFirstWeek()
+      };
+    }
+    return undefined;
+  }
 };
 export default CalendarUtils;

package/dist/sap/ui/core/date/CalendarWeekNumbering.js

@@ -1,2 +1,30 @@
-import CalendarWeekNumbering from '../../../base/i18n/date/CalendarWeekNumbering.js';
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+// Provides type sap.ui.core.date.CalendarWeekNumbering.
+import DataType from "../../base/DataType.js";
+import CalendarWeekNumbering from "../../../base/i18n/date/CalendarWeekNumbering.js";
+/**
+ * The <code>CalendarWeekNumbering</code> enum defines how to calculate calendar weeks. Each
+ * value defines:
+ * <ul>
+ * <li>The first day of the week,</li>
+ * <li>the first week of the year.</li>
+ * </ul>
+ *
+ * @enum {string}
+ * @public
+ * @since 1.108.0
+ * @deprecated As of Version 1.120. Please use {@link module:sap/base/18n/date/CalendarWeekNumbering} instead.
+ * @name sap.ui.core.date.CalendarWeekNumbering
+ * @borrows module:sap/base/i18n/date/CalendarWeekNumbering.Default as Default
+ * @borrows module:sap/base/i18n/date/CalendarWeekNumbering.ISO_8601 as ISO_8601
+ * @borrows module:sap/base/i18n/date/CalendarWeekNumbering.MiddleEastern as MiddleEastern
+ * @borrows module:sap/base/i18n/date/CalendarWeekNumbering.WesternTraditional as WesternTraditional
+ * @borrows module:sap/base/i18n/date/CalendarWeekNumbering.getWeekConfigurationValues as getWeekConfigurationValues
+ */
+
+DataType.registerEnum("sap.ui.core.date.CalendarWeekNumbering", CalendarWeekNumbering);
 export default CalendarWeekNumbering;

package/dist/sap/ui/core/date/Gregorian.js

@@ -1,17 +1,32 @@
-import UniversalDate from './UniversalDate.js';
-import CalendarType from '../CalendarType.js';
-import _Calendars from './_Calendars.js';
-var Gregorian = UniversalDate.extend('sap.ui.core.date.Gregorian', {
-    constructor: function () {
-        this.oDate = this.createDate(Date, arguments);
-        this.sCalendarType = CalendarType.Gregorian;
-    }
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+// Provides class sap.ui.core.date.Gregorian
+import UniversalDate from "./UniversalDate.js";
+import CalendarType from "../CalendarType.js";
+import _Calendars from "./_Calendars.js";
+/**
+ * The Gregorian date class
+ *
+ * @class
+ *
+ * @private
+ * @alias sap.ui.core.date.Gregorian
+ * @extends sap.ui.core.date.UniversalDate
+ */
+var Gregorian = UniversalDate.extend("sap.ui.core.date.Gregorian", /** @lends sap.ui.core.date.Gregorian.prototype */{
+  constructor: function () {
+    this.oDate = this.createDate(Date, arguments);
+    this.sCalendarType = CalendarType.Gregorian;
+  }
 });
 Gregorian.UTC = function () {
-    return Date.UTC.apply(Date, arguments);
+  return Date.UTC.apply(Date, arguments);
 };
 Gregorian.now = function () {
-    return Date.now();
+  return Date.now();
 };
 _Calendars.set(CalendarType.Gregorian, Gregorian);
 export default Gregorian;