RedmineTimeTracking » History » Version 10

James Rowe, 2011-03-11 15:32
changed "Offcourse" to "Of course"

1 1 Jean-Philippe Lang
h1. Time tracking
2 1 Jean-Philippe Lang
3 9 Mischa The Evil
{{>toc}}
4 5 James Rowe
5 5 James Rowe
h2. Introduction
6 5 James Rowe
7 6 James Rowe
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 users progress. 
8 6 James Rowe
9 7 James Rowe
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 details]] or [[RedmineTimelogReport|spent-time report]] pages for more information.
10 5 James Rowe
11 5 James Rowe
h2. Installing/Configuration
12 5 James Rowe
13 9 Mischa The Evil
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.
14 1 Jean-Philippe Lang
15 2 Jean-Philippe Lang
h2. Logging time on an issue
16 2 Jean-Philippe Lang
17 2 Jean-Philippe Lang
You can log time on an issue by clicking !/images/time_add.png! *Log time* from the issue details view.
18 1 Jean-Philippe Lang
19 9 Mischa The Evil
p=. !log_time.png!
20 1 Jean-Philippe Lang
21 1 Jean-Philippe Lang
You can also log time when updating an issue.
22 1 Jean-Philippe Lang
23 9 Mischa The Evil
p=. !Update_LogTime.png!
24 1 Jean-Philippe Lang
25 1 Jean-Philippe Lang
h2. Logging time at project level
26 1 Jean-Philippe Lang
27 1 Jean-Philippe Lang
You can log hours at project level by leaving the issue field empty.
28 9 Mischa The Evil
29 9 Mischa The Evil
h2. Accepted time formats
30 9 Mischa The Evil
31 9 Mischa The Evil
Estimated and spent hours can be entered using the following formats:
32 9 Mischa The Evil
* Hours and minutes using standard time format: @1h@, @1 h@, @1 hour@, @2 hours@, @30m@, @30min@, @1h30@, @1h30m@, @1:30@
33 9 Mischa The Evil
* Hours and minutes using decimal time format: @1.5@, @1,5@ (equals to @1h30@)
34 9 Mischa The Evil
35 9 Mischa The Evil
h3. Decimal time format
36 9 Mischa The Evil
37 9 Mischa The Evil
When entering estimated- and spent-time values in Redmine using "decimal time format":http://en.wikipedia.org/wiki/Decimal_time you have to be aware of the following situation:
38 9 Mischa The Evil
39 9 Mischa The Evil
* _Example_: you have 4 issues with the following spent time values: 1.00, 0.10, 0.15, & 0.40. Now in the Spent-Time reports (Project overview -> Spent time -> [Details | Report]) you see a total of 1.65 hours instead of 2.05 hours...???
40 9 Mischa The Evil
41 9 Mischa The Evil
* _Explanation_: this "behaviour" is normal and intended since you enter those four spent-time values using decimal time format. This means that: 
42 9 Mischa The Evil
** 1.00 decimal equals 60 minutes (1 hour)
43 9 Mischa The Evil
** 0.10 decimal equals 6 minutes
44 9 Mischa The Evil
** 0.15 decimal equals 9 minutes
45 9 Mischa The Evil
** 0.40 decimal equals 24 minutes
46 9 Mischa The Evil
** 1.65 decimal equals 99 minutes
47 9 Mischa The Evil
** 2.05 hours (125 minutes) equals 2.0833333333333335 (est.) in decimal notation
48 9 Mischa The Evil
49 10 James Rowe
Of course there can possibly be a very tiny difference (as you can see) due to the rounding to two decimals done by Redmine.
50 9 Mischa The Evil
51 9 Mischa The Evil
Some references:
52 9 Mischa The Evil
* http://en.wikipedia.org/wiki/Decimal_time
53 9 Mischa The Evil
* http://www.springfrog.com/converter/decimal-time.htm