B4A Library AHLocale library

With this library you can convert dates, timestamps, numbers and normal texts to the format your device uses. You can even translate your apps to different languages.

The AHLocale object provides many information about your devices locale settings like Currency symbol, month names, weekday names etc.

The AHTranslator object provides methods for creating multilanguage apps.

The AHDateTime object provides methods for formatting and parsing date strings. The internal DateTime object of B4A has the problem that it uses localized format identifier so it is not possible to parse a date string in the format "2011/05/19 12:15 AM" on a german device because the "AM" is "vorm." on it. With the AHDateTime object you can parse and format dates in any locale.

The AHTimeZone object provides methods to get information about timezones (like offset to UTC, DST offset etc.)

The AHDateUtils object provides methods to format dates and date ranges and display them localized.

The AHNumeric object provides methods to handle different (localized) number formats.

The example app starts always in english. Translation files for german, italian and japanese are provided. Try to select another language with the topmost spinner and see how the language of the user interface changes.

AHLocale
Author: Markus Stipp
Version: 1.16

• AHDateTime
  Fields:
  • DEFAULT As Int
  • FULL As Int
  • LONG As Int
  • MEDIUM As Int
  • SHORT As Int
  Methods:
  • Format (ticks As Long) As String
    Formats the specified ticks value to a string with the specified pattern.
  • GetDefaultDatePattern (Style As Int) As String
    Gets the default DatePattern of the device default locale
    
    Style - Use constants SHORT, MEDIUM, LONG, FULL, DEFAULT
  • GetDefaultDatePattern2 (Style As Int, Locale As AHLocale) As String
    Gets the default DatePattern of given locale
    
    Style - Use constants SHORT, MEDIUM, LONG, FULL, DEFAULT
    Locale - Reference to an AHLocale object
  • GetDefaultDateTimePattern (DateStyle As Int, TimeStyle As Int) As String
    Gets the device default DateTimePattern
    
    DateStyle - Style for Date
    TimeStyle - Style for Time
  • GetDefaultDateTimePattern2 (DateStyle As Int, TimeStyle As Int, Locale As AHLocale) As String
    Gets the DateTimePattern for the given Locale
    
    DateStyle - Style for Date
    TimeStyle - Style for Time
  • GetDefaultTimePattern (Style As Int) As String
    Gets the default TimePattern of the device default locale
    
    Style - Use constants SHORT, MEDIUM, LONG, FULL, DEFAULT
  • GetDefaultTimePattern2 (Style As Int, Locale As AHLocale) As String
    Gets the default TimePattern of given locale
    
    Style - Use constants SHORT, MEDIUM, LONG, FULL, DEFAULT
    Locale - Reference to an AHLocale object
  • GetShortDatePatternWithoutYear As String
    Return a short date pattern without year information
  • Initialize
    Initializes the AHDateTime object with the default locale.
  • Initialize2 (locale As AHLocale)
    Initializes the AHDateTime object with the given AHLocale object
  • InitializeUS
    Initializes the AHDateTime object with the <strong>en_US</strong> locale.
  • Parse (date As String) As Long
    Parses the specified string and returns a tick value.
    
    Throws an exception if the string can not be parsed.
  • is24HourFormat As Boolean
    Returns true if the user preference settings is 24 hour format.
  Properties:
  • Lenient As Boolean
    If you set this to true the parser is not very strict on his date format.
  • Pattern As String
    Sets or gets the Date/Time pattern
    
    Default pattern is: <strong>yyyy-MM-dd HH:mm:ss</strong>
    
    For allowed placeholders look here: <link>SimpleDateFormat|http://developer.android.com/reference/java/text/SimpleDateFormat.html</link>
  • TimeZone As AHTimezone
    Sets or gets the timezone for the AHDateTime object
