Menu
Choose a product
Viewing: v12.4 (latest)
Find another version
Scroll for more
Documentation
Grafana documentation
As code
Observability as code
JSON schema v2
timesettings schema
Grafana Cloud
Enterprise
Open source
timeSettings
The TimeSettingsSpec defines the default time configuration for the time picker and the refresh picker for the specific dashboard.
Following is the JSON for default time settings:
JSON
"timeSettings": {
"autoRefresh": "",
"autoRefreshIntervals": [
"5s",
"10s",
"30s",
"1m",
"5m",
"15m",
"30m",
"1h",
"2h",
"1d"
],
"fiscalYearStartMonth": 0,
"from": "now-6h",
"hideTimepicker": false,
"timezone": "browser",
"to": "now"
},timeSettings consists of:
TimeSettingsSpec
The following table explains the usage of the time settings JSON fields:
| Name | Usage |
|---|---|
| timezone? | string. Timezone of dashboard. Accepted values are IANA TZDB zone ID, browser, or utc. Default is browser. |
| from | string. Start time range for dashboard. Accepted values are relative time strings like now-6h or absolute time strings like 2020-07-10T08:00:00.000Z. Default is now-6h. |
| to | string. End time range for dashboard. Accepted values are relative time strings like now-6h or absolute time strings like 2020-07-10T08:00:00.000Z. Default is now. |
| autoRefresh | string. Refresh rate of dashboard. Represented by interval string. For example: 5s, 1m, 1h, 1d. No default. In schema v1: refresh. |
| autoRefreshIntervals | string. Interval options available in the refresh picker drop-down menu. The default array is ["5s", "10s", "30s", "1m", "5m", "15m", "30m", "1h", "2h", "1d"]. |
| quickRanges? | Selectable options available in the time picker drop-down menu. Has no effect on provisioned dashboard. Defined in the TimeRangeOption spec. In schema v1: timepicker.quick_ranges, not exposed in the UI. |
| hideTimepicker | bool. Whether or not the time picker is visible. Default is false. In schema v1: timepicker.hidden. |
| weekStart? | Day when the week starts. Expressed by the name of the day in lowercase. For example: monday. Options are saturday, monday, and sunday. |
| fiscalYearStartMonth | The month that the fiscal year starts on. 0 = January, 11 = December |
| nowDelay? | string. Override the “now” time by entering a time delay. Use this option to accommodate known delays in data aggregation to avoid null values. In schema v1: timepicker.nowDelay. |
TimeRangeOption
The following table explains the usage of the time range option JSON fields:
| Name | Usage |
|---|---|
| display | string. Default is Last 6 hours. |
| from | string. Default is now-6h. |
| to | string. Default is now. |
Was this page helpful?
Related resources from Grafana Labs
Additional helpful documentation, links, and articles:
Video

Getting started with managing your metrics, logs, and traces using Grafana
In this webinar, we’ll demo how to get started using the LGTM Stack: Loki for logs, Grafana for visualization, Tempo for traces, and Mimir for metrics.
Video

Getting started with Grafana dashboard design
In this webinar, you'll learn how to design stylish and easily accessible Grafana dashboards that tell a story.
Video

Building advanced Grafana dashboards
In this webinar, we’ll demo how to build and format Grafana dashboards.