You may have reached this article because part or all of your team has moved to a different time zone. This guide explains how Jira is affected and how to adjust app configurations to reduce any impact.
This article describes how time zones work in Jira and how they are applied in areas such as Worklogs, Warnings, and Capacity tab types, depending on your team’s location.
How do time zones impact worklogs?
When you log work, Jira converts the entered time to server time but does not store your time zone. As a result, when someone in a different time zone views the same worklog, the date and time adjust to their local time.
This can make it appear as though work was logged on a different day or at a different time.
Example:
The default Jira time zone matches the time zone of a data center in Montreal (EDT, UTC-4).
A user in Jakarta (WIB, UTC+7) logs work on April 9 at 7:30 AM.
The time difference is 11 hours.
From the Jakarta user’s perspective, the worklog appears on April 9 at 7:30 AM.
From the Montreal user’s perspective, the same worklog appears on April 8 at 8:30 PM.
How do time zones impact due dates?
Due dates themselves are not affected by time zones, as confirmed by Atlassian. However, whether a work item, with a due date of April 9, appears overdue depends on the viewer’s time zone.
Using the same example:
In Jakarta, the worklog appears on April 9.
In Montreal, the same worklog appears on April 8.
Within the report:
-
The Due Date column is not affected in the Capacity tab.
-
The Overdue column is not affected for closed work items. For open work items, whether it appears depends on the app’s time zone settings.
-
When the Overdue warning is enabled in the Warnings tab, whether a flag is raised depends on the app’s time zone settings.
How do time zones impact capacity?
Time zones can affect how work is distributed across workweeks.
For example, if April 8 and 9 fall in different workweeks (such as in 2029 with a Monday-start week):
A user in Jakarta logging work on Monday may have that time counted toward the current week’s capacity.
A user in Montreal viewing the same worklog may see it counted toward the previous week.
Within the report, whether the Capacity tab shows different results based on the viewer’s time zone depends on the app’s time zone settings, especially when work is logged near the start of the week.
Why should you use the app to address these impacts?
Time zones can change how worklogs, capacity, and warnings appear in reports in Jira. To manage these differences, the app provides three configuration options. Each option defines whether report data is displayed based on:
-
the viewer’s local time zone
-
Jira’s default time zone
-
the worklog author’s time zone
Local Time Zone of the user
All worklogs are converted to the viewer’s local time. As a result, the same worklog may appear on different dates depending on who views the report.
This is the default setting when the Pivot Report app is installed.
Example:
-
The default Jira time zone matches the time zone of a data center in Montreal, where the time is April 8 at 8:30 PM.
-
A user in Jakarta logs work on April 9 at 7:30 AM and includes the local timestamp in the worklog comment.
-
From the Jakarta user’s perspective, the worklog appears in the Work item view as April 9 at 7:30 AM. Likewise, the Worklog Date column in the report shows April 9, as shown in the screenshot above, because it matches the user’s local time in Jakarta.
-
From the perspective of another user in Montreal, the same worklog appears in the Work item view as April 8 at 8:30 PM because of the time zone difference. Likewise, the Worklog Date column in the report shows April 8, as shown in the screenshot below, because it matches the user’s local time in Montreal.
Note that the Worklog Date column displays only the date, not the time.
Jira Time Zone
Worklogs are aligned with Jira’s default time zone, regardless of the author’s settings. This ensures consistent dates across all users, but it may be confusing if the server time differs from users’ local time.
Example:
-
The default Jira time zone matches the time zone of a data center in Montreal, where the time is April 8 at 8:30 PM.
-
A user in Jakarta logs work on April 9 at 7:30 AM and includes the local timestamp in the worklog comment.
-
From the Jakarta user’s perspective, the worklog appears in the Work item view as April 9 at 7:30 AM. However, the Worklog Date column in the report still shows April 8, as shown in the screenshot above, because it follows the default Jira time zone in Montreal.
-
From the perspective of another user in Montreal, the same worklog appears in the Work item view as April 8 at 8:30 PM because of the time zone difference. The Worklog Date column in the report also shows April 8, as shown in the screenshot above, because it follows the default Jira time zone in Montreal.
Note that the Worklog Date column displays only the date, not the time.
Worklog author Time Zone
Worklogs are displayed based on the time zone of the user who created them. This keeps the original context of when the work was logged, but the value displayed is still adjusted for viewers.
Example:
-
The default Jira time zone matches the time zone of a data center in Montreal, where the time is April 8 at 8:30 PM.
-
A user in Jakarta logs work on April 9 at 7:30 AM and includes the local timestamp in the worklog comment.
-
From the Jakarta user’s perspective, the worklog appears in the Work item view as April 9 at 7:30 AM. Likewise, the Worklog Date column in the report shows April 9, as shown in the screenshot above.
-
From the perspective of another user in Montreal, the same worklog appears in the Work item view as April 8 at 8:30 PM because of the time zone difference. However, the Worklog Date column in the report still shows April 9, as shown in the screenshot above.
Note that the Worklog Date column displays only the date, not the time.
If the worklog author changes their account time zone, the appearance of their past worklogs may also change for other users in Jira. This can make older entries harder to interpret, especially after a relocation.
How can you change worklogs appear in reports?
By using app-level time zone settings, you can control how worklogs appear in reports in Jira. To do so, follow these steps as a Jira admin:
-
Open the Settings menu in Jira’s top navigation bar, by clicking on the gear icon.
-
From the dropdown, choose Marketplace apps.
-
Within the Apps settings page, click on ‘Settings’ from the list of Pivot Report configuration options.
-
On the Pivot Report Settings page, select the General tab.
-
Access the Time Zone section and select a configuration option.
FAQ
Troubleshooting
If you have questions or need assistance, contact our support team via email or service desk. Our team is available Monday through Friday (9:00 AM to 7:00 PM GMT+7) to help with technical challenges or discuss improvements.