Table of Contents
Advertisement
Parameters
time-range-name: Time range name, a case insensitive string of 1 to 32 characters. It must start with
an English letter and cannot be the English word of all to avoid confusion.
start-time: Start time of a periodic time range, in hh:mm format (24-hour clock), where hh is hours and
mm is minutes. Its value ranges from 00:00 to 23:59.
end-time: End time of the periodic time range, in hh:mm format (24-hour clock), where hh is hours and
mm is minutes. Its value ranges from 00:00 to 24:00. The end time must be greater than the start time.
days: Indicates on which day or days of the week the periodic time range is valid. You may specify
multiple values, in words or in digits, separated by spaces, but make sure that they do not overlap.
These values can take one of the following forms:
A digit in the range 0 to 6, respectively for Sunday, Monday, Tuesday, Wednesday, Thursday,
Friday, and Saturday.
Week in words, that is, Mon, Tue, Wed, Thu, Fri, Sat, or Sun.
working-day for Monday through Friday.
off-day for Saturday and Sunday.
daily for seven days of a week.
from time1 date1: Indicates the start time and date of an absolute time range. The time1 argument
specifies the time of the day in hh:mm format (24-hour clock), where hh is hours and mm is minutes.
Its value ranges from 00:00 to 23:59. The date1 argument specifies a date in MM/DD/YYYY or
YYYY/MM/DD format, where MM is the month of the year in the range 1 to 12, DD is the day of the
month in the range 1 to 31, and YYYY is the year in the usual Gregorian calendar in the range 1970 to
2100. If not specified, the start time is the earliest time available in the system, namely, 01/01/1970
00:00:00 AM.
to time2 date2: Indicates the end time and date of the absolute time range. The format of the time2
argument is the same as that of the time1 argument, but its value ranges from 00:00 to 24:00. The end
time must be greater than the start time. If not specified, the end time is the maximum time available in
the system, namely, 12/31/2100 24:00:00 PM. The format and value range of the date2 argument are
the same as those of the date1 argument.
Description
Use the time-range command to create a time range.
Use the undo time-range command to remove a time range.
You may create a maximum of 256 time ranges.
A time range can be one of the following:
Periodic time range created using the time-range time-range-name start-time to end-time days
command. A time range thus created recurs periodically on the day or days of the week.
Absolute time range created using the time-range time-range-name { from time1 date1 [ to time2
date2 ] | to time2 date2 } command. Unlike a periodic time range, a time range thus created does
not recur. For example, to create an absolute time range that is active between January 1, 2004
00:00 and December 31, 2004 23:59, you may use the time-range test from 00:00 01/01/2004 to
23:59 12/31/2004 command.
Compound time range created using the time-range time-range-name start-time to end-time days
{ from time1 date1 [ to time2 date2 ] | to time2 date2 } command. A time range thus created
recurs on the day or days of the week only within the specified period. For example, to create a
time range that is active from 12:00 to 14:00 on Wednesdays between January 1, 2004 00:00 and
14-4
Advertisement
Chapters
Table of Contents
