In SimpleOne , stores all times are stored in the UTC timezone and appear based in displays them according to the system time zone. But to users, times appear in their local time zone, according to their defined in the preference settings.
This functionality is used all across the system, for example, in Timepoint Indicators, email notifications, and so on, so very important to set up them carefully, taking all the conditions into account.
Setting up a new timezone
| Note |
|---|
When an instance is deployed or updated, it synchronizes with the IANA database and copies a pack of standard timezones actual for a deploy date. All newly created timezones must be extended from the standard ones. |
| Tip |
|---|
Role required: admin. |
To To create a new timezone, please complete the steps below:
- Navigate to to System Localization → Timezones.
- Click New Click New and fill in the fields.
- Click Save Click Save or Save and Exit to apply changes.
Timezones fields description
Field | Mandatory | Description |
|---|---|---|
| Title | Y | Specify the timezone title. It is used in different interface components, such as choice list in the General Preferences menu, and it is multilanguage. |
| Name | N | A timezone name. It is recommended to use thethe Country/City format when naming the timezone like listed in thethe TZ database. This field is of the String type and takes only English language. |
| UTC Offset | Y | In this field, the UTC offset (the difference from Universal Coordinated Time) is specified. This field is read-only and inherits offset of the timezone specified in the Parent field. |
| Active | N | Select this checkbox to make the timezone active or inactive. When timezone is inactive, it is not available to choose as default user timezone, or a timezone for email notification, cannot be used in Timepoint in Indicators. |
| Deprecated | N | Select this checkbox to mark the timezone as deprecated. When selected, the offset for this timezone is equal to 0, and it cannot be selected as Active. For timezones from the IANA list TZ database, this flag is set automatically and means that this timezone is no longer supported. The deprecated timezone automatically marked as inactive and cannot be used in any system components, such as schedules, indicators, and so on. Custom timezones extended from the deprecated timezone are also deactivated. |
| Parent | Y | Specify a parent timezone with desirable UTC offset from the IANA list TZ database. |
Default timezone
You can define a default timezone either for a single user logged in a system or for all users.
Setting a default timezone for a single user
It can be done through the General Preferences menu, as described in this sectionin General Preferences.
Also, you can define a default timezone for a user by specifying it in a user profile. For this, please complete the steps below:
- Click on the username on the top right and select Profile.
- Specify a timezone in the Timezone field.
- Click Save or Save and Exit to apply changes.
| Info |
|---|
If the default user timezone was deprecated, he they will be asked to change it to another one. It 's is also valid for scripts or business-rules where API methods involving timezones are used (for example, methods from theSimpleDateTime class class). |
Setting a default timezone for all users
To define a default timezone for all users, you need to change the relevant system property value. The user.timezone.default systemproperty system property is responsible for this. To change this property value, please complete the steps below:
- Navigate to to System Properties → System PropertiesAll.
- Click on the magnifier icon icon
on the top of the list; the search string appears. - Enter the property name into the Name field and perform a search, click Enter on your keyboard.
- When found, click on the property name.
- Type the necessary timezone into the Value field; this . This property will affect all users in the system.
- Click Save or Save and Exit to apply changes.
Timezones in email notifications
The date and time in notifications are set using the system time zone; the recipient time zone is not taken into account.
The simple.email.append.timezone system property controls this aspect and allows to append timezone to dates and times in sent emails.
This property is of the Boolean type, so it can take the only values TRUE or FALSE. When set to TRUE, then the system timezone is appended to time and date in notifications.
Changing the value
| Tip |
|---|
Role required: admin. |
To change the property value, please complete the steps below:
- Navigate to System Properties → System Properties.
- Locate this property in the list and click on it.
- Change the value in the Value field.
- Click Save or Save and Exit to apply changes.
/
| Table of Contents | ||||
|---|---|---|---|---|
|