The time entry format

- [ ] Homepage hero [est:: 3h] 📅 2026-10-16
  - ⏱ 2026-10-13 09:20-10:55 (1h35m)
  - ⏱ 2026-10-14 14:05-15:20 (1h15m) @Eglė — hero layout

nokko indents a new line two spaces past its task, or to match the task's first subtask if it has one. It adds the line at the end of the task's block. An author is written only when this Mac has been told who you are, with This is me on this Mac in People.

Each row below was run through nokko's parser. A line that fails stays in the file exactly as written, and shows as a note on the task with no time counted.

An end time earlier than the start means the span crossed midnight, so a day is added. One line therefore always covers less than 24 hours.

The line must sit in the task's block: indented deeper than the task, with nothing at the task's own indent in between. Blank lines do not end the block. A ⏱ line anywhere else is not counted.

• A line's minutes are the end time minus the start time. Totals are worked out each time they are shown and stored nowhere.
• A task's total adds every ⏱ line in its block, including lines under its subtasks.
• Reports and the timesheet walk top-level tasks only, so an hour is never counted twice. Time logged on a subtask appears under the top-level task that holds it.
• The day of a span is the date on the line, even when it runs past midnight.
• An invoice line sums its minutes first, then rounds up once to your increment (none, 6, 15 or 30 minutes). Splitting a session into two lines cannot change the bill.

The timer writes nothing for a run under a minute. Time with no task goes to Time/Unassigned.md, one task per day, in the same ⏱ format. See timers and timesheets and from hours to an invoice.

You can change these lines in Obsidian or any text editor. nokko never rewrites a line just because it read it.

1. 1Open the board's .md file and find the line under its task.
2. 2To change the time, edit the date or the two clock times. Updating the label is optional, but it keeps the file honest for people reading it.
3. 3To add an entry, copy an existing ⏱ line, paste it below and change it. Keep it indented under the same task.
4. 4To remove an entry, delete the whole line.
5. 5Save. nokko picks up the change, and the totals follow.

An invoice is its own file with its own figures. Changing a ⏱ line afterwards does not change an invoice you already made.

Obsidian shows a ⏱ line as an ordinary bullet under the task. It adds no timer and no total. The Tasks plugin leaves it alone, because the line has no checkbox. Dataview indexes it as a list item, which is what makes the queries below possible.

Dataview sees each entry as text. These queries read that text, so you can list and sum entries inside Obsidian. Change Client work to your own folder.

```dataview
TABLE WITHOUT ID L.text AS "Entry", file.link AS "Board"
FROM "Client work"
FLATTEN file.lists AS L
WHERE startswith(L.text, "⏱ ")
SORT L.text DESC
```

To see one month, change the test to startswith(L.text, "⏱ 2026-10"). Sorting works because the date comes first on the line.

```dataview
TABLE WITHOUT ID Board, sum(map(rows.L.text, (t) => dur(regexreplace(t, "^[^(]*[(]|[)].*$", "")))) AS "Logged"
FROM "Client work"
FLATTEN file.lists AS L
WHERE regextest("^⏱ [0-9-]+ [0-9:-]+ [(][0-9hm]+[)]", L.text)
GROUP BY file.link AS Board
```