Field Detail

• COPYRIGHT

  public static final java.lang.String COPYRIGHT
  

  IBM copyright notice field.

  See Also:

  Constant Field Values

• CURRENCY_ARGENTINA

  public static final java.lang.String CURRENCY_ARGENTINA
  

  CurrencyCode property for CURRENCY_ARGENTINA.

  See Also:

  Constant Field Values

• CURRENCY_AUSTRIA

  public static final java.lang.String CURRENCY_AUSTRIA
  

  CurrencyCode property for CURRENCY_AUSTRIA.

  See Also:

  Constant Field Values

• CURRENCY_AUSTRALIA

  public static final java.lang.String CURRENCY_AUSTRALIA
  

  CurrencyCode property for CURRENCY_AUSTRALIA.

  See Also:

  Constant Field Values

• CURRENCY_BELGIUM

  public static final java.lang.String CURRENCY_BELGIUM
  

  CurrencyCode property for CURRENCY_BELGIUM.

  See Also:

  Constant Field Values

• CURRENCY_BRAZIL

  public static final java.lang.String CURRENCY_BRAZIL
  

  CurrencyCode property for CURRENCY_BRAZIL.

  See Also:

  Constant Field Values

• CURRENCY_CANADA

  public static final java.lang.String CURRENCY_CANADA
  

  CurrencyCode property for CURRENCY_CANADA.

  See Also:

  Constant Field Values

• CURRENCY_CHINA

  public static final java.lang.String CURRENCY_CHINA
  

  CurrencyCode property for CURRENCY_CHINA.

  See Also:

  Constant Field Values

• CURRENCY_EURO

  public static final java.lang.String CURRENCY_EURO
  

  CurrencyCode property for CURRENCY_EURO.

  See Also:

  Constant Field Values

• CURRENCY_FINLAND

  public static final java.lang.String CURRENCY_FINLAND
  

  CurrencyCode property for CURRENCY_FINLAND.

  See Also:

  Constant Field Values

• CURRENCY_FRANCE

  public static final java.lang.String CURRENCY_FRANCE
  

  CurrencyCode property for CURRENCY_FRANCE.

  See Also:

  Constant Field Values

• CURRENCY_GERMANY

  public static final java.lang.String CURRENCY_GERMANY
  

  CurrencyCode property for CURRENCY_GERMANY.

  See Also:

  Constant Field Values

• CURRENCY_HONG_KONG

  public static final java.lang.String CURRENCY_HONG_KONG
  

  CurrencyCode property for CURRENCY_HONG_KONG.

  See Also:

  Constant Field Values

• CURRENCY_IRELAND

  public static final java.lang.String CURRENCY_IRELAND
  

  CurrencyCode property for CURRENCY_IRELAND.

  See Also:

  Constant Field Values

• CURRENCY_ITALY

  public static final java.lang.String CURRENCY_ITALY
  

  CurrencyCode property for CURRENCY_ITALY.

  See Also:

  Constant Field Values

• CURRENCY_JAPAN

  public static final java.lang.String CURRENCY_JAPAN
  

  CurrencyCode property for CURRENCY_JAPAN.

  See Also:

  Constant Field Values

• CURRENCY_SOUTH_KOREA

  public static final java.lang.String CURRENCY_SOUTH_KOREA
  

  CurrencyCode property for CURRENCY_SOUTH_KOREA.

  See Also:

  Constant Field Values

• CURRENCY_LUXEMBOURG

  public static final java.lang.String CURRENCY_LUXEMBOURG
  

  CurrencyCode property for CURRENCY_LUXEMBOURG.

  See Also:

  Constant Field Values

• CURRENCY_NETHERLANDS

  public static final java.lang.String CURRENCY_NETHERLANDS
  

  CurrencyCode property for CURRENCY_NETHERLANDS.

  See Also:

  Constant Field Values

• CURRENCY_PORTUGAL

  public static final java.lang.String CURRENCY_PORTUGAL
  

  CurrencyCode property for CURRENCY_PORTUGAL.

  See Also:

  Constant Field Values

• CURRENCY_SINGAPORE

  public static final java.lang.String CURRENCY_SINGAPORE
  

  CurrencyCode property for CURRENCY_SINGAPORE.

  See Also:

  Constant Field Values

