Return the current time of day (hours) on a given time-scale.

Arguments:

TimeScale scale

The type of time wanted, from:

• utc - Universal Coordinated Time.
• lst - Local Sidereal Time.

Return value:

The current time, expressed in hours.

Example 1:

The following example displays the current local sidereal time in hours.

 print $time(lst)

Example 2:

The following example halts script execution until the same time tomorrow.

 Date d = $tomorrow + $time(utc)
 until $date > $d

Note that if this example were changed to:

 until $date > $tomorrow + $time(utc)

the script would never resume because the until command continually re-executes its arguments, and tomorrow would always remain a day in the future.