M[UMPS] Functions - $H[OROLOG]

Approved for inclusion in a future ANSI M[UMPS] language standard.

This function returns a value that is related to the value of special variable $HOROLOG.

$HOROLOG(0) returns a string that is equal to the value of $HOROLOG, concatenated with a comma, concatenated with an integer number. This integer number is the time zone offset (number of seconds difference with Universally Coordinated Time).

$HOROLOG(1) returns a value that is similar to the value of $HOROLOG(0), the difference being that the second piece (number of seconds in local time since midnight) may be a fractional number.

$HOROLOG(-1) returns a value that is similar to the value of $HOROLOG, the difference being that the time is represented in UCT (Universally Coordinated Time) rather than local time, and that the second piece (number of seconds since midnight) may be a fractional number.

Assume that the actual time is 18 February 1991, 04:18:43 in Greenwich, England. A system in Washington DC with a high resolution clock would show at that moment:

Reference   Value
$HOROLOG   54834,83923
$HOROLOG(0)   54834,83923,18000
$HOROLOG(1)   54834,83923.43,18000
$HOROLOG(-1)   54835,15523.43

This document is © Ed de Moel, 1995-2005.
It is part of a book by Ed de Moel that is published under the title "M[UMPS] by Example" (ISBN 0-918118-42-5).
Printed copies of the book are no longer available.