Agile Central: WSAPI - UTC used for Time Zone for WSAPI

Document ID : KB000103367
Last Modified Date : 26/06/2018
Show Technical Document Details
Question:
We notice a difference between the time displayed in Agile Central to what is being returned by WSAPI for the same artifact and same field. Here is an example for a Feature's Planned End Date field.

Planned End Date as seen in QDP:
User-added image

Planned End Date as seen in a grid/list:
User-added image

Planned End Date as returned by WSAPI:
User-added image


Notice that the time zone is difference. The few hours difference may cause actual date difference which impacts the returned results for WSAPI and reports to be different than what is seen in Agile Central.
Answer:
The explanation to this behavior is explained at: https://help.rallydev.com/customize-your-workspace#timezones
User-added image

Agile Central records times in the UTC time zone and in Zulu format. (more on these , see in the additional info section).

- WSAPI returns the data as it is recorded in UTC and Zulu format - as you see in the WSAPI screen shot earlier.
- Agile Central, however, coverts that time to the workspace time zone and displays it in that time zone and in the format that the user has selected in his/her settings.

In case you need to display the WSAPI returned time to your workspace time zone then you'll need to offset the UTC/Zulu time to your workspace time in your calculation. You can see more on that in the Additional Info.
Additional Information:
See these links for additional information:

- UTC Time Zone: https://en.wikipedia.org/wiki/Coordinated_Universal_Time
- Zulu Time Zone: https://www.timeanddate.com/time/zones/z
- Translate UTC to your time zone: http://earthsky.org/astronomy-essentials/universal-time

- On Workspace Time Zones, see: https://help.rallydev.com/customize-your-workspace#timezones