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

package/dist/sap/base/i18n/LanguageTag.js

@@ -1,35 +1,173 @@
+/**
+ * A regular expression that describes language tags according to BCP-47.
+ * @see BCP47 "Tags for Identifying Languages" (http://www.ietf.org/rfc/bcp/bcp47.txt)
+ *
+ * The matching groups are
+ *  0=all
+ *  1=language (shortest ISO639 code + ext. language sub tags | 4digits (reserved) | registered language sub tags)
+ *  2=script (4 letters)
+ *  3=region (2 letter language or 3 digits)
+ *  4=variants (separated by '-', Note: capturing group contains leading '-' to shorten the regex!)
+ *  5=extensions (including leading singleton, multiple extensions separated by '-'.Note: capturing group contains leading '-' to shorten the regex!)
+ *  6=private use section (including leading 'x', multiple sections separated by '-')
+ *
+ *              [-------------------- language ----------------------][--- script ---][------- region --------][------------- variants --------------][----------- extensions ------------][------ private use -------]
+ */ /*!
+     * OpenUI5
+     * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+     * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+     */
+
+//Provides the LanguageTag object module:sap/base/i18n/LanguageTag
+
 var rLanguageTag = /^((?:[A-Z]{2,3}(?:-[A-Z]{3}){0,3})|[A-Z]{4}|[A-Z]{5,8})(?:-([A-Z]{4}))?(?:-([A-Z]{2}|[0-9]{3}))?((?:-[0-9A-Z]{5,8}|-[0-9][0-9A-Z]{3})*)((?:-[0-9A-WYZ](?:-[0-9A-Z]{2,8})+)*)(?:-(X(?:-[0-9A-Z]{1,8})+))?$/i;
