Set the time zone for a display

You can use a URL parameter to set the time zone for a display so that users see data in the time zone you specify, rather than in the time zone of their client machine.

You do this by specifying the following in the URL of a display:

• Windows Time Zone IDs (for example, Eastern Standard Time). See System time zone IDs.

• IANA TZID (For more information, see the unicode.org page Zone - Tzid.)

• Time offset from UTC time (Coordinated Universal Time). This offset is only used for:

  • Specified display.

  • Trend previews of dynamic symbols on that display.

The timebar shows the UTC string. Daylight saving time does not affect displays that use this parameter.

As an example, assume you want to specify the time zone in which your users view data for the following display:

https://PIVisionServ/PIVision/#/Displays/3117/PowerAnalysis

Append the TZ parameter to the URL. For example:

https://PIVisionServ/PIVision/#/Displays/3117/PowerAnalysis?tz=Eastern Standard Time

https://PIVisionServ/PIVision/#/Displays/3117/PowerAnalysis?tz=America/New_York

https://PIVisionServ/PIVision/#/Displays/3117/PowerAnalysis?tz=UTC-5:00

The TZ parameter name and the UTC keyword are not case sensitive. The offset can be positive or negative. To apply a positive offset, you must encode the + (plus) sign as %2B.

Syntax and examples

There cannot be any spaces within the time zone offset specification, for example: TZ=UTC-3:00.

You can enter the time offset in either of the following formats:

• H:MM or HH:MM

  For example: TZ=UTC-5:05

  If you specify minutes, you must use two digits and precede them with a : (colon). Values for minutes can range from 00 to 59. For example:

  tz=utc%2B8:05

• +n or -n hours. Values for hours (n) can range from 1 to 13.

  For example: tz=Utc-1

  Note: In Mozilla Firefox browsers, the UTC+H format can fail, because the + (plus) sign is not properly transmitted (whether or not it is encoded as %2B).

Any invalid specifications cause the display to revert to the client time zone.