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 Format | JIRA Configuration | Remarks |
---|---|---|
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 details | Date/Time Formats: Time Format |
|
all dates displayed on all other screens | Date/Time Formats: Day/Month/Year Format |
Configuration is in Java SimpleDateFormat. See http://docs.oracle.com/javase/6/docs/api/index.html?java/text/SimpleDateFormat.html.
Picker Settings
Go to
System - Settings
and click on "Advanced Settings":
These are the relevant settings and where they apply to ictime data:
Date Format | JIRA Configuration | Remarks |
---|---|---|
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.