'\" t
.\"     Title: timew-modify
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2025-08-22
.\"    Manual: User Manuals
.\"    Source: timew 1.9.1
.\"  Language: English
.\"
.TH "TIMEW\-MODIFY" "1" "2025-08-22" "timew 1.9.1" "User Manuals"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
timew-modify \- change the range of an interval
.SH "SYNOPSIS"
.sp
.nf
\fBtimew modify\fP (\fBstart\fP|\fBend\fP) \fI<id>\fP \fI<date>\fP
\fBtimew modify\fP range \fI<id>\fP \fI<range>\fP
.fi
.br
.SH "DESCRIPTION"
.sp
The \*(Aqmodify\*(Aq command is used to change range of an interval.
.sp
Using the \*(Aqstart\*(Aq or \*(Aqend\*(Aq subcommand, one can either specify a new start or end date respectively, or with the \*(Aqrange\*(Aq subcommand, change the complete range.
The interval to be modified is specified via its id.
.sp
If the resulting interval overlaps with an existing interval, the command will return an error.
One can add the \*(Aq:adjust\*(Aq hint to force an overwrite in this case.
.sp
See \fBtimew\-summary\fP(1) on how to retrieve the interval id.
.SH "HINTS"
.sp
The \*(Aqmodify\*(Aq command accepts the following hints:
.sp
\fB:fill\fP
.RS 4
The \*(Aq:fill\*(Aq 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 \*(Aqstart\*(Aq and \*(Aqend\*(Aq, the \*(Aq:fill\*(Aq hint will fill the gap between the targeted interval and the next or previous interval respectively.
For the \*(Aqrange\*(Aq subcommand, it will fill gaps on both sides of the modified interval.
.RE
.sp
\fB:adjust\fP
.RS 4
The \*(Aq:adjust\*(Aq hint can be added to force the modification of the interval, if it overlaps with an existing interval.
This will overwrite the existing interval.
.RE
.SH "EXAMPLES"
.sp
\fBModify the start date of an interval\fP
.RS 4
.sp
.if n .RS 4
.nf
.fam C
$ timew modify start @3 2020\-12\-28T17:00
.fam
.fi
.if n .RE
.sp
This sets the start of interval \*(Aq@3\*(Aq to \*(Aq17:00\*(Aq of date \*(Aq2020\-12\-28\*(Aq.
If this datetime is after the end of the interval, the command will return an error.
.RE
.sp
\fBModify the end date of an interval\fP
.RS 4
.sp
If the interval to be modified has the same date as today, it can be omitted:
.sp
.if n .RS 4
.nf
.fam C
$ timew modify end @3 18:00
.fam
.fi
.if n .RE
.sp
Similar to when modifying the interval start, the end datetime has to be after the start datetime.
.RE
.sp
\fBModify the range of an interval\fP
.RS 4
.sp
Instead of modifying start and end separately, those can be combined into a single call of the \*(Aqrange\*(Aq subcommand:
.sp
.if n .RS 4
.nf
.fam C
$ timew modify range @3 2020\-12\-28T17:00 \- 2020\-12\-28T18:00
.fam
.fi
.if n .RE
.sp
As in the examples above, the date portion can be omitted, if the date of the interval is today.
.RE
.sp
\fBModify the range of an interval and fill gaps\fP
.RS 4
.sp
.if n .RS 4
.nf
.fam C
$ timew modify range @3 :fill
.fam
.fi
.if n .RE
.sp
This modifies the interval \*(Aq@3\*(Aq and automatically fills any gaps between this interval and its adjacent intervals.
.RE
.SH "SEE ALSO"
.sp
\fBtimew\-lengthen\fP(1),
\fBtimew\-move\fP(1),
\fBtimew\-resize\fP(1),
\fBtimew\-shorten\fP(1),
\fBtimew\-summary\fP(1)