• AHDateUtils
  Fields:
  • FORMAT_12HOUR As Int
  • FORMAT_24HOUR As Int
  • FORMAT_ABBREV_ALL As Int
  • FORMAT_ABBREV_MONTH As Int
  • FORMAT_ABBREV_RELIVE As Int
  • FORMAT_ABBREV_TIME As Int
  • FORMAT_ABBREV_WEEKDAY As Int
  • FORMAT_CAP_AMPM As Int
  • FORMAT_CAP_MIDNIGHT As Int
  • FORMAT_CAP_NOON As Int
  • FORMAT_CAP_NOON_MIDNIGHT As Int
  • FORMAT_NO_MIDNIGHT As Int
  • FORMAT_NO_MONTH_DAY As Int
  • FORMAT_NO_NOON As Int
  • FORMAT_NO_NOON_MIDNIGHT As Int
  • FORMAT_NO_YEAR As Int
  • FORMAT_NUMERIC_DATE As Int
  • FORMAT_SHOW_DATE As Int
  • FORMAT_SHOW_TIME As Int
  • FORMAT_SHOW_WEEKDAY As Int
  • FORMAT_SHOW_YEAR As Int
  • FORMAT_UTC As Int
  • LENGTH_LONG As Int
  • LENGTH_MEDIUM As Int
  • LENGTH_SHORT As Int
  • LENGTH_SHORTER As Int
  • LENGTH_SHORTEST As Int
  Methods:
  • FormatDateRange (StartTicks As Long, EndTicks As Long, Flags As Int) As String
    Formats a date or a time range according to the local conventions.
    
    Note that this is a convenience method. Using it involves creating an
    internal Formatter instance on-the-fly, which is somewhat costly in terms
    of memory and time.
    
    StartTicks - start time
    EndTicks - end time
    Flags - a bit mask of options
  • FormatDateTime (Ticks As Long, Flags As Int) As String
    Formats a date or a time according to the local conventions. There are
    lots of options that allow the caller to control, for example, if the
    time is shown, if the day of the week is shown, if the month name is
    abbreviated, if noon is shown instead of 12pm, and so on.
    
    Ticks - time/date to format
    Flags - a bit mask of options
  • FormatElapsedTime (Seconds As Long) As String
    Formats an elapsed time in the form "MM:SS" or "H:MM:SS" for display on
    the call-in-progress screen.
    
    Seconds - the elapsed time in seconds.
  • GetRelativeDateTimeString (Ticks As Long, MinResolution As Long, TransitionResolution As Long, Flags As Int) As CharSequence
    Return string describing the elapsed time since startTime formatted like
    "[relative time/date], [time]".
    
    <b>Ticks</b> - some time in the past.
    
    <b>MinResolution</b> - the minimum elapsed time (in milliseconds) to
    report when showing relative times. For example, a time 3 seconds in the
    past will be reported as "0 minutes ago" if this is set to
    MINUTE_IN_MILLIS.
    
    <b>TransitionResolution</b> - the elapsed time (in milliseconds) at which
    to stop reporting relative measurements. Elapsed times greater than this
    resolution will default to normal date formatting. For example, will
    transition from "6 days ago" to "Dec 12" when using WEEK_IN_MILLIS.
    
    <b>Flags</b> - a bit mask of options
  • GetRelativeTimeSpanString (Ticks As Long, Now As Long, MinResolution As Long, Flags As Int) As CharSequence
    Returns a string describing 'time' as a time relative to 'now'.
    
    Time spans in the past are formatted like "42 minutes ago". Time spans in
    the future are formatted like "in 42 minutes". Can use
    FORMAT_ABBREV_RELATIVE flag to use abbreviated relative times, like
    "42 mins ago".
    
    <b>Ticks</b> - the time to describe, in milliseconds
    
    <b>Now</b> - the current time in
    milliseconds
    
    <b>MinResolution</b> - the minimum timespan to report. For example,
    a time 3 seconds in the past will be reported as "0 minutes ago" if this
    is set to MINUTE_IN_MILLIS. Pass one of 0, MINUTE_IN_MILLIS,
    HOUR_IN_MILLIS, DAY_IN_MILLIS, WEEK_IN_MILLIS
    
    <b>Flags</b> - a bit mask of
    formatting options, such as FORMAT_NUMERIC_DATE or FORMAT_ABBREV_RELATIVE
  • IsToday (Ticks As Long) As Boolean
    Returns true if the supplied Ticks value is today else false
