Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (H-K)
Guardian Procedure Calls Reference Manual—522629-013
7-50
INTERPRETTIMESTAMP Procedure
date-and-time output
INT:ref:8
returns an array containing the date and time of day. A value of -1 is returned in
word [0] if the supplied Julian timestamp is out of range (see “Considerations”).
This array has the following form:
[0] The Gregorian year (1984, 1985, ...)
[1] The Gregorian month (1-12)
[2] The Gregorian day of month (1-31)
[3] The hour of the day (0-23)
[4] The minute of the hour (0-59)
[5] The second of the minute (0-59)
[6] The millisecond of the second (0-999)
[7] The microsecond of the millisecond (0-999)
Considerations
•
INTERPRETTIMESTAMP checks that the Julian timestamp corresponds to a time
in the range 1 January 0001 00:00 through 31 December 10000 23:59:59.999999.
If the supplied value is out of range, the procedure returns a value of -1D in
ret-
date-time and -1 in date-and-time[0].
•
For additional information on Julian timestamps, see the description of the
JULIANTIMESTAMP procedure.
Example
RETURN^DATE^TIME := INTERPRETTIMESTAMP (JULIAN^TIME,
DATE^TIME);
Related Programming Manual
For programming information about the INTERPRETTIMESTAMP procedure, refer to
the
Guardian Programmer’s Guide.