# Locale overrides

Localization here means the way in which times, dates and numbers are displayed and interpreted by AyaNova.
It is separate and distinct from the [Translation](ay-translation.md) feature of AyaNova which is used to set the text displayed in the user interface.

AyaNova relies on the web browser to provide the language and time zone to be used automatically. These settings in turn determine how time, date, currency and numbers are displayed and interpreted when typed in.

Rarely if ever should there be a need to override the browser's defaults as they generally come from the operating system itself and should be most appropriate for the user and device already.

If necessary, these override settings will replace the browser provided defaults for use in AyaNova.

## When to override

Ideally you should never have to override language or time zone; the browser should automatically provide the correct settings for the user based on their device and operating system. If a change is required it's best to try to set it inside the browser itself using the Browser's own settings first before using the settings below in AyaNova as a last resort.

## Language code override

The Language Code controls how the browser displays and accepts Numbers, Date and time values.

The _default_ value for this setting is obtained from the browser's language setting. If more than one language is set for the browser the _first_ language is used.

When no override setting has been made by the user this form displays the currently in-use default value in light gray text below this field.

This setting is provided for the purpose of forcing a browser to use a different one of it's installed languages than the default. Unless you have a specific reason, it's best to leave this field empty and accept the browsers default language or make adjustments in the browser's language settings rather than here.

If no language can be determined from the browser and no override has been set AyaNova will default to English USA - "en-US".

NOTE: This is a separate and unrelated setting to the users [Translation](ay-translation.md) setting which controls the set of customizable text used by AyaNova to display to the user.

### Choosing a Language code

To get started choosing a language code (a.k.a "Language Tag") here is a helpful guide from the standards body: [W3.org](https://www.w3.org/International/questions/qa-choosing-language-tags)

## Time Zone override

The _required_ Time Zone setting controls how date and time values are displayed, accepted for input and very importantly **converted** to local time from UTC time.
Wikipedia has a helpful list of time zone database codes [https://wikipedia.org/wiki/List_of_tz_database_time_zones](https://wikipedia.org/wiki/List_of_tz_database_time_zones)

This value must be the "database name" value, for example: `America/Denver` or `Australia/Sydney`.

If no value can be determined from the browser, and no override has been set, the default Time Zone used is `America/New_York`.

## Currency code (required, not an override)

Browsers do not have a default currency code (at time of writing) so this is one setting that _must_ be set by the user and included here for reference.

The Currency Code controls how currency values are displayed and accepted for input in AyaNova. The code must be one of the 3 character alphabetic [ISO 4217 active currency codes](https://wikipedia.org/wiki/ISO_4217#Active_codes) This value is _required_ and cannot be determined from the Browser itself. If no setting is made the _default_ value is "USD" for dollar symbol $.

Some other common currency codes are: "EUR" - Euro, "GBP" - Great British Pound, "CAD" - Canadian dollar, "AUD" - Australian dollar.