Table of Contents

Timezone

The timezone the user is using affects the way that dates and times are displayed to an end user and determines what values are stored in the database. If a user under the America/New_York timezone enters the date and time of 11/17/2014 5:00pm it would display to a user in the Europe/London timezone as 11/17/2014 10:00pm and a user in the Asia/Tokyo timezone as 11/18/2014 3:30am. The timezone that is used by the application for a specific user can come from several sources. In order of precedence:

  • User Setting - The WorkXpress Platform will read the results of Field “Preferred Timezone”, e5590, to determine the timezone. If the Software Developer would like to allow the user to change their timezone then this field should be included in the interfaces they build for the user to edit their preferences. To set this field automatically using actions both the field e5590 and the sub-field for the selected option need to be set.
  • Application Setting - The WorkXpress Platform will read the results of the Field “Default Timezone”, e7491, to determine the timezone. If the Software Developer would like to set the default for all users then this field should be included in the interfaces they build for the administrator to edit the settings on the application. To set this setting manually in the Application Explorer without including it in an interface both the field e7491 and the sub field for the option selected must be set.
  • Global Default - If neither the user or application level settings are filled in then the “America/New_York” timezone will be used.

Locale

The locale the user is using affects the language the application displays in and the way that controls like the date picker work. For example, if the user has the locale setting of en_US, English United States, and they use the date picker field to pick the date November 17th, 2014 then it will display 11/17/2014 but if the user has the locale setting of en_GB, English Great Britain, the date picker field will display 17/11/2014. The locale that is used by the application of a specific user will come from several sources. In order of precedence:

  • User Setting - The WorkXpress Platform will read the value in the field “Preferred Locale”, e169, to determine the locale. For this field to display any values to choose from the “Supported Locales” setting on the Application Record must be configured. If the Software Developer would like to allow the user to change their locale then this field should be included in the interfaces they build for the user to edit their preferences.
  • Browser Setting - The web browser will send a list of languages that it prefers in an order of precedence. If one of the locales presented by the browser is in the “Supported Locales”, then that locale will be used.
  • Application Setting - The WorkXpress Platform will read the results of the Field “Preferred Locale”, e169, from the Application Record. If the Software Developer would like to set the default for all users then this field should be included in the interfaces they build for the administrator to edit the settings on the application. To set this setting manually without including it in an interface the software developer must use the Application Explorer.
  • Global Default - If neither the user, browser, or application level settings are acceptable, “en_US” locale will be used.
timezone and locale.txt · Last modified: 2016/09/14 18:19 (external edit)
Copyright WorkXpress, 2024