RedmineTimeTracking » History » Version 16

Version 15 (Red Miner, 2016-06-01 13:35) → Version 16/19 (Mikkel Kirkgaard Nielsen, 2016-11-02 11:37)

h1. Time tracking

{{>toc}}

h2. Introduction

Time tracking allows users to track how many hours of work are logged to a specific issue or project. Each time entry of "spent time" can be categorized by activity, and further explained with comments. By filling time estimates, project managers are able to produce better suited project planning as well as follow individual user's users progress.

Time tracking is always related to a user, thus it can be used to track how many billable hours this user has accomplished. See the [[RedmineTimelogDetails|spent time [[RedmineTimelogDetails|spent-time details]] or [[RedmineTimelogReport|spent time [[RedmineTimelogReport|spent-time report]] pages for more information.

You can use a standard time tracking module in Redmine or go with an easy way and use alternative *Redmine time tracker* https://tmetric.com/help/integrations/redmine-time-tracking/

h2. Installing/Configuration

Time tracking is a standard module of Redmine and can be enabled/disabled for each project in the *Modules* section of the new project form, or the *Settings* tab of an existing project.

h2. Logging time on an issue

You can log time on an issue by clicking !/images/time_add.png! *Log time* from the issue details view.

p=. !log_time.png!

You can also log time when updating an issue.

p=. !Update_LogTime.png!

h2. Logging time at project level

You can log hours at project level by leaving the issue field empty.

h2. Accepted time formats

Estimated and spent time hours can be entered using either separated hour and minutes or combined in the following formats:
# Separated: hour * Hours and minutes as an integer using standard time format: *@1h@*, *@1 h@*, *@1 hour@*, *@2 hours@*, *@30m@*, *@30min@*, *@1h30@*, *@1h30m@*, *@1:30@* @1h@, @1 h@, @1 hour@, @2 hours@, @30m@, @30min@, @1h30@, @1h30m@, @1:30@
# Combined: as a fraction of hours in * Hours and minutes using decimal time format using either period (.) or comma (,) as decimal separator: *@1.5@*, *@1,5@* format: @1.5@, @1,5@ (equals to @1h30@)

h3. Decimal time format

When entering estimated or spent time estimated- and spent-time values in Redmine using "decimal time format":http://en.wikipedia.org/wiki/Decimal_time you have to be aware that Redmine will also show accumulated time values in decimal time format.

Consider
of the following example: situation:

* in a project _Example_: you have 4 issues with the following spent time values: *1.00*, *0.10*, *0.15* 1.00, 0.10, 0.15, & *0.40*. 0.40. Now in the Spent Time Spent-Time reports (Project overview -> Spent time -> [Details | Report]) you will see the accumulated a total of the decimal values of 1.65 hours (1 hour 39 minutes), not a separate accumulation instead of the hour and minutes after the decimal point (which would yield an incorrect value of 2.05 hours). hours...???

* _Explanation_: this "behaviour" is normal and intended behaviour since the you enter those four spent time spent-time values are entered in using decimal time format. The values are interpreted as follows: This means that:
** 1.00 decimal equals 60 minutes (1 hour)
** 0.10 decimal equals 6 minutes
** 0.15 decimal equals 9 minutes
** 0.40 decimal equals 24 minutes
** 1.65 decimal equals 99 minutes
** 2:05 2.05 hours (125 minutes) equals 2.0833333333333335 (est.) in decimal notation

Due to rounding of the decimal values to two decimals done when showing an accumulated value Of course there can possibly be a very tiny difference (as you can be seen from see) due to the 2:05 example above). rounding to two decimals done by Redmine.

Some references:
* http://en.wikipedia.org/wiki/Decimal_time
* http://www.springfrog.com/converter/decimal-time.htm

h2. Logging time via commit messages

With the *Enable time logging* option turned on (see _Application settings -> Repositories_), developers can log time against an issue via their commit messages using the following syntax (hours must be preceded with an issue id):

Fixed something, #435 @1h30

This commit message will log 1h30 on issue !#435.

If you encounter a problem with this, ensure that under _Application settings -> Repositories_, make sure that *Activity for logged time* is set to something other than 'Default' and use a format similar to the below in your commit message.

refs #435 @1h30