• AHLocale
  Methods:
  • Initialize
    Initializes the AHLocale object with the default locale.
  • Initialize2 (language As String)
    Initializes the AHLocale object using the specified language.
  • Initialize3 (language As String, country As String)
    Initializes the AHLocale object using the specified language and country.
  • InitializeUS
    Initializes the AHLocale Object with <strong>en_US</strong> locale. This locale is
    available on every device.
  Properties:
  • AmPmStrings() As String [read only]
    Returns the array of strings which represent AM and PM.
  • AvailableLocales As List [read only]
    Returns the system's installed locales. These are returned as a B4A List of AHLocale Objects.
    There are only locales in this list which have a non empty country and language.
  • Country As String [read only]
    Returns the country/region code for this locale, which will either be the
    empty string or an uppercase ISO 3166 2-letter code.
  • CurrencyCode As String [read only]
    Returns this currency's ISO 4217 currency code.
  • CurrencyFractionDigits As Int [read only]
    Returns the default number of fraction digits for this currency.
  • CurrencySymbol As String [read only]
    Returns the localized currency symbol for this currency in locale.
  • DisplayCountry As String [read only]
    Returns the name of this locale's country, localized to locale. Returns
    the empty string if this locale does not correspond to a specific country
  • DisplayLanguage As String [read only]
    Returns the name of this locale's language, localized to locale. If the
    language name is unknown, the language code is returned.
  • DisplayName As String [read only]
    Returns this locale's language name, country name, and variant, localized
    to locale. The exact output form depends on whether this locale
    corresponds to a specific language, country and variant, such as:
    English, English (United States), English (United States,Computer),
    anglais (?tats-Unis), anglais (?tats-Unis,informatique).
  • EnglishCountry As String [read only]
    Returns the name of this locale's country in english. Returns
    the empty string if this locale does not correspond to a specific country
  • EnglishLanguage As String [read only]
    Returns the name of this locale's language in english. If the
    language name is unknown, the language code is returned.
  • EnglishName As String [read only]
    Returns this locale's language name, country name, and variant in english.
    The exact output form depends on whether this locale
    corresponds to a specific language, country and variant, such as:
    English, English (United States), English (United States,Computer),
    anglais (?tats-Unis), anglais (?tats-Unis,informatique).
  • FirstDayOfWeek As Int [read only]
    Gets the first day of the week
  • ISO3Country As String [read only]
    Gets the three letter ISO country code which corresponds to the country
    code for this Locale.
  • ISO3Language As String [read only]
    Gets the three letter ISO language code which corresponds to the language
    code for this Locale.
  • ISOCode As String [read only]
    Returns the ISO Code for this Locale such as <strong>en_US</strong> or <strong>de_DE</strong>
  • ISOCountries() As String [read only]
    Gets the list of two letter ISO country codes which can be used as the
    country code for a Locale.
  • ISOLanguages() As String [read only]
    Gets the list of two letter ISO language codes which can be used as the
    language code for a Locale.
  • Initialized As Boolean [read only]
    Returns if the object is initialized
  • Language As String [read only]
    Gets the language code for this Locale or the empty string if no language
    was set.
  • Months() As String [read only]
    Returns the array of strings containing the full names of the months.
  • ShortMonths() As String [read only]
    Returns the array of strings containing the abbreviated names of the months.
  • ShortWeekDays() As String [read only]
    Returns the array of strings containing the abbreviated names of the days of the week.
  • WeekDays() As String [read only]
    Returns the array of strings containing the full names of the days of the week.