-var LanguageTag = function (sLanguageTag) {
-  var aResult = rLanguageTag.exec(sLanguageTag.replace(/_/g, "-"));
-  if (aResult === null) {
-    throw new TypeError("The given language tag'" + sLanguageTag + "' does not adhere to BCP-47.");
+
+/**
+ * Creates an LanguageTag instance.
+ * LanguageTag represents a BCP-47 language tag, consisting of a language, script, region, variants, extensions and private use section.
+ *
+ * @class
+ *
+ * @param {string} sLanguageTag the language tag identifier, in format en-US or en_US.
+ *
+ * @author SAP SE
+ * @version 1.120.3
+ * @public
+ * @alias module:sap/base/i18n/LanguageTag
+ */
+class LanguageTag {
+  /**
+   * Get the language.
+   *
+   * Note that the case might differ from the original script tag
+   * (Lower case is enforced as recommended by BCP47/ISO639).
+   *
+   * @type {string}
+   * @public
+   */
+  language;
+
+  /**
+   * Get the script or <code>null</code> if none was specified.
+   *
+   * Note that the case might differ from the original language tag
+   * (Upper case first letter and lower case reminder enforced as
+   * recommended by BCP47/ISO15924)
+   *
+   * @type {string|null}
+   * @public
+   */
+  script;
+
+  /**
+   * Get the region or <code>null</code> if none was specified.
+   *
+   * Note that the case might differ from the original script tag
+   * (Upper case is enforced as recommended by BCP47/ISO3166-1).
+   *
+   * @type {string}
+   * @public
+   */
+  region;
+
+  /**
+   * Get the variants as a single string or <code>null</code>.
+   *
+   * Multiple variants are separated by a dash '-'.
+   *
+   * @type {string|null}
+   * @public
+   */
+  variant;
+
+  /**
+   * Get the variants as an array of individual variants.
+   *
+   * The separating dashes are not part of the result.
+   * If there is no variant section in the language tag, an empty array is returned.
+   *
+   * @type {string[]}
+   * @public
+   */
+  variantSubtags;
+
+  /**
+   * Get the extension as a single string or <code>null</code>.
+   *
+   * The extension always consists of a singleton character (not 'x'),
+   * a dash '-' and one or more extension token, each separated
+   * again with a dash.
+   *
+   * @type {string|null}
+   * @public
+   */
+  extension;
+
+  /**
+   * Get the extensions as an array of tokens.
+   *
+   * The leading singleton and the separating dashes are not part of the result.
+   * If there is no extensions section in the language tag, an empty array is returned.
+   *
+   * @type {string[]}
+   * @public
+   */
+  extensionSubtags;
+
+  /**
+   * Get the private use section or <code>null</code>.
+   *
+   * @type {string}
+   */
+  privateUse;
+
+  /**
+   * Get the private use section as an array of tokens.
+   *
+   * The leading singleton and the separating dashes are not part of the result.
+   * If there is no private use section in the language tag, an empty array is returned.
+   *
+   * @type {string[]}
+   */
+  privateUseSubtags;
+  constructor(sLanguageTag) {
+    var aResult = rLanguageTag.exec(sLanguageTag.replace(/_/g, "-"));
+    // If the given language tag string cannot be parsed by the regular expression above,
+    // we should at least tell the developer why the Core fails to load.
+    if (aResult === null) {
+      throw new TypeError("The given language tag'" + sLanguageTag + "' does not adhere to BCP-47.");
+    }
+    this.language = aResult[1] || null;
+    this.script = aResult[2] || null;
+    this.region = aResult[3] || null;
+    this.variant = aResult[4] && aResult[4].slice(1) || null; // remove leading dash from capturing group
+    this.variantSubtags = this.variant ? this.variant.split('-') : [];
+    this.extension = aResult[5] && aResult[5].slice(1) || null; // remove leading dash from capturing group
+    this.extensionSubtags = this.variant ? this.variant.split('-') : [];
+    this.privateUse = aResult[6] || null;
+    this.privateUseSubtags = this.privateUse ? this.privateUse.slice(2).split('-') : [];
+    // convert subtags according to the BCP47 recommendations
+    // - language: all lower case
+    // - script: lower case with the first letter capitalized
+    // - region: all upper case
+    if (this.language) {
+      this.language = this.language.toLowerCase();
+    }
+    if (this.script) {
+      this.script = this.script.toLowerCase().replace(/^[a-z]/, function ($) {
+        return $.toUpperCase();
+      });
+    }
+    if (this.region) {
+      this.region = this.region.toUpperCase();
+    }
+    Object.freeze(this);
   }
-  this.language = aResult[1] || null;
-  this.script = aResult[2] || null;
-  this.region = aResult[3] || null;
-  this.variant = aResult[4] && aResult[4].slice(1) || null;
-  this.variantSubtags = this.variant ? this.variant.split("-") : [];
-  this.extension = aResult[5] && aResult[5].slice(1) || null;
-  this.extensionSubtags = this.variant ? this.variant.split("-") : [];
-  this.privateUse = aResult[6] || null;
-  this.privateUseSubtags = this.privateUse ? this.privateUse.slice(2).split("-") : [];
-  if (this.language) {
-    this.language = this.language.toLowerCase();
+  toString() {
+    return this.#join(this.language, this.script, this.region, this.variant, this.extension, this.privateUse);
   }
-  if (this.script) {
-    this.script = this.script.toLowerCase().replace(/^[a-z]/, function ($) {
-      return $.toUpperCase();
-    });
+  #join() {
+    return Array.prototype.filter.call(arguments, Boolean).join("-");
   }
-  if (this.region) {
-    this.region = this.region.toUpperCase();
-  }
-  Object.freeze(this);
-};
-LanguageTag.prototype.toString = function () {
-  return join(this.language, this.script, this.region, this.variant, this.extension, this.privateUse);
-};
-function join() {
-  return Array.prototype.filter.call(arguments, Boolean).join("-");
 }
-export default LanguageTag;
+export default LanguageTag;

package/dist/sap/base/i18n/date/CalendarType.js

@@ -1,8 +1,43 @@
+/**
+ * The types of <code>Calendar</code>.
+ *
+ * @enum {string}
+ * @alias module:sap/base/i18n/date/CalendarType
+ * @public
+ * @since 1.120
+ */ /*!
+     * 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 module:sap/base/i18n/date/CalendarType.
+
 var CalendarType = {
+  /**
+   * The Gregorian calendar
+   * @public
+   */
   Gregorian: "Gregorian",
+  /**
+   * The Islamic calendar
+   * @public
+   */
   Islamic: "Islamic",
+  /**
+   * The Japanese emperor calendar
+   * @public
+   */
   Japanese: "Japanese",
+  /**
+   * The Persian Jalali calendar
+   * @public
+   */
   Persian: "Persian",
+  /**
+   * The Thai buddhist calendar
+   * @public
+   */
   Buddhist: "Buddhist"
 };
-export default CalendarType;
+export default CalendarType;

package/dist/sap/base/i18n/date/CalendarWeekNumbering.js

@@ -1,10 +1,84 @@
+/**
+ * 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
+ * @alias module:sap/base/i18n/date/CalendarWeekNumbering
+ * @since 1.120
+ */ /*!
+     * 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 module:sap/base/i18n/date/CalendarWeekNumbering.
+
 var CalendarWeekNumbering = {
+  /**
+   * The default calendar week numbering:
+   *
+   * The framework determines the week numbering scheme; currently it is derived from the
+   * active format locale. Future versions of UI5 might select a different week numbering
+   * scheme.
+   *
+   * @public
+   */
   Default: "Default",
+  /**
+   * Official calendar week numbering in most of Europe (ISO 8601 standard):
+   * <ul>
+   * <li>Monday is first day of the week,
+   * <li>the week containing January 4th is first week of the year.
+   * </ul>
+   *
+   * @public
+   */
   ISO_8601: "ISO_8601",
+  /**
+   * Official calendar week numbering in much of the Middle East (Middle Eastern calendar):
+   * <ul>
+   * <li>Saturday is first day of the week,
+   * <li>the week containing January 1st is first week of the year.
+   * </ul>
+   *
+   * @public
+   */
   MiddleEastern: "MiddleEastern",
+  /**
+   * Official calendar week numbering in the United States, Canada, Brazil, Israel, Japan, and
+   * other countries (Western traditional calendar):
+   * <ul>
+   * <li>Sunday is first day of the week,
+   * <li>the week containing January 1st is first week of the year.
+   * </ul>
+   *
+   * @public
+   */
   WesternTraditional: "WesternTraditional"
 };
+
+/**
+ * Returns an object containing the week configuration values for the given calendar week
+ * numbering algorithm.
+ *
+ * @param {module:sap/base/i18n/date/CalendarWeekNumbering} [sCalendarWeekNumbering=Default]
+ *   The calendar week numbering algorithm
+ * @returns {{firstDayOfWeek: 0|1|2|3|4|5|6, minimalDaysInFirstWeek: 1|2|3|4|5|6|7}|undefined}
+ *   The week configuration values or <code>undefined</code> if the given calendar week
+ *   numbering algorithm is "Default"
+ *
+ * @function
+ * @name module:sap/base/i18n/date/CalendarWeekNumbering.getWeekConfigurationValues
+ * @private
+ */
 Object.defineProperty(CalendarWeekNumbering, "getWeekConfigurationValues", {
+  // configurable : false,
+  // enumerable : false,
   value: function (sCalendarWeekNumbering) {
     switch (sCalendarWeekNumbering) {
       case CalendarWeekNumbering.ISO_8601:
@@ -26,5 +100,6 @@ Object.defineProperty(CalendarWeekNumbering, "getWeekConfigurationValues", {
         return undefined;
     }
   }
+  // writable : false
 });
-export default CalendarWeekNumbering;
+export default CalendarWeekNumbering;

package/dist/sap/base/i18n/date/TimezoneUtils.js

@@ -1,9 +1,49 @@
+/**
+ * Static collection of utility functions to handle time zone related conversions
+ *
+ * @author SAP SE
+ * @version 1.120.3
+ * @namespace
+ * @alias module:sap/base/i18n/date/TimezoneUtils
+ * @private
+ * @ui5-restricted sap.ui.core.Configuration, sap/base/i18n/format/DateFormat
+ */ /*!
+     * OpenUI5
+     * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+     * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+     */
+
 var TimezoneUtils = {};
+
+/**
+ * Cache for the (browser's) local IANA timezone ID
+ *
+ * @type {string}
+ */
 var sLocalTimezone = "";
+
+/**
+ * Cache for valid time zones provided by <code>Intl.supportedValuesOf("timeZone")</code>
+ *
+ * @type {Array}
+ */
 var aSupportedTimezoneIDs;
+
+/**
+ * Cache for Intl.DateTimeFormat instances
+ */
 var oIntlDateTimeFormatCache = {
   _oCache: new Map(),
+  /**
+   * When cache limit is reached, it gets cleared
+   */
   _iCacheLimit: 10,
+  /**
+   * Creates or gets an instance of Intl.DateTimeFormat.
+   *
+   * @param {string} sTimezone IANA timezone ID
+   * @returns {Intl.DateTimeFormat} Intl.DateTimeFormat instance
+   */
   get: function (sTimezone) {
     var cacheEntry = this._oCache.get(sTimezone);
     if (cacheEntry) {
@@ -19,11 +59,13 @@ var oIntlDateTimeFormatCache = {
       month: "2-digit",
       year: "numeric",
       timeZone: sTimezone,
-      timeZoneName: "short",
-      era: "narrow",
+      timeZoneName: 'short',
+      era: 'narrow',
       weekday: "short"
     };
     var oInstance = new Intl.DateTimeFormat("en-US", oOptions);
+
+    // only store a limited number of entries in the cache
     if (this._oCache.size === this._iCacheLimit) {
       this._oCache = new Map();
     }
@@ -31,17 +73,35 @@ var oIntlDateTimeFormatCache = {
     return oInstance;
   }
 };
+
+/**
+ * Uses the <code>Intl.supportedValuesOf('timeZone')</code> and <code>Intl.DateTimeFormat</code>
+ * API to check if the browser can handle the given IANA timezone ID.
+ * <code>Intl.supportedValuesOf('timeZone')</code> offers direct access to the list of supported
+ * time zones. It is not yet supported by all browsers but if it is supported and the given time
+ * zone is in the list it is faster than probing.
+ *
+ * <code>Intl.supportedValuesOf('timeZone')</code> does not return all IANA timezone IDs which
+ * the <code>Intl.DateTimeFormat</code> can handle, e.g. "Japan", "Etc/UTC".
+ *
+ * @param {string} sTimezone The IANA timezone ID which is checked, e.g <code>"Europe/Berlin"</code>
+ * @returns {boolean} Whether the time zone is a valid IANA timezone ID
+ * @private
+ * @ui5-restricted sap.ui.core.Configuration, sap.ui.core.format.DateFormat
+ */
 TimezoneUtils.isValidTimezone = function (sTimezone) {
   if (!sTimezone) {
     return false;
   }
   if (Intl.supportedValuesOf) {
     try {
-      aSupportedTimezoneIDs = aSupportedTimezoneIDs || Intl.supportedValuesOf("timeZone");
+      aSupportedTimezoneIDs = aSupportedTimezoneIDs || Intl.supportedValuesOf('timeZone');
       if (aSupportedTimezoneIDs.includes(sTimezone)) {
         return true;
       }
+      // although not contained in the supportedValues it still can be valid, therefore continue
     } catch (oError) {
+      // ignore error
       aSupportedTimezoneIDs = [];
     }
   }
@@ -52,12 +112,60 @@ TimezoneUtils.isValidTimezone = function (sTimezone) {
     return false;
   }
 };
+
+/**
+ * Converts a date to a specific time zone.
+ * The resulting date reflects the given time zone such that the "UTC" Date methods
+ * can be used, e.g. Date#getUTCHours() to display the hours in the given time zone.
+ *
+ * @example
+ * var oDate = new Date("2021-10-13T15:22:33Z"); // UTC
+ * // time zone difference UTC-4 (DST)
+ * TimezoneUtils.convertToTimezone(oDate, "America/New_York");
+ * // result is:
+ * // 2021-10-13 11:22:33 in America/New_York
+ * // same as new Date("2021-10-13T11:22:33Z"); // UTC
+ *
+ * @param {Date} oDate The date which should be converted.
+ * @param {string} sTargetTimezone The target IANA timezone ID, e.g <code>"Europe/Berlin"</code>
+ * @returns {Date} The new date in the target time zone.
+ * @private
+ * @ui5-restricted sap.ui.core.format.DateFormat, sap.ui.unified, sap.m
+ */
 TimezoneUtils.convertToTimezone = function (oDate, sTargetTimezone) {
   var oFormatParts = this._getParts(oDate, sTargetTimezone);
   return TimezoneUtils._getDateFromParts(oFormatParts);
 };
+
+/**
+ * Uses the <code>Intl.DateTimeFormat</code> API to convert a date to a specific time zone.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/formatToParts
+ * @param {Date} oDate The date which should be converted.
+ * @param {string} sTargetTimezone The target IANA timezone ID, e.g <code>"Europe/Berlin"</code>
+ * @returns {{
+ *     day: string,
+ *     era: string,
+ *     fractionalSecond: string,
+ *     hour: string,
+ *     minute: string,
+ *     month: string,
+ *     second: string,
+ *     timeZoneName: string,
+ *     weekday: string,
+ *     year: string
+ * }} An object containing the date and time fields considering the target time zone.
+ * @private
+ */
 TimezoneUtils._getParts = function (oDate, sTargetTimezone) {
-  var sKey, oPart, oDateParts = Object.create(null), oIntlDate = oIntlDateTimeFormatCache.get(sTargetTimezone), oParts = oIntlDate.formatToParts(new Date(oDate.getTime()));
+  var sKey,
+    oPart,
+    oDateParts = Object.create(null),
+    oIntlDate = oIntlDateTimeFormatCache.get(sTargetTimezone),
+    // clone the date object before passing it to the Intl API, to ensure that no
+    // UniversalDate gets passed to it;
+    // no need to use UI5Date.getInstance as only the UTC timestamp is used
+    oParts = oIntlDate.formatToParts(new Date(oDate.getTime()));
   for (sKey in oParts) {
     oPart = oParts[sKey];
     if (oPart.type !== "literal") {
@@ -66,24 +174,146 @@ TimezoneUtils._getParts = function (oDate, sTargetTimezone) {
   }
   return oDateParts;
 };
+
+/**
+ * Creates a Date from the provided date parts.
+ *
+ * @param {object} oParts Separated date and time fields as object, see {@link #_getParts}.
+ * @returns {Date} Returns the date object created from the provided parts.
+ * @private
+ */
 TimezoneUtils._getDateFromParts = function (oParts) {
-  var oDate = new Date(0), iUTCYear = parseInt(oParts.year);
+  // no need to use UI5Date.getInstance as only the UTC timestamp is used
+  var oDate = new Date(0),
+    iUTCYear = parseInt(oParts.year);
   if (oParts.era === "B") {
+    // The JS Date uses astronomical year numbering which supports year zero and negative
+    // year numbers.
+    // The Intl.DateTimeFormat API uses eras (no year zero and no negative year numbers).
+    // years around zero overview:
+    // | Astronomical | In Era
+    // |            2 | 2 Anno Domini (era: "A")
+    // |            1 | 1 Anno Domini (era: "A")
+    // |            0 | 1 Before Christ (era: "B")
+    // |           -1 | 2 Before Christ (era: "B")
+    // |           -2 | 3 Before Christ (era: "B")
+    // For the conversion to the JS Date the parts returned by the Intl.DateTimeFormat API
+    // need to be adapted.
     iUTCYear = iUTCYear * -1 + 1;
   }
+
+  // Date.UTC cannot be used here to be able to support dates before the UNIX epoch
   oDate.setUTCFullYear(iUTCYear, parseInt(oParts.month) - 1, parseInt(oParts.day));
-  oDate.setUTCHours(parseInt(oParts.hour), parseInt(oParts.minute), parseInt(oParts.second), parseInt(oParts.fractionalSecond || 0));
+  oDate.setUTCHours(parseInt(oParts.hour), parseInt(oParts.minute), parseInt(oParts.second), parseInt(oParts.fractionalSecond || 0)); // some older browsers don't support fractionalSecond, e.g. Safari < 14.1 */
+
   return oDate;
 };
+
+/**
+ * Gets the offset to UTC in seconds for a given date in the time zone specified.
+ *
+ * For non-unique points in time, the daylight saving time takes precedence over the standard
+ * time shortly after the switch back (e.g. clock gets set back 1 hour, duplicate hour).
+ *
+ * @example
+ * var oDate = new Date("2021-10-13T13:22:33Z");
+ * TimezoneUtils.calculateOffset(oDate, "America/New_York");
+ * // => +14400 seconds (4 * 60 * 60 seconds)
+ *
+ * TimezoneUtils.calculateOffset(oDate, "Europe/Berlin");
+ * // => -7200 seconds (-2 * 60 * 60 seconds)
+ *
+ * // daylight saving time (2018 Sun, 25 Mar, 02:00	CET → CEST	+1 hour (DST start)	UTC+2h)
+ * // the given date is taken as it is in the time zone
+ * TimezoneUtils.calculateOffset(new Date("2018-03-25T00:00:00Z"), "Europe/Berlin");
+ * // => -3600 seconds (-1 * 60 * 60 seconds), interpreted as: 2018-03-25 00:00:00 (CET)
+ *
+ * TimezoneUtils.calculateOffset(new Date("2018-03-25T03:00:00Z"), "Europe/Berlin");
+ * // => -7200 seconds (-2 * 60 * 60 seconds)
+ *
+ * var oHistoricalDate = new Date("1800-10-13T13:22:33Z");
+ * TimezoneUtils.calculateOffset(oHistoricalDate, "Europe/Berlin");
+ * // => -3208 seconds (-3208 seconds)
+ *
+ * @param {Date} oDate The date in the time zone used to calculate the offset to UTC.
+ * @param {string} sTimezoneSource The source IANA timezone ID, e.g <code>"Europe/Berlin"</code>
+ * @returns {number} The difference to UTC between the date in the time zone.
+ * @private
+ * @ui5-restricted sap.ui.core.format.DateFormat
+ */
 TimezoneUtils.calculateOffset = function (oDate, sTimezoneSource) {
-  var oFirstGuess = this.convertToTimezone(oDate, sTimezoneSource), iInitialOffset = oDate.getTime() - oFirstGuess.getTime(), oDateSource = new Date(oDate.getTime() + iInitialOffset), oDateTarget = this.convertToTimezone(oDateSource, sTimezoneSource);
-  return (oDateSource.getTime() - oDateTarget.getTime()) / 1000;
+  const oDateInTimezone = TimezoneUtils.convertToTimezone(oDate, sTimezoneSource);
+  const iGivenTimestamp = oDate.getTime();
+  const iInitialOffset = iGivenTimestamp - oDateInTimezone.getTime();
+  // no need to use UI5Date.getInstance as only the UTC timestamp is used
+  const oFirstGuess = new Date(iGivenTimestamp + iInitialOffset);
+  const oFirstGuessInTimezone = TimezoneUtils.convertToTimezone(oFirstGuess, sTimezoneSource);
+  const iFirstGuessInTimezoneTimestamp = oFirstGuessInTimezone.getTime();
+  const iSecondOffset = oFirstGuess.getTime() - iFirstGuessInTimezoneTimestamp;
+  let iTimezoneOffset = iSecondOffset;
+  if (iInitialOffset !== iSecondOffset) {
+    const oSecondGuess = new Date(iGivenTimestamp + iSecondOffset);
+    const oSecondGuessInTimezone = TimezoneUtils.convertToTimezone(oSecondGuess, sTimezoneSource);
+    const iSecondGuessInTimezoneTimestamp = oSecondGuessInTimezone.getTime();
+    // if time is different, the given date/time does not exist in the target time zone (switch to Daylight
+    // Saving Time) -> take the offset for the greater date
+    if (iSecondGuessInTimezoneTimestamp !== iGivenTimestamp && iFirstGuessInTimezoneTimestamp > iSecondGuessInTimezoneTimestamp) {
+      iTimezoneOffset = iInitialOffset;
+    }
+  }
+  return iTimezoneOffset / 1000;
 };
+
+/**
+ * Map outdated IANA timezone IDs used in CLDR to correct and up-to-date IANA IDs as maintained in ABAP systems.
+ *
+ * @private
+	 */
+TimezoneUtils.mCLDR2ABAPTimezones = {
+  "America/Buenos_Aires": "America/Argentina/Buenos_Aires",
+  "America/Catamarca": "America/Argentina/Catamarca",
+  "America/Cordoba": "America/Argentina/Cordoba",
+  "America/Jujuy": "America/Argentina/Jujuy",
+  "America/Mendoza": "America/Argentina/Mendoza",
+  "America/Indianapolis": "America/Indiana/Indianapolis",
+  "America/Louisville": "America/Kentucky/Louisville",
+  "Africa/Asmera": "Africa/Asmara",
+  "Asia/Katmandu": "Asia/Kathmandu",
+  "Asia/Calcutta": "Asia/Kolkata",
+  "Atlantic/Faeroe": "Atlantic/Faroe",
+  "Pacific/Ponape": "Pacific/Pohnpei",
+  "Asia/Rangoon": "Asia/Yangon",
+  "Pacific/Truk": "Pacific/Chuuk",
+  "America/Godthab": "America/Nuuk",
+  "Asia/Saigon": "Asia/Ho_Chi_Minh",
+  "America/Coral_Harbour": "America/Atikokan"
+};
+
+/**
+ * Retrieves the browser's local IANA timezone ID; if the browser's timezone ID is not the up-to-date IANA
+ * timezone ID, the corresponding IANA timezone ID is returned.
+ *
+ * @returns {string} The local IANA timezone ID of the browser as up-to-date IANA timezone ID,
+ *   e.g. <code>"Europe/Berlin"</code> or <code>"Asia/Kolkata"</code>
+ *
+ * @private
+ * @ui5-restricted sap.ui.core.Configuration,sap.m.DateTimeField
+ */
 TimezoneUtils.getLocalTimezone = function () {
-  if (sLocalTimezone) {
-    return sLocalTimezone;
+  if (sLocalTimezone === "") {
+    // timezone may be undefined, only value "" means empty cache
+    sLocalTimezone = new Intl.DateTimeFormat().resolvedOptions().timeZone;
+    sLocalTimezone = TimezoneUtils.mCLDR2ABAPTimezones[sLocalTimezone] || sLocalTimezone;
   }
-  sLocalTimezone = new Intl.DateTimeFormat().resolvedOptions().timeZone;
   return sLocalTimezone;
 };
-export default TimezoneUtils;
+
+/**
+ * Clears the cache for the browser's local IANA timezone ID.
+ *
+ * @private
+ */
+TimezoneUtils._clearLocalTimezoneCache = function () {
+  sLocalTimezone = "";
+};
+export default TimezoneUtils;

package/dist/sap/base/strings/camelize.js

@@ -0,0 +1,30 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+var rCamelCase = /-(.)/ig;
+
+/**
+ * Transforms a hyphen separated string to a camel case string.
+ *
+ * @example
+ * require(["sap/base/strings/camelize"], function(camelize){
+ *      camelize("foo-bar"); // "fooBar"
+ * });
+ *
+ * @function
+ * @since 1.58
+ * @alias module:sap/base/strings/camelize
+ * @param {string} sString Hyphen separated string
+ * @returns {string} The transformed string
+ * @public
+ * @SecPassthrough {0|return}
+ */
+var fnCamelize = function (sString) {
+  return sString.replace(rCamelCase, function (sMatch, sChar) {
+    return sChar.toUpperCase();
+  });
+};
+export default fnCamelize;