• CURRENCY_SOUTH_AFRICA

  public static final java.lang.String CURRENCY_SOUTH_AFRICA
  

  CurrencyCode property for CURRENCY_SOUTH_AFRICA.

  See Also:

  Constant Field Values

• CURRENCY_SPAIN

  public static final java.lang.String CURRENCY_SPAIN
  

  CurrencyCode property for CURRENCY_SPAIN.

  See Also:

  Constant Field Values

• CURRENCY_SWITZERLAND

  public static final java.lang.String CURRENCY_SWITZERLAND
  

  CurrencyCode property for CURRENCY_SWITZERLAND.

  See Also:

  Constant Field Values

• CURRENCY_TAIWAN

  public static final java.lang.String CURRENCY_TAIWAN
  

  CurrencyCode property for CURRENCY_TAIWAN.

  See Also:

  Constant Field Values

• CURRENCY_UNITED_KINGDOM

  public static final java.lang.String CURRENCY_UNITED_KINGDOM
  

  CurrencyCode property for CURRENCY_UNITED_KINGDOM.

  See Also:

  Constant Field Values

• CURRENCY_UNITED_STATES

  public static final java.lang.String CURRENCY_UNITED_STATES
  

  CurrencyCode property for CURRENCY_UNITED_STATES.

  See Also:

  Constant Field Values

• CURRENCY_POLAND

  public static final java.lang.String CURRENCY_POLAND
  

  CurrencyCode property for CURRENCY_POLAND.

  See Also:

  Constant Field Values

• CURRENCY_RUSSIAN_FEDERATION

  public static final java.lang.String CURRENCY_RUSSIAN_FEDERATION
  

  CurrencyCode property for CURRENCY_RUSSIAN_FEDERATION.

  See Also:

  Constant Field Values

• CURRENCY_ROMANIA

  public static final java.lang.String CURRENCY_ROMANIA
  

  CurrencyCode property for CURRENCY_ROMANIA.

  See Also:

  Constant Field Values

• ISO_DATE_PATTERN

  public static final java.lang.String ISO_DATE_PATTERN
  

  ISO date format pattern. Value is yyyy-MM-dd

  See Also:

  Constant Field Values

• ISO_DATETIME_PATTERN

  public static final java.lang.String ISO_DATETIME_PATTERN
  

  ISO date time format pattern. Value is yyyy-MM-dd HH:mm:ss.SSS

  See Also:

  Constant Field Values

• LANGUAGE_EXTENSION_POINT_ID

  public static final java.lang.String LANGUAGE_EXTENSION_POINT_ID
  

  Unique identifier constant (value "com.ibm.commerce.telesales.g11n.languageSupport") for the language support extension.

  See Also:

  Constant Field Values

• ATT_ID

  public static final java.lang.String ATT_ID
  

  ID attribute name. Value is "id".

  See Also:

  Constant Field Values

• ATT_LOCALE_LANG

  public static final java.lang.String ATT_LOCALE_LANG
  

  Property element name. Value is "localeLang".

  See Also:

  Constant Field Values

• ATT_LANG_CODE

  public static final java.lang.String ATT_LANG_CODE
  

  Property element name. Value is "langCode".

  See Also:

  Constant Field Values

• ATT_COUNTRY_CODE

  public static final java.lang.String ATT_COUNTRY_CODE
  

  Property element name. Value is "countryCode".

  See Also:

  Constant Field Values

• ATT_COUNTRY_ID

  public static final java.lang.String ATT_COUNTRY_ID
  

  Property element name. Value is "countryId".

  See Also:

  Constant Field Values

Constructor Detail

• Globalization

  public Globalization()
  

Method Detail

• getLocale

  public static com.ibm.icu.util.ULocale getLocale()
  

  Returns the current locale.

  Returns:

  The current locale.

  See Also:

  Platform.getNL()

• getDisplayLanguages

  public static java.lang.String[] getDisplayLanguages()
  

  Returns a name for the languages for a locale that are appropriate for display to the user. If possible, the name returned will be localized according to the current locale. For example, if the locale is fr_FR and current locale is en_US, this method will return "French". If the locale is en_US and current locale is fr_FR, this method will return "anglais". If the name returned cannot be localized, (for example, a Japanese name for Croatian is unavailable), this function falls back to the default locale. That is the English name, and finally on the ISO code as a last-resort value. If the locale does not specify a language, this function returns the empty string.

  Returns:

  The languages that are appropriate for display to the user.

