'\" 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 \- تغییر محدوده یک بازه زمانی
.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
دستور \*(Aqmodify\*(Aq برای تغییر محدوده یک بازه زمانی به کار می‌رود.
.sp
با استفاده از زیردستور \*(Aqstart\*(Aq یا \*(Aqend\*(Aq، می‌توان به‌ترتیب یک تاریخ شروع یا پایان جدید مشخص کرد، یا با استفاده از زیردستور \*(Aqrange\*(Aq، کل محدوده را تغییر داد.
بازه زمانی مورد نظر جهت ویرایش، با استفاده از شناسه آن مشخص می‌شود.
.sp
اگر بازه زمانی حاصل با یک بازه موجود همپوشانی پیدا کند، دستور خطایی برمی‌گرداند.
در این حالت می‌توان هینت \*(Aq:adjust\*(Aq را برای اعمال اجباری بازنویسی اضافه کرد.
.sp
برای چگونگی بازیابی شناسه بازه، \fBtimew\-summary\fP(1) را ببینید.
.SH "نکات (HINTS)"
.sp
دستور \*(Aqmodify\*(Aq هینت‌های زیر را می‌پذیرد:
.sp
\fB:fill\fP
.RS 4
هینت \*(Aq:fill\*(Aq می‌تواند به‌جای یک تاریخ یا محدوده تاریخ برای پر کردن شکاف بین بازه زمانی مورد ویرایش و بازه‌های مجاور آن استفاده شود.
برای زیردستورهای \*(Aqstart\*(Aq و \*(Aqend\*(Aq، هینت \*(Aq:fill\*(Aq به‌ترتیب شکاف بین بازه هدف و بازه بعدی یا قبلی را پر می‌کند.
برای زیردستور \*(Aqrange\*(Aq، شکاف‌های هر دو طرف بازه اصلاح‌شده را پر خواهد کرد.
.RE
.sp
\fB:adjust\fP
.RS 4
اگر بازه زمانی با یک بازه موجود همپوشانی داشته باشد، می‌توان هینت \*(Aq:adjust\*(Aq را برای اعمال اجباری ویرایش بازه اضافه کرد.
این کار بازه موجود را بازنویسی می‌کند.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
\fBتغییر تاریخ شروع یک بازه زمانی\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
این دستور زمان شروع بازه \*(Aq@3\*(Aq را به \*(Aq17:00\*(Aq در تاریخ \*(Aq2020\-12\-28\*(Aq تنظیم می‌کند.
اگر این تاریخ و زمان پس از پایان بازه باشد، دستور خطایی برمی‌گرداند.
.RE
.sp
\fBتغییر تاریخ پایان یک بازه زمانی\fP
.RS 4
.sp
اگر تاریخ بازه مورد ویرایش برابر با امروز باشد، می‌توان از ذکر آن صرف‌نظر کرد:
.sp
.if n .RS 4
.nf
.fam C
$ timew modify end @3 18:00
.fam
.fi
.if n .RE
.sp
مشابه ویرایش شروع بازه، تاریخ و زمان پایان نیز باید بعد از تاریخ و زمان شروع باشد.
.RE
.sp
\fBتغییر محدوده یک بازه زمانی\fP
.RS 4
.sp
به‌جای ویرایش جداگانه شروع و پایان، می‌توان آن‌ها را در یک فراخوانی واحد از زیردستور \*(Aqrange\*(Aq ترکیب کرد:
.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
مشابه مثال‌های بالا، اگر تاریخ بازه مربوط به امروز باشد، می‌توان بخش تاریخ را حذف کرد.
.RE
.sp
\fBتغییر محدوده یک بازه زمانی و پر کردن شکاف‌ها\fP
.RS 4
.sp
.if n .RS 4
.nf
.fam C
$ timew modify range @3 :fill
.fam
.fi
.if n .RE
.sp
این دستور بازه \*(Aq@3\*(Aq را ویرایش کرده و هرگونه شکاف بین این بازه و بازه‌های مجاور آن را به‌طور خودکار پر می‌کند.
.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)