mirror of
https://github.com/GothenburgBitFactory/timewarrior.git
synced 2025-06-26 10:54:28 +02:00
576af3fd5f
Additionally, this also makes the syntax of the `modify` command more flexible. Before, the sub-command had to follow right after the `modify` command, now one can also write it with the id between command and sub-command: ``` $ timew modify @1 start 09:30 ``` The `range` sub-command modifies both start and end time of the interval. It expects a range as parameter, e.g. ``` $ timew modify @3 range 08:15 - 13:37 ``` Closes #627 Signed-off-by: Thomas Lauf <thomas.lauf@tngtech.com>
51 lines
No EOL
1.6 KiB
Text
51 lines
No EOL
1.6 KiB
Text
= timew-modify(1)
|
|
|
|
== NAME
|
|
timew-modify - change the range of an interval
|
|
|
|
== SYNOPSIS
|
|
[verse]
|
|
*timew modify* (*start*|*end*) _<id>_ _<date>_
|
|
*timew modify* range _<id>_ _<range>_
|
|
|
|
== DESCRIPTION
|
|
The 'modify' command is used to change range of an interval.
|
|
|
|
Using the 'start' or 'end' subcommand, one can either specify a new start or end date respectively, or with the 'range' subcommand, change the complete range.
|
|
The interval to be modified is specified via its id.
|
|
|
|
If the resulting interval overlaps with an existing interval, the command will return an error.
|
|
One can the ':adjust' hint to force an overwrite in this case.
|
|
|
|
See **timew-summary**(1) on how to retrieve the interval id.
|
|
|
|
== EXAMPLES
|
|
*Modify the start date of an interval*::
|
|
+
|
|
$ timew modify start @3 2020-12-28T17:00
|
|
+
|
|
This sets the start of interval '@3' to '17:00' of date '2020-12-28'.
|
|
If this datetime is after the end of the interval, the command will return an error.
|
|
|
|
*Modify the end date of an interval*::
|
|
+
|
|
If the interval to be modified has the same date as today, it can be omitted:
|
|
+
|
|
$ timew modify end @3 18:00
|
|
+
|
|
Similar to when modifying the interval start, the end datetime has to be after the start datetime.
|
|
|
|
*Modify the range of an interval*::
|
|
+
|
|
Instead of modifying start and end separately, those can be combined into a single call of the 'range' subcommand:
|
|
+
|
|
$ timew modify range @3 2020-12-28T17:00 - 2020-12-28T18:00
|
|
+
|
|
As in the examples above, the date portion can be omitted, if the date of the interval is today.
|
|
|
|
== SEE ALSO
|
|
**timew-lengthen**(1),
|
|
**timew-move**(1),
|
|
**timew-resize**(1)
|
|
**timew-shorten**(1),
|
|
**timew-summary**(1) |