• getLanguageCode

  public static int getLanguageCode(java.lang.String language)
  

  Returns the internal Commerce language code (for example, -2 for French) that is associated with a language name.

  The following are the values corresponding to the table:

   Code  Language
   ----  ----------
     -1  ENGLISH_US
     -2  FRENCH
     -3  GERMAN
     -4  ITALIAN
     -5  SPANISH
     -6  PORTUGUESE_BRAZIL
     -7  SIMPLIFIED_CHINESE
     -8  TRADITIONAL_CHINESE
     -9  KOREAN
    -10  JAPANESE
   
  

  Parameters:

  language - The language name (for example, Japanese).

  Returns:

  The WebSphere Commerce language code.

• getLanguageId

  public static java.lang.String getLanguageId(java.lang.String localeString)
  

  Returns the internal WebSphere Commerce language ID associated with a language name.

  Parameters:

  localeString - The locale string.

  Returns:

  The WebSphere Commerce language ID. Note: currently, WebSphere Commerce supports 13 languages. This method uses the country of the locale to map to the appropriate WebSphere Commerce string representation. For example, for the English language, this method uses the "US" in the "en_US" portion of the locale to return a String value of "-1". This is the value in the WC LANGUAGE database table. The "en" language portion of the locale is used only if the country is not found because some languages are listed multiple times. (For example, zh_CN and zh_TW ).

• getDisplayLanguageName

  public static java.lang.String getDisplayLanguageName(java.lang.String localeCode)
  

  Returns a language name to display for the language of the locale that is appropriate to display to the user.

  Parameters:

  localeCode - The locale's code (for example, fr_FR is the locale for French-France).

  Returns:

  The language name that is appropriate to display to the user.

• getDisplayLanguage

  public static java.lang.String getDisplayLanguage(int code)
  

  Returns a name for the language of the code that is appropriate to display to the user.

  Parameters:

  code - Internal WebSphere Commerce language code.

  Returns:

  The language name that is appropriate for display to the user.

• getDisplayLanguage

  public static java.lang.String getDisplayLanguage(java.lang.String code)
  

  Returns a name for the language of the code that is appropriate to display to the user.

  Parameters:

  code - An internal WebSphere Commerce language code.

  Returns:

  The language name that is appropriate to display to the user, or an empty string if there is no language for the code.

• getLanguages

  public static java.util.Map getLanguages()
  

  Returns all available languages.

  Returns:

  The available languages.

• getDisplayCurrencyCodes

  public static java.lang.String[] getDisplayCurrencyCodes()
  

  Returns an array of translated currency codes.

  Returns:

  The translated currency codes.

• getDisplayCountryNames

  public static java.lang.String[] getDisplayCountryNames()
  

  Returns an array of translated country names.

  Returns:

  The translated country names.

• formatCurrency

  public static java.lang.String formatCurrency(java.lang.String currencyCode,
                                java.math.BigDecimal amount)
  

  Formats the currency amount to the requested locale (currency code).

  Parameters:

  currencyCode - The ISO 4217 code of the currency.

  amount - The amount to format.

  Returns:

  The formatted amount.

  See Also:

  formatCurrency(String, BigDecimal, boolean)

• formatCurrency

  public static java.lang.String formatCurrency(java.lang.String currencyCode,
                                java.math.BigDecimal amount,
                                boolean symbol)
  

  Formats the currency amount to the requested locale (currency code).

  Parameters:

  currencyCode - The ISO 4217 code of the currency.

  amount - The amount to format.

  symbol - The value true, includes the symbol; the value false removes the symbol.

  Returns:

  The formatted amount.

• formatPercentage

  public static java.lang.String formatPercentage(java.math.BigDecimal amount)
  

  Formats the Percentage amount to the default locale.

  Parameters:

  amount - The amount to format.

  Returns:

  The formatted amount.

• formatPercentageWithDecimal

  public static java.lang.String formatPercentageWithDecimal(java.math.BigDecimal amount)
  

  Formats the Percentage amount to the default locale.

  Parameters:

  amount - The amount to format.

  Returns:

  formatted amount

