Time Zone (Core Services)
The time zone can be specified for endpoints with a time (e.g. start time and end time) parameter. The specified time zone context will be used to interpret the time string when possible (e.g. for relative PI time strings such as "y" and "t"). The following behavior is to be expected:
If the time string already has a time zone offset designated in ISO 8601 format (e.g. "2016-07-07T05:00:00Z" or "2016-07-07T05:00:55+02:00"), the time zone parameter is ignored.
If the time string has no time zone offset designated (e.g. "2016-07-07T05:00:00" or "y"), the time zone specified in the time zone parameter (see accepted formats below) will be used to evaluate the given time strings.
If no time zone information is specified in the time string or the time zone query parameter, the local time (including daylight saving settings) on the PI Web API instance is used to interpret the time strings.
Notes about Daylight Savings Setting
If daylight saving time is enabled on the PI Web API server machine (when applicable):
- The operating system on which PI Web API instance is installed will dictate the daylight saving time rule for all time zones.
If daylight saving time is disabled on the PI Web API server machine (when applicable):
- If no time zone information is specified, the local time on the PI Web API instance is used and no daylight saving time is observed.
- If the time zone parameter is specified, daylight saving time is observed for all regions that support daylight saving time. This is true even if the time zone specified is identical to the local time zone for the PI Web API server.
Accepted Time Zone Formats
Windows Time Zone IDs. For example,
- Eastern Standard Time
- Pacific Standard Time
The full list of supported Windows time zone ids on this PI Web API instance can be found here.
IANA Time Zone Database (or Olson Database) IDs. For example,
The full list of supported IANA time zone ids on this PI Web API instance can be found here.