時間段配置指令
1 display time-range
display time-range指令用來顯示時間段的配置和狀态資訊。
【指令】
display time-range { time-range-name | all }
【視圖】
任意視圖
【預設使用者角色】
network-admin
network-operator
【參數】
time-range-name:顯示指定名稱時間段的配置和狀态資訊。time-range-name表示時間段的名稱,為1~32個字元的字元串,不區分大小寫,必須以英文字母a~z或A~Z開頭。
all:顯示所有時間段的配置和狀态資訊。
【舉例】
# 顯示時間段t4的配置和狀态資訊。
<Sysname> display time-range t4
Current time is 17:12:34 11/23/2010 Tuesday
Time-range : t4 (Inactive)
10:00 to 12:00 Mon
14:00 to 16:00 Wed
from 00:00 1/1/2011 to 00:00 1/1/2012
from 00:00 6/1/2011 to 00:00 7/1/2011
表1-1 display time-range指令顯示資訊描述表
字段 | 描述 |
Current time | 系統目前的時間 |
Time-range | 時間段的配置資訊,包括: · 時間段的名稱 · 時間段的狀态,包括Active(生效)和Inactive(未生效)兩種狀态 · 時間段的時間範圍 |
2 time-range
time-range指令用來建立一個時間段,來描述一個特定的時間範圍。如果指定的時間段已經建立,則本指令可以修改時間段的時間範圍。
undo time-range指令用來删除一個時間段。
【指令】
time-range time-range-name { start-time to end-time days [ from time1 date1 ] [ to time2 date2 ] | from time1 date1 [ to time2 date2 ] | to time2 date2 }
undo time-range time-range-name [ start-time to end-time days [ from time1 date1 ] [ to time2 date2 ] | from time1 date1 [ to time2 date2 ] | to time2 date2 ]
【預設情況】
不存在時間段。
【視圖】
系統視圖
【預設使用者角色】
network-admin
【參數】
time-range-name:指定時間段的名稱,為1~32個字元的字元串,不區分大小寫,必須以英文字母a~z或A~Z開頭。為避免混淆,時間段的名稱不允許使用英文單詞all。
start-time to end-time:指定周期時間段的時間範圍。start-time表示起始時間,格式為hh:mm,取值範圍為00:00~23:59;end-time表示結束時間,格式為hh:mm,取值範圍為00:00~24:00,且結束時間必須大于起始時間。
days:指定周期時間段在每周的周幾生效。本參數可輸入多次,但後輸入的值不能與此前輸入的值完全重疊(譬如輸入6後不允許再輸入Sat,但允許再輸入off-day),系統将取各次輸入值的并集作為最終值(譬如依次輸入1、Wed和working-day之後,最終生效的時間将為每周的工作日)。本參數可輸入的形式如下:
· 數字:取值範圍為0~6,依次表示周日~周六;
· 周幾的英文縮寫(從周日到周六依次為Sun、Mon、Tue、Wed、Thu、Fri和Sat);
· 工作日(working-day):表示從周一到周五;
· 休息日(off-day):表示周六和周日;
· 每日(daily):表示一周七天。
from time1 date1:指定絕對時間段的起始時間。time1的格式為hh:mm,取值範圍為00:00~23:59。date1的格式為MM/DD/YYYY或YYYY/MM/DD。MM表示月,取值範圍為1~12;DD表示日,取值範圍取決于所輸入的月份;YYYY表示年,取值範圍為1970~2100。若未指定本參數,絕對時間段的起始時間将為系統可表示的最早時間,即1970年1月1日0點0分。
to time2 date2:指定絕對時間段的結束時間。time2的格式為hh:mm,取值範圍為00:00~24:00。date2的格式為MM/DD/YYYY或YYYY/MM/DD。MM表示月,取值範圍為1~12;DD表示日,取值範圍取決于所輸入的月份;YYYY表示年,取值範圍為1970~2100。結束時間必須大于起始時間。若未指定本參數,絕對時間段的結束時間将為系統可表示的最晚時間,即2100年12月31日24點0分。
【使用指導】
如果指定名稱的時間段不存在,則建立一個新的時間段(最多1024個);如果指定名稱的時間段已存在,則對舊時間段進行修改,即在其原有内容的基礎上疊加新的内容。
在一個時間段中,可以使用以下兩種方式定義時間範圍:
· 使用start-time to end-time days這組參數所建立的時間段為周期時間段,它将以一周為周期循環生效。
· 使用from time1 date1和to time2 date2這組參數所建立的時間段為絕對時間段,它将在指定時間範圍内生效。
如果一個時間段中同時包含以上兩種時間範圍,将取周期時間段和絕對時間段的交集作為生效的時間範圍。例如在一個時間段中定義周期時間段為每周一的8點到12點,定義絕對時間段為2015年全年,那麼該時間段的生效時間範圍為2015年全年内每周一的8點到12點。
一個時間段内可包含一或多個周期時間段(最多32個)和絕對時間段(最多12個),當包含有多個周期時間段和絕對時間段時,系統将先分别取各周期時間段的并集和各絕對時間段的并集,再取這兩個并集的交集作為該時間段最終生效的時間範圍。
【舉例】
# 建立名為t1的時間段,其時間範圍為每周工作日的8點到18點。
<Sysname> system-view
[Sysname] time-range t1 08:00 to 18:00 working-day
# 建立名為t2的時間段,其時間範圍為2011年全年。
<Sysname> system-view
[Sysname] time-range t2 from 00:00 1/1/2011 to 24:00 12/31/2011
# 建立名為t3的時間段,其時間範圍為2011年全年内每周休息日的8點到12點。
<Sysname> system-view
[Sysname] time-range t3 08:00 to 12:00 off-day from 00:00 1/1/2011 to 24:00 12/31/2011
# 建立名為t4的時間段,其時間範圍為2011年1月和6月内每周一的10點到12點以及每周三的14到16點。
<Sysname> system-view
[Sysname] time-range t4 10:00 to 12:00 1 from 00:00 1/1/2011 to 24:00 1/31/2011
[Sysname] time-range t4 14:00 to 16:00 3 from 00:00 6/1/2011 to 24:00 6/30/2011
【相關指令】
· display time-range