class

Locale

@Serializable { simple=true }
const class Locale : Obj

Locale models a cultural language and region/country. See Localization for details.

Also see Env.locale and Pod.locale.

constructors fromStr

Parse a locale according to the toStr format

fields en

Constant for the English Locale "en"

methods toStr

Return string representation

country

Get the country/region as an uppercase ISO 3166 two letter code

cur

Get the current thread's locale

use

Run the specified function using this locale as the actor's current locale

equals

Equality is based on the normalized toStr format

lang

Get the language as a lowercase ISO 639 two letter code

setCur

Set the current thread's locale

hash

Compute hash code based on normalized toStr format

country Str? country()

Get the country/region as an uppercase ISO 3166 two letter code. Return null if the country is unspecified.

cur static Locale cur()

Get the current thread's locale.

en const static Locale : en

Constant for the English Locale "en"

equals virtual Bool equals(Obj? obj)

Equality is based on the normalized toStr format.

fromStr static new fromStr(Str s, Bool checked)

Parse a locale according to the toStr format. If invalid format and checked is false return null, otherwise throw ParseErr.

hash virtual Int hash()

Compute hash code based on normalized toStr format.

lang Str lang()

Get the language as a lowercase ISO 639 two letter code.

setCur static Void setCur(Locale locale)

Set the current thread's locale. Throw NullErr if null is passed.

toStr virtual Str toStr()

Return string representation:

<locale>  := <lang> ["-" <country>]
<lang>    := lowercase ISO 636 two letter code
<country> := uppercase ISO 3166 two letter code

use This use(|This| func)

Run the specified function using this locale as the actor's current locale. This method guarantees that upon return the actor's current locale remains unchanged.

Haxall 4.0.5 ∙ 24-Feb-2026 14:33 EST