Guardian Procedure Calls Reference Manual

errormask
output
INT:ref:1
is a bit array that indicates any error in the date-n-time parameter. The errormask
parameter checks each element of date-n-time for validity. If errormask is omitted,
date-n-time is not checked.
An error is indicated if any of these bits contains a 1. The errormask bits are:
Year<0>
Month<1>
Day<2>
Hour of day<3>
Minute of hour<4>
Second of minute<5>
Millisecond of second<6>
Microsecond of millisecond<7>
If more than one bit is set, the combination of elements is bad; which element is actually in
error is unknown. For example, 01100000 00000000 is returned for April 31, in which case
it is unknown whether April is in error or 31.
Returned Value
FIXED
A 64-bit Julian timestamp, computed from date-n-time.
Considerations
• A 64-bit Julian timestamp is based on the Julian date. It is a quantity equal to the number of
microseconds since January 1, 4713 B.C., 12:00 (noon) Greenwich mean time (Julian proleptic
calendar). This timestamp can represent either Greenwich mean time, local standard time, or
local civil time. There is no way to examine a Julian timestamp and determine which of the
three times it represents.
• Procedures that work with the 64-bit Julian timestamp are COMPUTETIMESTAMP,
CONVERTTIMESTAMP, INTERPRETTIMESTAMP, JULIANTIMESTAMP, and
SYSTEMCLOCK_SET_/SETSYSTEMCLOCK.
• For a more complete description of 48-bit and 64-bit timestamps, see the TIMESTAMP Procedure
(page 1424) or the JULIANTIMESTAMP Procedure (page 747).
Related Programming Manual
For programming information about the COMPUTETIMESTAMP procedure, see the Guardian
Programmer's Guide.
184 Guardian Procedure Calls (C)