Skip to content

Time Zones

Examples for specifying the time zone:

Single Zone

Most graphs will only show a single time zone. By default the zone is US/Pacific. To set to another zone such as UTC use the tz query parameter:

/api/v1/graph?
  e=2012-01-01T00:00
  &q=
    name,sps,:eq
  &tz=UTC

Multi Zone

The tz parameter can be specified multiple times in which case one X-axis will be shown per zone. Start and end times will be based on the first time zone listed.

/api/v1/graph?
  e=2012-01-01T00:00
  &q=
    name,sps,:eq
  &s=e-2d
  &tz=US/Eastern
  &tz=US/Pacific
  &tz=UTC

Daylight Savings Time

If using a time zone that changes for daylight savings time, then you will see duplicate or missing hours on the time axis labels during the transition period. For example, a duplicate hour:

/api/v1/graph?
  e=2015-11-01T08:00
  &q=
    name,sps,:eq
  &s=e-12h
  &tz=US/Pacific
  &tz=UTC

A missing hour:

/api/v1/graph?
  e=2015-03-08T08:00
  &q=
    name,sps,:eq
  &s=e-12h
  &tz=US/Pacific
  &tz=UTC

If looking at a longer time frame, then it can also throw off the alignment so ticks will not be on significant time boundaries, e.g.:

/api/v1/graph?
  e=2015-11-05T08:00
  &q=
    name,sps,:eq
  &s=e-1w
  &tz=US/Pacific
  &tz=UTC