Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TIMEW-MODIFY(1)			 User Manuals		       TIMEW-MODIFY(1)

NAME
       timew-modify - change the range of an interval

SYNOPSIS
       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 add the ':adjust' hint to force
       an overwrite in this case.

       See timew-summary(1) on how to retrieve the interval id.

HINTS
       The 'modify' command accepts the	following hints:

       :fill
	   The ':fill' hint can	be used	instead	of a date or date range	to
	   fill	the gap	between	the interval to	be modified and	its adjacent
	   intervals. For subcommands 'start' and 'end', the ':fill' hint will
	   fill	the gap	between	the targeted interval and the next or previous
	   interval respectively. For the 'range' subcommand, it will fill
	   gaps	on both	sides of the modified interval.

       :adjust
	   The ':adjust' hint can be added to force the	modification of	the
	   interval, if	it overlaps with an existing interval. This will
	   overwrite the existing interval.

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.

       Modify the range	of an interval and fill	gaps

	       $ timew modify range @3 :fill

	   This	modifies the interval '@3' and automatically fills any gaps
	   between this	interval and its adjacent intervals.

SEE ALSO
       timew-lengthen(1), timew-move(1), timew-resize(1), timew-shorten(1),
       timew-summary(1)

timew 1.9.1			  2025-08-27		       TIMEW-MODIFY(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=timew-modify&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help