• formatPercentageWithDecimal

  public static java.lang.String formatPercentageWithDecimal(java.math.BigDecimal amount,
                                             boolean symbol)
  

  Formats the Percentage amount to the default locale with 2 decimal

  Parameters:

  amount - The amount to format.

  symbol - The value true, includes the symbol; the value false removes the symbol

  Returns:

  The formatted amount.

• formatPercentage

  public static java.lang.String formatPercentage(java.math.BigDecimal amount,
                                  boolean symbol)
  

  Formats the Percentage amount to the default locale.

  Parameters:

  amount - The amount to format.

  symbol - The value true, includes the symbol; the value false removes the symbol

  Returns:

  formatted amount

• removePercentageSymbol

  public static java.lang.String removePercentageSymbol(java.lang.String value)
  

  Remove percentage symbol from value

  Parameters:

  value - the percentage value

  Returns:

  value with removed

• revertPercentage

  public static java.math.BigDecimal revertPercentage(java.lang.String formattedValue)
  

  Converts the formatted percentage value to the original double amount.

  Parameters:

  formattedValue - The formatted value to be reverted.

  Returns:

  The formatted amount as BigDecimal.

• revertCurrency

  public static java.math.BigDecimal revertCurrency(java.lang.String formattedValue,
                                    java.lang.String currencyCode)
                                             throws java.text.ParseException
  

  Convenience method to convert the formatted currency value to the original amount.

  Parameters:

  formattedValue - Formatted currency value

  currencyCode - Currency code of the formatted currency value

  Returns:

  Amount without any format.

  Throws:

  java.text.ParseException - This is thrown when unable to read given input.

• revertCurrency

  public static java.math.BigDecimal revertCurrency(java.lang.String formattedValue)
                                             throws java.text.ParseException
  

  Convenience method to convert the formatted currency value to the original double amount. Use this method only if the currency code is not available. Use the method revertCurrency(formattedValue, currrencyCode) if currency code is available.

  Parameters:

  formattedValue - The formatted currency value.

  Returns:

  The double amount.

  Throws:

  java.text.ParseException - This is thrown when unable to read given input.

• formatISODate

  public static java.lang.String formatISODate(java.lang.String isoDate)
  

  Formats an ISO date into a ULocale specific date string, using client locale and DateFormat.SHORT format.

  Parameters:

  isoDate - The ISO formatted date.

  Returns:

  The formatted date.

  See Also:

  formatToISODateTime(String), formatISODate(String, int)

• formatISODate

  public static java.lang.String formatISODate(java.lang.String isoDate,
                               int dateStyle)
  

  Formats an ISO date into a ULocale specific date string.

  Parameters:

  isoDate - The ISO formatted date.

  dateStyle - The given date formatting style. For example, SHORT for "M/d/yy" in the US locale.

  Returns:

  The formatted date.

  See Also:

  formatToISODateTime(String, ULocale, int, String), formatISODate(String, ULocale, int, String)

• formatISODate

  public static java.lang.String formatISODate(java.lang.String isoDate,
                               com.ibm.icu.util.ULocale locale,
                               int dateStyle,
                               java.lang.String pattern)
  

  Formats a ULocale specific date into an ISO date string.

  Parameters:

  isoDate - The ULocale formatted date.

  locale - The locale of the input date.

  dateStyle - The given date formatting style. For example, SHORT for "M/d/yy" in the US locale.

  pattern - The pattern of the output date string.

  Returns:

  The ISO formatted date and time, or the original date string if it cannot be parsed.

  See Also:

  formatISODate(String, int)

• formatISODateTime

  public static java.lang.String formatISODateTime(java.lang.String isoDateTime)
  

  Formats an ISO date into a ULocale specific date string using client locale and DateFormat.SHORT format.

  Parameters:

  isoDateTime - The ISO formatted date.

  Returns:

  The formatted date.

  See Also:

  formatToISODateTime(String)

• formatISODateTime

  public static java.lang.String formatISODateTime(java.util.Date date)
  

  Formats a java.util.Date object into a ULocale specific date string using client locale and DateFormat.SHORT format.

  Parameters:

  date - The java.util.Date.

  Returns:

  The formatted date.

  See Also:

  formatToISODateTime(String)

