SimpleOne stores all times in the UTC timezone and displays them according to the system time zone. But to users, times appear in their local time zone, 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
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.
Role required: admin.
To create a new timezone, please complete the steps below:
- Navigate to System Localization → Timezones.
- Click New and fill in the fields.
- 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 the Country/City format when naming the timezone like listed in the 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 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 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 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 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.
If the default user timezone was deprecated, they will be asked to change it to another one. It is also valid for scripts or business-rules where API methods involving timezones are used (for example, methods from the SimpleDateTime 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 system property is responsible for this. To change this property value, please complete the steps below:
- Navigate to System Properties → All.
- Click on the magnifier icon
on the top of the list; the search string appears. - Enter the property name into the Name field, click Enter on your keyboard.
- When found, click on the property name.
- Type the necessary timezone into the Value field. This property will affect all users in the system.
- Click Save or Save and Exit to apply changes.
/