• AHNumeric
  Methods:
  • Format (Value As Double) As String
    Format the number to a string using the pattern and rules of this object.
  • Initialize
    Initializes a standard NumberFormat object with the standard locale
  • Initialize2 (Locale As AHLocale)
    Initializes a standard NumberFormat object with the given locale.
  • InitializeCurrency
    Initializes a currency NumberFormat object with the standard locale
  • InitializeCurrency2 (Locale As AHLocale)
    Initializes a currency NumberFormat object with the given locale.
  • InitializeInteger
    Initializes an integer NumberFormat object with the standard locale
  • InitializeInteger2 (Locale As AHLocale)
    Initializes an integer NumberFormat object with the given locale.
  • InitializeNumber
    Initializes a standard NumberFormat object with the standard locale
  • InitializeNumber2 (Locale As AHLocale)
    Initializes a standard NumberFormat object with the given locale.
  • InitializePercent
    Initializes a percent NumberFormat object with the standard locale
  • InitializePercent2 (Locale As AHLocale)
    Initializes a percent NumberFormat object with the given locale.
  • Parse (Value As String) As Number
    Parse the given string and convert it to a number. This may throw a
    ParseException if the format of the string is not correct.
  Properties:
  • MaximumFractionDigits As Int
    Set or get the maximum fraction digits.
  • MaximumIntegerDigits As Int
    Set or get the maximum integer digits.
  • MinimumFractionDigits As Int
    Set or get the minimum fraction digits.
  • MinimumIntegerDigits As Int
    Set or get the minimum integer digits
  • Pattern As String
    Set or get the pattern that is used for formatting and parsing.
• AHTimeZone
  Fields:
  • STYLE_LONG As Int
  • STYLE_SHORT As Int
  Methods:
  • GetDisplayName (DaylightTime As Boolean, Style As Int) As String
    Returns the Display name of this timezone
    
    DaylightTime - Set to true if you want to have DST included into the name
    Style - AHTimeZone.SHORT or AHTimeZone.LONG format
  • GetDisplayName2 (DaylightTime As Boolean, Style As Int, Locale As AHLocale) As String
    Returns the Display name of this timezone
    
    DaylightTime - Set to true if you want to have DST included into the name
    Style - AHTimeZone.SHORT or AHTimeZone.LONG format
    Locale - a AHLocale object to set in which language you want the displayname
  • GetOffset (Date As Long) As Long
    Returns the offset in milliseconds from UTC for this time zone at time.
    The offset includes daylight savings time if the specified date is within the daylight savings time period.
    
    Date - Date for which you want to have the info
  • InDaylightTime (Date As Long) As Boolean
    Returns true if Date is in a daylight savings time period for this time zone.
    
    Date - Date for which you want to get the info
  • Initialize
    Initialize a AHTimeZone object with default timezone
  • Initialize2 (ID As String)
    Initializes a AHTimeZone object with the given TimeZone ID
    
    ID - TimeZone ID like "Europe/Berlin"
  Properties:
  • AvailableIds As List [read only]
    Returns a list of available timezone IDs on this device.
    One of the results can be passed to the Initialize2() Method to reinitialize
    an AHTimeZone object with a different timezone
  • DSTSavings As Long [read only]
    Returns the daylight savings offset in milliseconds for this time zone.
    The base implementation returns 3600000 (1 hour) for time zones that use daylight savings
    time and 0 for timezones that do not.
    Note that this method doesn't tell you whether or not to apply the offset: you need to call
    InDaylightTime() for the specific time you're interested in. If this method returns a non-zero
    offset, that only tells you that this TimeZone sometimes observes daylight savings.
  • ID As String
    Gets or sets the timezone ID as String for this timezone
  • RawOffset As Long
    Sets or gets the Raw offset for this timezone
