/
Time & Date Settings

This documentation describes all functionality of an older version of ictime (3.x) for administrators and users. For documentation of the current version, please refer to the latest version of our documentation. For all versions of the documentation, please refer to Documentation History.

Time & Date Settings

ictime uses your JIRA time & date settings to display data. This refers to the display of date & time information, e.g. in reports or timesheets and to the date format in date picker elements.

If your JIRA time & date settings are correct (i.e. time & date is displayed the way you want all over JIRA), there is nothing you need to do.

 


Time & Date Settings

Regarding JIRA time & date configuration, please refer to https://confluence.atlassian.com/display/JIRA/__date+and+time+formats (good examples also under https://confluence.atlassian.com/display/JIRA/Changing+the+Due+Date+Input+Format).

There are two different places where you have to configure these settings in JIRA (in different notations for Java and JavaScript), and you need to consider that both configurations have to be consistent - if they are not the same, you will get date / time validation errors (not only in ictime, but also in some other places in JIRA).

General

Go to

Administration - System - User Interface - Look and Feel

and configure the settings under "Date/Time Formats".

These are the relevant settings and where they apply to ictime data:

Time FormatJIRA ConfigurationRemarks
clock icons (all log work / edit /resume work log screens)Date/Time Formats: Time Format 
from-to time on view issue screen, timesheet and reporting detailsDate/Time Formats: Time Format

 

all dates displayed on all other screensDate/Time Formats: Day/Month/Year Format 

Picker Settings

Go to

System - Settings

and click on "Advanced Settings":

These are the relevant settings and where they apply to ictime data:

Date FormatJIRA ConfigurationRemarks
Date picker (all log work / edit work log screens, Reporting search mask, My Timesheet search mask); pre-populated date range in My Timesheet, date format for search in My Timesheet and Reporting

jira.date.time.picker.javascript.format

jira.date.picker.javascript.format

jira.date.time.picker.java.format

jira.date.picker.java.format

It is essential that these four definitions match exactly! If they don't match, limiting your search to a date range in ictime might not work correctly.

 

Configuration is in JavaScript format and in Java SimpleDateFormat. See https://confluence.atlassian.com/display/JIRA/__date+and+time+formats for some examples.

 

Timezone Handling

For dates in work logs, ictime uses the timezone of the user profile in JIRA. That means that the server date is taken and calculated with the timezone of the current user. This is the way JIRA usually handles dates. If timestamps for the creation of a work log are saved, they are  saved with the user profile timezone, too (these timestamps are not displayed in ictime).

Times are usually not taken from the server, but entered by a user - that means that ictime can't control if a time is "correct" as this decision is a user decision. If you use the clock icons as helpers to insert the current time from-to for a work log (see e.g. Log Work (Issue Screen)), the system uses your individual client machine time. If your system clock is not correct, incorrect times will be inserted.