@ui5/webcomponents-localization 1.22.0-rc.0 → 1.22.0-rc.2

package/dist/sap/ui/base/Object.js

@@ -1,64 +1,300 @@
-import Metadata from './Metadata.js';
-import Log from '../../base/Log.js';
-var BaseObject = Metadata.createClass('sap.ui.base.Object', {
-    constructor: function () {
-        if (!(this instanceof BaseObject)) {
-            throw Error('Cannot instantiate object: "new" is missing!');
-        }
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+/**
+ * SAPUI5 base classes
+ *
+ * @namespace
+ * @name sap.ui.base
+ * @public
+ */
+// Provides class sap.ui.base.Object
+import Metadata from "./Metadata.js";
+import Log from "../../base/Log.js";
+/**
+ * Constructor for an <code>sap.ui.base.Object</code>.
+ *
+ * Subclasses of this class should always call the constructor of their base class.
+ *
+ * @class Base class for all SAPUI5 Objects.
+ * @abstract
+ * @author Malte Wedel
+ * @version 1.120.3
+ * @public
+ * @alias sap.ui.base.Object
+ * @throws {Error} When an instance of the class or its subclasses is created without the <code>new</code> operator.
+ */
+var BaseObject = Metadata.createClass("sap.ui.base.Object", {
+  constructor: function () {
+    // complain if 'this' is not an instance of a subclass
+    if (!(this instanceof BaseObject)) {
+      throw Error("Cannot instantiate object: \"new\" is missing!");
     }
+  }
 });
-BaseObject.prototype.destroy = function () {
-};
+
+/**
+ * Destructor method for objects.
+ * @public
+ */
+BaseObject.prototype.destroy = function () {};
+
+/**
+ * Returns the public facade of this object.
+ *
+ * By default, the public facade is implemented as an instance of {@link sap.ui.base.Interface},
+ * exposing the <code>publicMethods</code> as defined in the metadata of the class of this object.
+ *
+ * See the documentation of the {@link #.extend extend} method for an explanation of <code>publicMethods</code>.
+ *
+ * The facade is created on the first call of <code>getInterface</code> and reused for all later calls.
+ *
+ * @public
+ * @returns {sap.ui.base.Object} A facade for this object, with at least the public methods of the class of this.
+ */
 BaseObject.prototype.getInterface = function () {
-    var oInterface = new BaseObject._Interface(this, this.getMetadata().getAllPublicMethods());
-    this.getInterface = function () {
-        return oInterface;
-    };
+  // New implementation that avoids the overhead of a dedicated member for the interface
+  // initially, an Object instance has no associated Interface and the getInterface
+  // method is defined only in the prototype. So the code here will be executed.
+  // It creates an interface (basically the same code as in the old implementation)
+  var oInterface = new BaseObject._Interface(this, this.getMetadata().getAllPublicMethods());
+  // Now this Object instance gets a new, private implementation of getInterface
+  // that returns the newly created oInterface. Future calls of getInterface on the
+  // same Object therefore will return the already created interface
+  this.getInterface = function () {
     return oInterface;
+  };
+  // as the first caller doesn't benefit from the new method implementation we have to
+  // return the created interface as well.
+  return oInterface;
 };
+
+/**
+ * Returns the metadata for the class that this object belongs to.
+ *
+ * This method is only defined when metadata has been declared by using {@link sap.ui.base.Object.defineClass}
+ * or {@link sap.ui.base.Object.extend}.
+ *
+ * @return {sap.ui.base.Metadata} metadata for the class of the object
+ * @name sap.ui.base.Object#getMetadata
+ * @function
+ * @public
+ */
+
+/**
+ * The structure of the "metadata" object which is passed when inheriting from sap.ui.base.Object using its static "extend" method.
+ * See {@link sap.ui.base.Object.extend} for details on its usage.
+ *
+ * @typedef {object} sap.ui.base.Object.MetadataOptions
+ *
+ * @property {string[]} [interfaces] set of names of implemented interfaces (defaults to no interfaces)
+ * @property {boolean} [abstract=false] flag that marks the class as abstract (purely informational, defaults to false)
+ * @property {boolean} [final=false] flag that marks the class as final (defaults to false)
+ * @property {boolean} [deprecated=false] flag that marks the class as deprecated (defaults to false). May lead to an additional warning
+ *     log message at runtime when the object is still used. For the documentation, also add a <code>@deprecated</code> tag in the JSDoc,
+ *     describing since when it is deprecated and what any alternatives are.
+ *
+ * @public
+ */
+
+/**
+ * Creates a subclass of class sap.ui.base.Object with name <code>sClassName</code>
+ * and enriches it with the information contained in <code>oClassInfo</code>.
+ *
+ * <code>oClassInfo</code> might contain three kinds of information:
+ * <ul>
+ * <li><code>metadata:</code> an (optional) object literal with metadata about the class like implemented interfaces,
+ * see {@link sap.ui.base.Object.MetadataOptions MetadataOptions} for details.
+ * The information in the object literal will be wrapped by an instance of {@link sap.ui.base.Metadata Metadata}.
+ * Subclasses of sap.ui.base.Object can enrich the set of supported metadata (e.g. see {@link sap.ui.core.Element.extend}).
+ * </li>
+ *
+ * <li><code>constructor:</code> a function that serves as a constructor function for the new class.
+ * If no constructor function is given, the framework creates a default implementation that delegates all
+ * its arguments to the constructor function of the base class.
+ * </li>
+ *
+ * <li><i>any-other-name:</i> any other property in the <code>oClassInfo</code> is copied into the prototype
+ * object of the newly created class. Callers can thereby add methods or properties to all instances of the
+ * class. But be aware that the given values are shared between all instances of the class. Usually, it doesn't
+ * make sense to use primitive values here other than to declare public constants.
+ *
+ * If such a property has a function as its value, and if the property name does not start with an underscore
+ * or with the prefix "on", the property name will be automatically added to the list of public methods of the
+ * class (see property <code>publicMethods</code> in the <code>metadata</code> section). If a method's name
+ * matches that pattern, but is not meant to be public, it shouldn't be included in the class info object,
+ * but be assigned to the prototype instead.
+ * </li>
+ *
+ * </ul>
+ *
+ * The prototype object of the newly created class uses the same prototype as instances of the base class
+ * (prototype chaining).
+ *
+ * A metadata object is always created, even if there is no <code>metadata</code> entry in the <code>oClassInfo</code>
+ * object. A getter for the metadata is always attached to the prototype and to the class (constructor function)
+ * itself.
+ *
+ * Last but not least, with the third argument <code>FNMetaImpl</code> the constructor of a metadata class
+ * can be specified. Instances of that class will be used to represent metadata for the newly created class
+ * and for any subclass created from it. Typically, only frameworks will use this parameter to enrich the
+ * metadata for a new class hierarchy they introduce (e.g. {@link sap.ui.core.Element.extend Element}).
+ *
+ * @param {string} sClassName name of the class to be created
+ * @param {object} [oClassInfo] structured object with information about the class
+ * @param {function} [FNMetaImpl] constructor function for the metadata object. If not given, it defaults to sap.ui.base.Metadata.
+ * @return {function} the created class / constructor function
+ * @public
+ * @static
+ * @name sap.ui.base.Object.extend
+ * @function
+ * @since 1.3.1
+ */
+
+/**
+ * Creates metadata for a given class and attaches it to the constructor and prototype of that class.
+ *
+ * After creation, metadata can be retrieved with getMetadata().
+ *
+ * The static info can at least contain the following entries:
+ * <ul>
+ * <li>baseType: {string} fully qualified name of a base class or empty</li>
+ * <li>publicMethods: {string} an array of method names that will be visible in the interface proxy returned by {@link #getInterface}</li>
+ * </ul>
+ *
+ * @param {string} sClassName name of an (already declared) constructor function
+ * @param {object} oStaticInfo static info used to create the metadata object
+ * @param {string} oStaticInfo.baseType qualified name of a base class
+ * @param {string[]} oStaticInfo.publicMethods array of names of public methods
+ * @param {function} [FNMetaImpl] constructor function for the metadata object. If not given, it defaults to sap.ui.base.Metadata.
+ *
+ * @return {sap.ui.base.Metadata} the created metadata object
+ * @public
+ * @static
+ * @deprecated Since 1.3.1. Use the static <code>extend</code> method of the desired base class (e.g. {@link sap.ui.base.Object.extend})
+ */
 BaseObject.defineClass = function (sClassName, oStaticInfo, FNMetaImpl) {
-    var oMetadata = new (FNMetaImpl || Metadata)(sClassName, oStaticInfo);
-    var fnClass = oMetadata.getClass();
-    fnClass.getMetadata = fnClass.prototype.getMetadata = function () {
-        return oMetadata;
-    };
-    if (!oMetadata.isFinal()) {
-        fnClass.extend = function (sSCName, oSCClassInfo, fnSCMetaImpl) {
-            return Metadata.createClass(fnClass, sSCName, oSCClassInfo, fnSCMetaImpl || FNMetaImpl);
-        };
-    }
-    Log.debug('defined class \'' + sClassName + '\'' + (oMetadata.getParent() ? ' as subclass of ' + oMetadata.getParent().getName() : ''));
+  // create Metadata object
+  var oMetadata = new (FNMetaImpl || Metadata)(sClassName, oStaticInfo);
+  var fnClass = oMetadata.getClass();
+  fnClass.getMetadata = fnClass.prototype.getMetadata = function () {
     return oMetadata;
+  };
+  // enrich function
+  if (!oMetadata.isFinal()) {
+    fnClass.extend = function (sSCName, oSCClassInfo, fnSCMetaImpl) {
+      return Metadata.createClass(fnClass, sSCName, oSCClassInfo, fnSCMetaImpl || FNMetaImpl);
+    };
+  }
+  Log.debug("defined class '" + sClassName + "'" + (oMetadata.getParent() ? " as subclass of " + oMetadata.getParent().getName() : ""));
+  return oMetadata;
 };
+
+/**
+ * Checks whether this object is an instance of the named type.
+ *
+ * This check is solely based on the type names as declared in the class metadata.
+ * It compares the given <code>vTypeName</code> with the name of the class of this object,
+ * with the names of any base class of that class and with the names of all interfaces
+ * implemented by any of the aforementioned classes.
+ *
+ * Instead of a single type name, an array of type names can be given and the method
+ * will check if this object is an instance of any of the listed types (logical or).
+ *
+ * Should the UI5 class system in future implement additional means of associating classes
+ * with type names (e.g. by introducing mixins), then this method might detect matches
+ * for those names as well.
+ *
+ * @example
+ * myObject.isA("sap.ui.core.Control"); // true if myObject is an instance of sap.ui.core.Control
+ * myObject.isA(["sap.ui.core.Control", "sap.ui.core.Fragment"]); // true if myObject is an instance of sap.ui.core.Control or sap.ui.core.Fragment
+ *
+ * @param {string|string[]} vTypeName Type or types to check for
+ * @returns {boolean} Whether this object is an instance of the given type or of any of the given types
+ * @public
+ * @since 1.56
+ */
 BaseObject.prototype.isA = function (vTypeName) {
-    return this.getMetadata().isA(vTypeName);
+  return this.getMetadata().isA(vTypeName);
 };
+
+/**
+ * Checks whether the given object is an instance of the named type.
+ * This function is a short-hand convenience for {@link sap.ui.base.Object#isA}.
+ *
+ * Please see the API documentation of {@link sap.ui.base.Object#isA} for more details.
+ *
+ * @param {any} oObject Object which will be checked whether it is an instance of the given type
+ * @param {string|string[]} vTypeName Type or types to check for
+ * @returns {boolean} Whether the given object is an instance of the given type or of any of the given types
+ * @public
+ * @since 1.56
+ * @static
+ * @deprecated Since 1.120, please use {@link sap.ui.base.Object.isObjectA}.
+ */
 BaseObject.isA = function (oObject, vTypeName) {
-    return oObject instanceof BaseObject && oObject.isA(vTypeName);
+  return oObject instanceof BaseObject && oObject.isA(vTypeName);
 };
+
+/**
+ * Checks whether the given object is an instance of the named type.
+ * This function is a short-hand convenience for {@link sap.ui.base.Object#isA}.
+ *
+ * Please see the API documentation of {@link sap.ui.base.Object#isA} for more details.
+ *
+ * @param {any} oObject Object which will be checked whether it is an instance of the given type
+ * @param {string|string[]} vTypeName Type or types to check for
+ * @returns {boolean} Whether the given object is an instance of the given type or of any of the given types
+ * @public
+ * @since 1.120
+ * @static
+ */
+BaseObject.isObjectA = function (oObject, vTypeName) {
+  return oObject instanceof BaseObject && oObject.isA(vTypeName);
+};
+
+/**
+ * @param  {sap.ui.base.Object} [oObject] Object for which a facade should be created
+ * @param  {string[]} [aMethods=[]] Names of the methods, that should be available in the new facade
+ * @param  {boolean} [_bReturnFacade=false] If true, the return value of a function call is this created Interface instance instead of the BaseObject interface
+ * @private
+ * @static
+ */
 BaseObject._Interface = function (oObject, aMethods, _bReturnFacade) {
-    if (!oObject) {
-        return oObject;
-    }
-    function fCreateDelegator(oObject, sMethodName) {
-        return function () {
-            var tmp = oObject[sMethodName].apply(oObject, arguments);
-            if (_bReturnFacade) {
-                return this;
-            } else {
-                return tmp instanceof BaseObject ? tmp.getInterface() : tmp;
-            }
-        };
-    }
-    if (!aMethods) {
-        return {};
-    }
-    var sMethodName;
-    for (var i = 0, ml = aMethods.length; i < ml; i++) {
-        sMethodName = aMethods[i];
-        if (!oObject[sMethodName] || typeof oObject[sMethodName] === 'function') {
-            this[sMethodName] = fCreateDelegator(oObject, sMethodName);
-        }
+  // if object is null or undefined, return itself
+  if (!oObject) {
+    return oObject;
+  }
+  function fCreateDelegator(oObject, sMethodName) {
+    return function () {
+      // return oObject[sMethodName].apply(oObject, arguments);
+      var tmp = oObject[sMethodName].apply(oObject, arguments);
+      // to avoid to hide the implementation behind the interface you need
+      // to override the getInterface function in the object or create the interface with bFacade = true
+      if (_bReturnFacade) {
+        return this;
+      } else {
+        return tmp instanceof BaseObject ? tmp.getInterface() : tmp;
+      }
+    };
+  }
+
+  // if there are no methods return
+  if (!aMethods) {
+    return {};
+  }
+  var sMethodName;
+
+  // create functions for all delegated methods
+  // PERFOPT: 'cache' length of aMethods to reduce # of resolutions
+  for (var i = 0, ml = aMethods.length; i < ml; i++) {
+    sMethodName = aMethods[i];
+    //!oObject[sMethodName] for 'lazy' loading interface methods ;-)
+    if (!oObject[sMethodName] || typeof oObject[sMethodName] === "function") {
+      this[sMethodName] = fCreateDelegator(oObject, sMethodName);
     }
+  }
 };
 export default BaseObject;

package/dist/sap/ui/core/CalendarType.js

@@ -1,2 +1,24 @@
-import CalendarType from '../../base/i18n/date/CalendarType.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.CalendarType.
+import DataType from "../base/DataType.js";
+import CalendarType from "../../base/i18n/date/CalendarType.js";
+/**
+ * The types of <code>Calendar</code>.
+ *
+ * @enum {string}
+ * @name sap.ui.core.CalendarType
+ * @public
+ * @deprecated As of Version 1.120. Please use {@link module:sap/base/18n/date/CalendarType} instead.
+ * @borrows module:sap/base/i18n/date/CalendarType.Gregorian as Gregorian
+ * @borrows module:sap/base/i18n/date/CalendarType.Islamic as Islamic
+ * @borrows module:sap/base/i18n/date/CalendarType.Japanese as Japanese
+ * @borrows module:sap/base/i18n/date/CalendarType.Persian as Persian
+ * @borrows module:sap/base/i18n/date/CalendarType.Buddhist as Buddhist
+ */
+
+DataType.registerEnum("sap.ui.core.CalendarType", CalendarType);
 export default CalendarType;

package/dist/sap/ui/core/Locale.js

@@ -1,62 +1,194 @@
-import assert from '../../base/assert.js';
-import BaseObject from '../base/Object.js';
-import Localization from '../../base/i18n/Localization.js';
-import LanguageTag from '../../base/i18n/LanguageTag.js';
-var Locale = BaseObject.extend('sap.ui.core.Locale', {
-    constructor: function (vLocale) {
-        BaseObject.apply(this);
-        if (vLocale instanceof LanguageTag) {
-            this.oLanguageTag = vLocale;
-            this.sLocaleId = this.oLanguageTag.toString();
-        } else {
-            this.oLanguageTag = new LanguageTag(vLocale);
-            this.sLocaleId = vLocale;
-        }
-        Object.assign(this, this.oLanguageTag);
-        this.sLanguage = this.language;
-    },
-    getLanguage: function () {
-        return this.language;
-    },
-    getScript: function () {
-        return this.script;
-    },
-    getRegion: function () {
-        return this.region;
-    },
-    getVariant: function () {
-        return this.variant;
-    },
-    getVariantSubtags: function () {
-        return this.variantSubtags;
-    },
-    getExtension: function () {
-        return this.extension;
-    },
-    getExtensionSubtags: function () {
-        return this.extensionSubtags;
-    },
-    getPrivateUse: function () {
-        return this.privateUse;
-    },
-    getPrivateUseSubtags: function () {
-        return this.privateUseSubtags;
-    },
-    hasPrivateUseSubtag: function (sSubtag) {
-        assert(sSubtag && sSubtag.match(/^[0-9A-Z]{1,8}$/i), 'subtag must be a valid BCP47 private use tag');
-        return this.privateUseSubtags.indexOf(sSubtag) >= 0;
-    },
-    toString: function () {
-        return this.oLanguageTag.toString();
-    },
-    getSAPLogonLanguage: function () {
-        return Localization._getSAPLogonLanguage(this);
+/*!
+ * 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 locale object sap.ui.core.Locale
+import assert from "../../base/assert.js";
+import BaseObject from "../base/Object.js";
+import Localization from "../../base/i18n/Localization.js";
+import LanguageTag from "../../base/i18n/LanguageTag.js";
+var mCache = Object.create(null);
+
+/**
+ * Creates an instance of the Locale.
+ *
+ * @class Locale represents a locale setting, consisting of a language, script, region, variants, extensions and private use section.
+ *
+ * @param {string} sLocale the locale identifier, in format en-US or en_US.
+ *
+ * @extends sap.ui.base.Object
+ * @author SAP SE
+ * @version 1.120.3
+ * @public
+ * @alias sap.ui.core.Locale
+ */
+var Locale = BaseObject.extend("sap.ui.core.Locale", /** @lends sap.ui.core.Locale.prototype */{
+  constructor: function (vLocale) {
+    BaseObject.apply(this);
+    if (vLocale instanceof LanguageTag) {
+      this.oLanguageTag = vLocale;
+      this.sLocaleId = this.oLanguageTag.toString();
+    } else {
+      this.oLanguageTag = new LanguageTag(vLocale);
+      this.sLocaleId = vLocale;
     }
+    Object.assign(this, this.oLanguageTag);
+    this.sLanguage = this.language;
+  },
+  /**
+   * Get the locale language.
+   *
+   * Note that the case might differ from the original script tag
+   * (Lower case is enforced as recommended by BCP47/ISO639).
+   *
+   * @returns {string} the language code
+   * @public
+   */
+  getLanguage: function () {
+    return this.language;
+  },
+  /**
+   * Get the locale 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)
+   *
+   * @returns {string|null} the script code or <code>null</code>
+   * @public
+   */
+  getScript: function () {
+    return this.script;
+  },
+  /**
+   * Get the locale 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).
+   *
+   * @returns {string} the ISO3166-1 region code (2-letter or 3-digits)
+   * @public
+   */
+  getRegion: function () {
+    return this.region;
+  },
+  /**
+   * Get the locale variants as a single string or <code>null</code>.
+   *
+   * Multiple variants are separated by a dash '-'.
+   *
+   * @returns {string|null} the variant or <code>null</code>
+   * @public
+   */
+  getVariant: function () {
+    return this.variant;
+  },
+  /**
+   * Get the locale variants as an array of individual variants.
+   *
+   * The separating dashes are not part of the result.
+   * If there is no variant section in the locale tag, an empty array is returned.
+   *
+   * @returns {string[]} the individual variant sections
+   * @public
+   */
+  getVariantSubtags: function () {
+    return this.variantSubtags;
+  },
+  /**
+   * Get the locale 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.
+   *
+   * Use {@link #getExtensions} to get the individual extension tokens as an array.
+   *
+   * @returns {string|null} the extension or <code>null</code>
+   * @public
+   */
+  getExtension: function () {
+    return this.extension;
+  },
+  /**
+   * Get the locale 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 locale tag, an empty array is returned.
+   *
+   * @returns {string[]} the individual extension sections
+   * @public
+   */
+  getExtensionSubtags: function () {
+    return this.extensionSubtags;
+  },
+  /**
+   * Get the locale private use section or <code>null</code>.
+   *
+   * @returns {string} the private use section
+   * @public
+   */
+  getPrivateUse: function () {
+    return this.privateUse;
+  },
+  /**
+   * Get the locale 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 locale tag, an empty array is returned.
+   *
+   * @returns {string[]} the tokens of the private use section
+   * @public
+   */
+  getPrivateUseSubtags: function () {
+    return this.privateUseSubtags;
+  },
+  /**
+   * Check if a subtag is provided
+   *
+   * @param {string} sSubtag The subtag to check
+   * @returns {boolean} Wether the subtag is provided or not
+   */
+  hasPrivateUseSubtag: function (sSubtag) {
+    assert(sSubtag && sSubtag.match(/^[0-9A-Z]{1,8}$/i), "subtag must be a valid BCP47 private use tag");
+    return this.privateUseSubtags.indexOf(sSubtag) >= 0;
+  },
+  toString: function () {
+    return this.oLanguageTag.toString();
+  },
+  /**
+   * Best guess to get a proper SAP Logon Language for this locale.
+   *
+   * Conversions taken into account:
+   * <ul>
+   * <li>use the language part only</li>
+   * <li>convert old ISO639 codes to newer ones (e.g. 'iw' to 'he')</li>
+   * <li>for Chinese, map 'Traditional Chinese' or region 'TW' to SAP proprietary code 'zf'</li>
+   * <li>map private extensions x-saptrc, x-sappsd and saprigi to SAP pseudo languages '1Q', '2Q' and '3Q'</li>
+   * <li>remove ext. language sub tags</li>
+   * <li>convert to uppercase</li>
+   * </ul>
+   *
+   * Note that the conversion also returns a result for languages that are not
+   * supported by the default set of SAP languages. This method has no knowledge
+   * about the concrete languages of any given backend system.
+   *
+   * @returns {string} a language code that should
+   * @public
+   * @since 1.17.0
+   * @deprecated As of 1.44, use {@link sap.ui.core.Configuration#getSAPLogonLanguage} instead
+   *   as that class allows to configure an SAP Logon language.
+   */
+  getSAPLogonLanguage: function () {
+    return Localization._getSAPLogonLanguage(this);
+  }
 });
 Locale._getCoreLocale = function (oLocale) {
-    if (oLocale instanceof LanguageTag) {
-        oLocale = new Locale(oLocale);
-    }
-    return oLocale;
+  if (oLocale instanceof LanguageTag) {
+    oLocale = mCache[oLocale.toString()] || new Locale(oLocale);
+    mCache[oLocale.toString()] = oLocale;
+  }
+  return oLocale;
 };
 export default Locale;