Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

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:

  "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

`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`.