65 lines
4.0 KiB
Markdown
65 lines
4.0 KiB
Markdown
# Locale overrides
|
|
|
|
"Localization" here means the way in which times, dates and numbers are displayed and interpreted by AyaNova.
|
|
|
|
Localization is separate and distinct from the [Translation](adm-translations.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 device's operating system 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 using the Browser's own settings first before using the settings below in AyaNova as a last resort.
|
|
|
|
## Where to override
|
|
|
|
|
|
|
|
Locale overrides are set in the [User settings](home-user-settings.md) form.
|
|
|
|
## 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](adm-translations.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.
|
|
|
|
Currency code is set in the same [User settings](home-user-settings.md) form where the [language code](#language-code-override) and [time zone](#time-zone-override) overrides are located.
|
|
|
|
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.
|