• AHTranslator
  Methods:
  • GetText (text As String) As String
    Searches for the text in the translation table. If a translation is
    available it will be returned. If no translation is available the text is
    added to the missing translation table and the original text is returned.
    So you can write your whole program in a default language. If a
    translation is available it will be used, if not, the text will be
    returned in the default language.
  • GetText2 (text As String, params As List) As String
    Searches for the text in the translation table and returns the translated
    text.
    
    You can use Placeholders in the form of {1} {2} etc. which will be
    replaced with the content of the second parameter. {1} will be replaced
    with the first item in the Array/List, {2} with the second one and so on.
  • Initialize (dir As String, basename As String)
    Initializes a translation object with the device language. Tries to read a
    translation file with the following name convention: basename_language.lng
  • Initialize2 (dir As String, basename As String, language As String)
    Initializes a translation object with the given language. Tries to read a
    translation file with the following name convention: basename_language.lng
  • Initialize3 (dir As String, basename As String, language As String, country As String)
    Initializes a translation object with the given language and country code.
    Tries to read a translation file with the following name
    convention: basename_language_country.lng
  • WriteTranslation (dir As String, filename As String)
    Writes two files to the specified dir. The current translation Map is
    written to [filename]_[language].lng and the missing translation Map is
    written to [filename]_miss_[language].lng
  Properties:
  • CurrentCountry As String [read only]
    Returns the current County code
  • CurrentFile As String [read only]
    Returns current file name of language file
  • CurrentLanguage As String [read only]
    Returns current Language code
  • DefaultLanguage As String
    Sets or gets the default language. This is the language used when no language file is found.
    If you don't set it the default language will be empty and is not used.
  • Extension As String
    Sets or gets the current file extension
  • MissingTranslationMap As Map [read only]
    Returns a Map object with all text phrases which are missing in the
    translation file.
  • TranslationMap As Map
    Returns a Map object with the current translations

History:
V1.1:

• fixed Documentation
• fixed some bugs (DisplayXXX methods)
• new AHDateTime object
• some minor improvements

V1.11:

• fixed problem with AvailableLocales not working on all devices

V1.12:

• new AHTimeZone object to get information from timezones

V1.13: (never released)

• Add TimeZone property to AHDateTime object

V1.14:

• AHTranslator.java - Removed log output
• Timezone.java - fixed type

V1.15:

• AHDateUtils object - new
• AHNumeric object - new

V1.16:

• AHDateTime - Methods for getting default date and time format strings
• AHTranslation - Support for Countries
• AHTranslation - Support for default language
• AHTranslation - Support for different file extensions

 

[corwin42]

Another problem (that I solved in the above code) is the encoding. ReadMap does not seem to support UTF-8.

Yes, the files are standard Java porperties files and they are ISO encoded and not UTF. Special characters have to be written with the unicode code.

 

[Roger C]

Great library.

Just for your information, when initialized with

locale.Initialize3("sv","SE")

the code

ticks2 = dt.Parse("5/19/11 12:45 AM Local Time") 'This is not possible with B4A DateTime object on a german device

...does not work in Sweden.

 

[lorebarita]

How can I localize images using this library?

 

[corwin42]

Add your images to the files folder with localized endings (xxx_en.png, xxx_de.png, xxx_it.png, xxx_es.png etc)

Initialize a AHLocale object with current locale of the system and load the file with the correct ending:

Dim loc As AHLocale
Dim localizedFileName As String

loc.Initialize
 
localizedFileName = "flag_" & loc.Language & ".png"
 
If File.Exists(File.DirAssets, localizedFileName) Then
    'You can load the flag here to an imageview
    Log("Flag exists: " & localizedFileName)
Else
    'Load a default image here for languages not directly supported
    Log("No flag for your country")
End If

Attached is a very simple example with this code.

 

[achtrade]

Hi,

If I change the app's language from English to Spanish, how the app can remember the new language ?

thanks.

 

[inakigarm]

Hi corwin42

Is possible to have the AHLocale Library as a code or class module ?? I'm thinking about because when we'd have B4i, porting the app (the AHLocale component) to IOS won't be possible

Thanks

 

[Informatix]

Hi corwin42

Is possible to have the AHLocale Library as a code or class module ?? I'm thinking about because when we'd have B4i, porting the app (the AHLocale component) to IOS won't be possible

Thanks

This library and a lot of libraries available for B4A are written in Java, not in B4A. Their source code won't help for B4i.

 

[Erel]

