Configuring Time Zone Settings
The Qrvey platform enables end users to display dates and times in their local time zone. The Qrvey platform stores data in UTC/GMT+0 and adjusts the time displayed to the end user based on their preferred settings. The default time zone setting is specified in Qrvey Admin Center, but it can be overridden programmatically. The possible settings are:
- System Default Settings. Use the time zone in which the data was stored in the Elasticsearch repository, which is UTC/GMT+0.
- User Browser Settings. Use the time zone specified in the end user’s browser.
- Fixed Time Zone. Use the time zone specified.
The time zone setting affects how data is filtered and displayed throughout the Qrvey platform, as well as in the embedded widgets.
Note: The time zone settings do not change how the data is stored in the repository. The settings only affect how data is filtered and displayed to the user.
This time zone setting in Qrvey Admin Center is overridden in the following cases:
- Specifying the time zone programmatically through APIs.
- Specifying the time zone In a widget’s configuration object.
- Specifying the time zone as a fixed setting for a dataset.
To specify the default time zone setting
- In Qrvey Admin Center, click the Customization icon in the left-hand navigation pane and display the General Settings tab.
- Click the Time Zone tab.
- Under Set Time Zone, select one of the following options:
- System Default Settings (UTC +00:00). Use the time zone in which the data was stored in the Elasticsearch repository, which is UTC/GMT+0.
- User Browser Settings. Use the time zone specified in the end user’s browser.
- Fixed Time Zone. Use the time zone specified in the dropdown menu below this setting.
- Click Apply Changes.
To specify the time zone in a widget
You can configure the time zone in the JSON configuration object for the following widgets:
- Dashboard View
- Dashboard Builder
- Automation
- Pixel-perfect Reports
- Analyze
Add the following property to the JSON configuration object:
Time zone Configuration
Property | Description | Required |
---|---|---|
offset | Time zone offset used to display dates. Overrides the time zone setting in Admin Center. Possible values are: default to show dates in UTC-0, browser to use the setting in the user’s browser, or specify a fixed offset such as +05:00 or -03:00 | Yes |
To specify the time zone programmatically via API
The Qrvey platform provides the following APIs to get and update the time zone settings. Click the links to view the API documentation: