beautypg.com

Time, Time, tim – Visara Master Console Center Scripting Guide User Manual

Page 200

background image

Chapter 5 Script Commands

Scripting Guide

200

TIME

Syntax:

TIME( [$TimeString]) ==> %MidnightSeconds

Description:

Converts a time string to a time value.

Action:

The time string is converted to midnight seconds. Midnight seconds

can be used in time calculations.

Parameters:

$TimeString. String expression. Optional. The time string to

convert. Must be in the 24-hour clock format “HH:MM:SS”. “HH”

represents the hours (00-23), “MM” represents the minutes (00-59), and
“SS” represents the seconds (00-59). “:” is the separator. If TimeString

not specified, the current system time is used.

Returns:

Numeric value. The time expressed as the number of seconds past

midnight. Zero is 00:00:00 (midnight) and 86,399 is 23:59:59.

Notes:

1. Refer also to the description of Date/Time on page 40.
2. Do not feed the results of the TIME() command into TIMESTR();

use the SECONDS() command instead.

Example:

%Time := TIME()
%Time := TIME( “04:08”)
$Time := “14:32”
%Time := TIME( $Time)
%Time := #14:32#

// literal time value

See Also:

DATE, SECONDS, TIMESTR, WAITFOR, WAITUNTIL