It is true that the source code won't be very helpful. However in many cases it is possible to implement a B4i library with the exact (or at lease similar) API. For example iStringUtils B4i library is identical to StringUtils library (except of one method which is very specific to Android).

In other cases like iHttp library, the library API is not identical however iHttpUtils2 which is built over this library in B4i exposes the same API.

 

[inakigarm]

This library and a lot of libraries available for B4A are written in Java, not in B4A. Their source code won't help for B4i.

Ok thanks

I'll search an alternative method (maybe creating a file with keys and words in different languages or using somewhat like http://www.b4x.com/android/forum/threads/localize-your-app-using-androidresources.19165/ -almost I'll can use the xml strings)

Another possibility is create something like Po files ..(http://en.wikipedia.org/wiki/Gettext)

 

[Pavka]

Can someone tell me how to change tabhost tabs names and listview items names with translated ones? Can it be done without destroying and creating these views again? Thank you.

 

[Dadeda]

Yes, the files are standard Java porperties files and they are ISO encoded and not UTF. Special characters have to be written with the unicode code.

Will it ever be possible to use UTF8?, i really want to use this for my app, but it's a horrible job for anyone translating, they need to translate something into another language and then they need to make unreadable with unicode, it simply doesn't work for use with professional translators.

 

[corwin42]

Will it ever be possible to use UTF8?, i really want to use this for my app, but it's a horrible job for anyone translating, they need to translate something into another language and then they need to make unreadable with unicode, it simply doesn't work for use with professional translators.

This is a Java restriction so I can't do anything to change this.

 

[ivan.tellez]

it simply doesn't work for use with professional translators.

That is not the job of the translator.

They just have to deliver the translated text and the developer has to make the encofing. So, what is the problem? There are online encoders that make the job on a sec.

 

[Straker]

Just to avoid some of the restriction of the format I've made a little utility.
With this utility you can have all your translation in a Spreadsheet, one column for each language.
The file should then be saved in the CSV format. The csv is converted in unicode escaped through the jdk's native2ascii utility and then there is my utility that parse the final file and builds the corresponding translation files.
This way you have to update a single file with all the translations.

I didn't try this utility extensively, so if you find some bug just let me know. Also, let me know if you think there is something else to add (just like a b4a files parser, for example).
In the attachment there are also the VB6 source code

If you find this utility usefull, please donate to corwin42!

 

[John Woodsmall]

will the stirngfunctions lib work with b4i ?
if not will it soon work?

 

[John Woodsmall]

is the TTS working in b4i?
if not when?
also how do i download it?

 

[corwin42]

will the stirngfunctions lib work with b4i ?
if not will it soon work?

is the TTS working in b4i?
if not when?
also how do i download it?

Both of your questions seem not related to AHLocale library.

 

[Franck Danard]

Hello all.
I'm new with B4A
and i would like to take the language into my smartphone.

I installed the library AHLocale and i called it like this:

Sub Activity_Create(FirstTime As Boolean)
  'Do not forget to load the layout file created with the visual designer. For example:
  'Activity.LoadLayout("Layout1")  
  Activity.LoadLayout("Main")

  Dim Mylang As String
  Dim AHLocale1 As AHLocale
 
  AHLocale1.Initialize
 
  Mylang = AHLocale1.DisplayLanguage

However at the line: Dim Mylang As String , the IDE says : Unused variable "Mylang" (Warning #9).

I don't understand, because i try to declaring my variable Mylang with this line.
And Mylang is setted bellow.

Mylang should include my language code, right?

What happen please?

Thanks for your help.

Franck

 

[Cableguy]

do a log of MyLang, setting a var value is not the same as using it!!
Var = value is not the same as OtherVar = FirstVar.

The IDE is just telling you that you didn't use the MyLang var

 

[Franck Danard]

Hi.

Hmmm ok i see.
Indeed, if i add :

  If Mylang = "" Then
     ' Do something
   
   End If

No error.

All was right in my code, but it was not really completed.
I understand now.

Ok good.

Thanks for all

Franck