Timesheet

Starting and stopping records

Re-start timesheet records

  • Click one of your last activities in the dropdown in the upper toolbar - this will start a record for the same customer/project & activity “now”
  • Click the restart action from one of the records in your timesheet - this will start a record for the same customer/project & activity “now” and copy description and tags

Start new records

  • Clicking the big play button in the toolbar (if no record is active right now)
  • Click the “+” action is the upper right page actions to open the “edit new record” modal
  • Select a time-range in the calendar (deactivated if the timeclock-mode is active)
  • Click a day in the calendar (deactivated if the timeclock-mode is active)

Stop records

  • Click the stop button in the “active records” dropdown in the upper toolbar
  • Click the stop action in the running record in your timesheet
  • Save a running record after setting an end date (deactivated if the timeclock-mode is active)

Duration format

The duration field supports entering data in the following formats:

Time span

  • Format: {hours}:{minutes}, {hours}:{minutes}:{seconds}
  • Description: Seconds are optional, leading zero can be skipped, overflow is supported for every field
  • Examples: 2:27 = 2 hours and 27 minutes, 3:143:13 = 5 hours and 23 minutes and 13 seconds

Time interval (ISO 8601)

  • Format: {hours}h, {hours}h{minutes}m, {hours}h{minutes}m{seconds}s
  • Description: Each section is optional, overflow is supported for every field, unit identifier can be written in lower and uppercase, seconds are supported but will be removed with activated rounding
  • Examples: 2h = 2 hours, 147m = 2 hours and 27 minutes, 3h14m = 3 hours and 14 minutes

Decimal duration

  • Format: {hours}, {hours,minutes in decimal}, {hours.minutes in decimal}
  • Description: Duration in hours, for decimal separator both . and , are supported, minutes need to be given as decimal portion (eg. 30 minutes = 0.5)
  • Examples: 1,5 = 1 hour and 30 minutes, 2 = 2 hours

Attention: Before Kimai 1.13 this format was treated as seconds (a format unusable for humans)

Please note:

  • using 0 or 00:00 as duration will also stop the entry with a duration of zero seconds
  • to create a running entry the end and duration field needs to be empty

Exported records

Exported records will be locked to prevent manipulation of cleared data.

The permission edit_exported_timesheet does allow editing and deletion of these locked entries nevertheless, which by default is given to users with ROLE_ADMIN and ROLE_SUPER_ADMIN.

The export state can be set manually or via the invoice and export screens.

Billable vs. not billable

Since version 1.14 you can define whether a timesheet record is billable or not.

None-billable timesheets are excluded from invoices and budget calculations.

The search drop-down supports filtering by the fields:

  • user (only in team timesheets)
  • daterange
  • customer
  • project
  • activity
  • tags
  • state (running / stopped)

Besides these filters, you can query for a free search term, which will be searched in the fields:

  • description

Additionally, you can filter for custom fields by using a search phrase like location:homeoffice. This would find all timesheets with the custom field location matching the term homeoffice.

The search terms will be found within the full value, so searching for office would find:

  • I love working in my office
  • Office
  • This office is beautiful
  • Our offices are very noisy

You can mix the search term and use multiple meta-field queries:

  • location:homeoffice hello world - find all timesheets matching the search term hello world with the custom field location matching the term homeoffice
  • location:homeoffice contract:foo foo - find all timesheets matching the search term foo with the custom field combination: location matching the term homeoffice and contract matching the term foo
  • location:homeoffice contract:foo - find all timesheets with the custom field combination: location matching the term homeoffice and contract matching the term foo