• formatISODateTime

  public static java.lang.String formatISODateTime(java.lang.String isoDateTime,
                                   int dateStyle,
                                   int timeStyle)
  

  Formats an ISO date into a ULocale specific date and time string.

  Parameters:

  isoDateTime - The ISO formatted date.

  dateStyle - The given date formatting style. For example, SHORT for "M/d/yy" in the US locale.

  timeStyle - The given time formatting style. For example, SHORT for "h:mm a" in the US locale.

  Returns:

  The formatted date and time.

  See Also:

  formatToISODateTime(String, ULocale, int, String), formatISODateTime(String, ULocale, int, int, String)

• formatISODateTime

  public static java.lang.String formatISODateTime(java.lang.String isoDateTime,
                                   com.ibm.icu.util.ULocale locale,
                                   int dateStyle,
                                   int timeStyle,
                                   java.lang.String pattern)
  

  Formats a ULocale specific date into an ISO date string.

  Parameters:

  isoDateTime - The ULocale formatted date.

  locale - The locale of the input date.

  dateStyle - The given date formatting style. For example, SHORT for "M/d/yy" in the US locale.

  timeStyle - The given time formatting style. For example, SHORT for "h:mm a" in the US locale.

  pattern - The pattern of the output date string.

  Returns:

  The ISO formatted date and time, or the original date string if it cannot be parsed

  See Also:

  formatISODate(String, int)

• formatToISODate

  public static java.lang.String formatToISODate(java.lang.String date)
  

  Formats a ULocale specific date into an ISO date string, using client locale and DateFormat.SHORT style.

  Parameters:

  date - The Locale formatted date.

  Returns:

  The ISO formatted date, or null if the input string cannot be parsed.

  See Also:

  formatISODate(String, int), formatToISODateTime(String, ULocale, int, String)

• formatToISODateTime

  public static java.lang.String formatToISODateTime(java.lang.String dateTime)
  

  Formats a ULocale specific date into an ISO date/time string, using client locale and DateFormat.SHORT style.

  Parameters:

  dateTime - the ULocale formatted date

  Returns:

  The ISO formatted date and time, or null if the input string cannot be parsed.

  See Also:

  formatISODateTime(String), formatToISODateTime(String, ULocale, int, String)

• formatToISODateTime

  public static java.lang.String formatToISODateTime(java.lang.String date,
                                     com.ibm.icu.util.ULocale locale,
                                     int style,
                                     java.lang.String pattern)
  

  Formats a Locale specific date into an ISO date string.

  Parameters:

  date - The ULocale formatted date.

  locale - The locale of the input date.

  style - The given formatting style of the output date string. For example, DateFormat.SHORT for "M/d/yy" in the US locale.

  pattern - The pattern of the output date string.

  Returns:

  The ISO formatted date and time, or the original date string if it cannot be parsed.

  See Also:

  formatISODate(String, int)

• parseLocaleDateTime

  public static java.util.Date parseLocaleDateTime(java.lang.String date)
  

  Parses a String into a java.util.Date object.

  Parameters:

  date - The ULocale formatted date.

  Returns:

  A java.util.Date object if it can be parsed, or a null if not.

  See Also:

  formatISODate(String, int)

• parseLocaleDate

  public static java.util.Date parseLocaleDate(java.lang.String date)
  

  Parses a String into a java.util.Date object.

  Parameters:

  date - The ULocale formatted date.

  Returns:

  A java.util.Date object if it can be parsed, or a null if not.

  See Also:

  formatISODate(String, int)

• parseISODateTime

  public static java.util.Date parseISODateTime(java.lang.String date)
  

  Parses a String into a java.util.Date object.

  Parameters:

  date - The ISO formatted date time string.

  Returns:

  A java.util.Date object if it can be parsed, or a null if not.

  See Also:

  formatISODate(String, int)

• parseISODate

  public static java.util.Date parseISODate(java.lang.String date)
  

  Parses a String into a java.util.Date object.

  Parameters:

  date - The ISO formatted date.

  Returns:

  A java.util.Date object if it can be parsed, or a null if not.

  See Also:

  formatISODate(String, int)