Description:
Convert the information
in the structure pointed to by TSTRCT to a character string. TSTRCT should have been set by a call to
PSX_LOCALTIME or
PSX_GMTIME.
Invocation
CALL PSX_ASCTIME( TSTRCT, STRING, STATUS )
Arguments
TSTRCT = POINTER (Given)
The pointer to the time structure.
STRING = CHARACTER
(
) (Returned)
The character string representation of the time.
STATUS = INTEGER (Given)
The global status.
Examples:
| | CALL PSX_TIME( NTICKS, STATUS ) |
| | CALL PSX_LOCALTIME( NTICKS, SEC, MINS, HOUR, DAY, MONTH, YEAR, |
| : | WDAY, YDAY, ISDST, TSTRCT, STATUS ) |
| | CALL PSX_ASCTIME( TSTRCT, STRING, STATUS ) |
| | PRINT ,’The time is ’, STRING |
Prints the current local time as something like:
"Wed Apr 17 09:01:04 1991" (without the quotes). Notes:
- TSTRCT is declared to be of type
POINTER. This is usually represented in FORTRAN as an INTEGER, although any type that uses the
same amount of storage would be just as good.
-
The C string returned by the function localtime contains a new line character. This is removed before
being passed back to the calling FORTRAN routine.
-
The actual argument corresponding to STRING should be at least 24 characters long.
External Routines Used
cnf: cnfCptr, cnfExprt
References
-
POSIX standard (1988), section 8.1
-
ANSI C standard (1989), section 4.12.3.1
Copyright
Copyright (C) 1991 Science & Engineering
Research Council
Copyright © 2000 Council for the Central Laboratory of the Research Councils, 2006 Particle Physics
and Astronomy Research Council