where	DAY	is one of ‘Sun’, ‘Mon’, ‘Tue’, ‘Wed’, ‘Thu’, ‘Fri’, ‘Sat’,
	XX	is an integer denoting the day of the month,
	TH	is one of ‘st’, ‘nd’, ‘rd’, ‘th’,
	MTH	is one of ‘Jan’, ‘Feb’, ‘Mar’, ‘Apr’, ‘May’, ‘Jun’, ‘Jul’, ‘Aug’, ‘Sep’, ‘Oct’, ‘Nov’, ‘Dec’,
	YEAR	is the year as a four digit integer,
	HR	is the hour,
	MN	is the minute,
	SC	is the second,
	MIL	is the millisecond.

If on entry the date in itime is invalid, the string returned is '** Illegal date/time **'

4 References

None.

5 Arguments

1: $itime (7)$ – Integer array Input

On entry: a date and time in the format returned by x05aaf.

$itime (1)$: Must contain the year as a positive integer.
$itime (2)$: Must contain the month, in the range $1$ –12.
$itime (3)$: Must contain the day, in the range $1$ to $p$ , where $p = 28$ , $29$ , $30$ or $31$ , depending on the month and year.
$itime (4)$: Must contain the hour, in the range $0$ –23.
$itime (5)$: Must contain the minute, in the range $0$ –59.
$itime (6)$: Must contain the second, in the range $0$ –59.
$itime (7)$: Must contain the millisecond, in the range $0$ –999.

6 Error Indicators and Warnings

None.

7 Accuracy

The day name included as part of the character string returned by this routine is calculated assuming that the date is part of the Gregorian calendar. This calendar has been in operation in Europe since 15 October 1582, and in Great Britain since 14 September 1752. Entry to this routine with a date earlier than these will, therefore, not return a day name that is historically accurate.

8 Parallelism and Performance

Background information to multithreading can be found in the Multithreading documentation.

x05abf is not threaded in any implementation.

9 Further Comments

Two dates stored in character string format, as returned by this routine, may be compared by x05acf.

10 Example

This example initializes a time in itime, and converts it to character format by a call to x05abf.

x05ab: FL CL CPP AD PY MB

NAG FL Interfacex05abf (date_​array_​string)

▸▿ Contents

1 Purpose

2 Specification

3 Description

4 References

5 Arguments

6 Error Indicators and Warnings

7 Accuracy

8 Parallelism and Performance

9 Further Comments

10 Example

10.1 Program Text

10.2 Program Data

10.3 Program Results

NAG FL Interface
x05abf (date_array_string)