Class L10NManager

java.lang.Object
com.codename1.l10n.L10NManager
public class L10NManager extends Object

The localization manager allows adapting values for display in different locales thru parsing and formatting capabilities (similar to JavaSE's DateFormat/NumberFormat). It also includes language/locale/currency related API's similar to Locale/currency API's from JavaSE.

The sample code below just lists the various capabilities of the API:

Form hi = new Form("L10N", new TableLayout(16, 2));
L10NManager l10n = L10NManager.getInstance();
hi.add("format(double)").add(l10n.format(11.11)).
    add("format(int)").add(l10n.format(33)).
    add("formatCurrency").add(l10n.formatCurrency(53.267)).
    add("formatDateLongStyle").add(l10n.formatDateLongStyle(new Date())).
    add("formatDateShortStyle").add(l10n.formatDateShortStyle(new Date())).
    add("formatDateTime").add(l10n.formatDateTime(new Date())).
    add("formatDateTimeMedium").add(l10n.formatDateTimeMedium(new Date())).
    add("formatDateTimeShort").add(l10n.formatDateTimeShort(new Date())).
    add("getCurrencySymbol").add(l10n.getCurrencySymbol()).
    add("getLanguage").add(l10n.getLanguage()).
    add("getLocale").add(l10n.getLocale()).
    add("isRTLLocale").add("" + l10n.isRTLLocale()).
    add("parseCurrency").add(l10n.formatCurrency(l10n.parseCurrency("33.77$"))).
    add("parseDouble").add(l10n.format(l10n.parseDouble("34.35"))).
    add("parseInt").add(l10n.format(l10n.parseInt("56"))).
    add("parseLong").add("" + l10n.parseLong("4444444"));
hi.show();

  • Constructor Details

    • L10NManager

      protected L10NManager(String language, String locale)
      Instances of this class should be received via the Display class

  • Method Details

    • getInstance

      public static L10NManager getInstance()

      Convenience method that invokes Display.getLocalizationManager()

      Returns

      the L10NManager instance

    • getLanguage

      public String getLanguage()

      Returns the current locale language as an ISO 639 two letter code

      Returns

      iso language string

    • setLocale

      public void setLocale(String locale, String language)

      Forces the locale/language

      Parameters

      • locale: the new locale

      • language: the language to use

    • format

      public String format(int number)

      Format an integer number for this locale

      Parameters
      • number: the number to format
      Returns

      a string representation of a number

    • format

      public String format(double number)

      Format a double number for this locale

      Parameters
      • number: the number to format
      Returns

      a string representation of a number

    • getShortMonthName

      public String getShortMonthName(Date date)

      Gets the short month name in the current locale for the given date.

      Parameters
      • date: The date.
      Returns

      Short month name. E.g. Jan, Feb, etc..

      Since

      7.0

    • getLongMonthName

      public String getLongMonthName(Date date)

      Gets the long month name in the current locale for the given date.

      Parameters
      • date: The date.
      Returns

      Long month name. E.g. January, February, etc..

      Since

      7.0

    • formatCurrency

      public String formatCurrency(double currency)

      Format a currency value

      Parameters
      • currency: the monetary value
      Returns

      a string representation of a number

    • getCurrencySymbol

      public String getCurrencySymbol()

      Returns the currency symbol for this locale

      Returns

      currency symbol

    • formatDateLongStyle

      public String formatDateLongStyle(Date d)

      Formats a date in a long form e.g. Sunday January 1st 2001

      Parameters
      • d: the date
      Returns

      the long form string

    • formatDateShortStyle

      public String formatDateShortStyle(Date d)

      Formats a date in a short form e.g. 1/1/2011

      Parameters
      • d: the date
      Returns

      the short form string

    • formatDateTime

      public String formatDateTime(Date d)

      Formats a date and a time in a default form e.g. 1/1/2011 10:00AM

      Parameters
      • d: the date
      Returns

      the date and time

    • formatDateTimeMedium

      public String formatDateTimeMedium(Date d)

      Formats a date and a time in a default form e.g. 1/1/2011 10:00AM

      Parameters
      • d: the date
      Returns

      the date and time

    • formatTime

      public String formatTime(Date d)

      Formats the time in a default form e.g. 10:00AM

      Parameters
      • d: the date time object
      Returns

      the time as a String

    • formatDateTimeShort

      public String formatDateTimeShort(Date d)

      Formats a date and a time in a default form e.g. 1/1/2011 10:00AM

      Parameters
      • d: the date
      Returns

      the date and time

    • isRTLLocale

      public boolean isRTLLocale()

      Indicates whether the language is a right to left language

      Returns

      true for bidi/rtl languages

    • getLocale

      public String getLocale()

      Determines the locale (location) as an ISO 3166 country code

      Returns

      the locale

    • format

      public String format(double number, int decimalPlaces)

      Formats a number as a String with a fixed number of decimal places

      Parameters

      • number: the number

      • decimalPlaces: decimals

      Returns

      formatted string

    • parseDouble

      public double parseDouble(String localeFormattedDecimal)

      Parses a double based on locale conventions

      Parameters
      • localeFormattedDecimal: the locale formatted number
      Returns

      the parsed double

    • parseLong

      public long parseLong(String localeFormattedLong)

      Parses a long based on locale conventions

      Parameters
      • localeFormattedLong: the number
      Returns

      a long

    • parseInt

      public int parseInt(String localeFormattedInteger)

      Parses an integer based on locale conventions

      Parameters
      • localeFormattedInteger: the number
      Returns

      a parsed number

    • parseCurrency

      public double parseCurrency(String amount)

      Parses the currency value

      Parameters
      • amount: the amount
      Returns

      a numeric value for the currency