نام (NAME)

timew-modify - تغییر محدوده یک بازه زمانی

خلاصه دستور (SYNOPSIS)

timew modify (start|end) <id> <date>
timew modify range <id> <range>

توضیحات (DESCRIPTION)

دستور 'modify' برای تغییر محدوده یک بازه زمانی به کار می‌رود.

با استفاده از زیردستور 'start' یا 'end'، می‌توان به‌ترتیب یک تاریخ شروع یا پایان جدید مشخص کرد، یا با استفاده از زیردستور 'range'، کل محدوده را تغییر داد. بازه زمانی مورد نظر جهت ویرایش، با استفاده از شناسه آن مشخص می‌شود.

اگر بازه زمانی حاصل با یک بازه موجود همپوشانی پیدا کند، دستور خطایی برمی‌گرداند. در این حالت می‌توان هینت ':adjust' را برای اعمال اجباری بازنویسی اضافه کرد.

برای چگونگی بازیابی شناسه بازه، timew-summary(1) را ببینید.

نکات (HINTS)

دستور 'modify' هینت‌های زیر را می‌پذیرد:

:fill

هینت ':fill' می‌تواند به‌جای یک تاریخ یا محدوده تاریخ برای پر کردن شکاف بین بازه زمانی مورد ویرایش و بازه‌های مجاور آن استفاده شود. برای زیردستورهای 'start' و 'end'، هینت ':fill' به‌ترتیب شکاف بین بازه هدف و بازه بعدی یا قبلی را پر می‌کند. برای زیردستور 'range'، شکاف‌های هر دو طرف بازه اصلاح‌شده را پر خواهد کرد.

:adjust

اگر بازه زمانی با یک بازه موجود همپوشانی داشته باشد، می‌توان هینت ':adjust' را برای اعمال اجباری ویرایش بازه اضافه کرد. این کار بازه موجود را بازنویسی می‌کند.

مثال‌ها (EXAMPLES)

تغییر تاریخ شروع یک بازه زمانی

$ timew modify start @3 2020-12-28T17:00

این دستور زمان شروع بازه '@3' را به '17:00' در تاریخ '2020-12-28' تنظیم می‌کند. اگر این تاریخ و زمان پس از پایان بازه باشد، دستور خطایی برمی‌گرداند.

تغییر تاریخ پایان یک بازه زمانی

اگر تاریخ بازه مورد ویرایش برابر با امروز باشد، می‌توان از ذکر آن صرف‌نظر کرد:

$ timew modify end @3 18:00

مشابه ویرایش شروع بازه، تاریخ و زمان پایان نیز باید بعد از تاریخ و زمان شروع باشد.

تغییر محدوده یک بازه زمانی

به‌جای ویرایش جداگانه شروع و پایان، می‌توان آن‌ها را در یک فراخوانی واحد از زیردستور 'range' ترکیب کرد:

$ timew modify range @3 2020-12-28T17:00 - 2020-12-28T18:00

مشابه مثال‌های بالا، اگر تاریخ بازه مربوط به امروز باشد، می‌توان بخش تاریخ را حذف کرد.

تغییر محدوده یک بازه زمانی و پر کردن شکاف‌ها

$ timew modify range @3 :fill

این دستور بازه '@3' را ویرایش کرده و هرگونه شکاف بین این بازه و بازه‌های مجاور آن را به‌طور خودکار پر می‌کند.

همچنین ببینید (SEE ALSO)

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