Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-93
COMPUTETIMESTAMP Procedure
The range of the year is restricted from 1 through 10000.
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 the following bits contains a 1. The
errormask bits
are:
<0> year
<1> month
<2> day
<3> hour of day
<4> minute of hour
<5> second of minute
<6> millisecond of second
<7> microsecond of millisecond
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.
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
SETSYSTEMCLOCK.
•
For a more complete description of 48-bit and 64-bit timestamps, refer to the
TIMESTAMP or JULIANTIMESTAMP procedure.
Related Programming Manual
For programming information about the COMPUTETIMESTAMP procedure, refer to
the
Guardian Programmer’s Guide.