# USER SETTINGS

This form controls various settings for the currently logged in User.

## Dark mode
This setting controls the alternative dark theme for UI display.  Note that unlike the other settings on this page, this is a local device setting only to allow for different themes when working with different devices in different settings.

## Translation
This setting is *required* and controls which [translation](form-adm-translation.md) of AyaNova is used to display program text to the current logged in user.
The default value is "en" for English.
If you change the language setting here you must logout and back in for the changes to take effect.

## User email address
This is the email address used to send AyaNova related information to the user by the AyaNova [Notification system](ay-notification.md).

This setting is not required (except for notifications if used) and the default value for this setting is empty.

## Currency code
The Currency Code controls how currency values are displayed and accepted for input in AyaNova.

This value is *required* and cannot be determined from the Browser itself.  If no setting is made the *default* value is "USD" for U.S. dollars.
Some other common currency codes are: "EUR" - Euro, "GBP" - Great British Pound, "CAD" - Canadian dollar, "AUD" - Australian dollar.

AyaNova is not a multi-currency program, it assumes all currency values entered are for the same currency and values entered are stored at the server as Decimal numbers so this setting will affect how values are displayed and accepted for entry only, it has no relation to actual currency values or exchange etc.

## 12 hour clock
This *optional* setting controls whether times are displayed and selected in 12 hour (AM/PM) format or 24 hour format.

## User color
This *optional* setting controls some aspects of AyaNova where multiple user's data is being displayed at once to make it easier to visually distinguish between users at a glance.
One example is the Schedule form when it is displaying schedules for more than one user.

The *default* value is black / transparent.

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

It must be a value that is understood by the browser and matches one of the languages chosen in the browsers languages settings.

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 in 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.

## 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.

### UTC
All dates and times are stored at the server in UTC (GMT) values.  The server has no knowledge of time zones so this value is used to display the time and date in your local Browser time zone.
While you can ovveride this setting it's generally best to allow it to be the default setting obtained from the browser itself.

If no value can be determined the default Time Zone used is `America/New_York`.

### Filtering dates
When viewing data in AyaNova that is filtered with one of the relative date filters (for example a filter of "TODAY"), this time zone setting is taken into account in order to ensure that the user sees data appropriate to *their time zone*.  This means that two people with browsers in different time zones using a filter of TODAY for a date field may see different list of results from each other.


