# PXFLOCALTIME

POSIX Subroutine: Converts a given elapsed time in seconds to local time.

## Module

USE IFPOSIX

CALL PXFLOCALTIME (isecnds,iatime,ierror)

isecnds | (Input) INTEGER(4). The elapsed time in seconds since 00:00:00 Greenwich Mean Time, January 1, 1970.
iatime | (Output) INTEGER(4). One-dimensional array with 9 elements containing numeric time data. The elements of iatime are returned as follows:
Element | Value
--- | ---
iatime(1) | Seconds (0-59)
iatime(2) | Minutes (0-59)
iatime(3) | Hours (0-23)
iatime(4) | Day of month (1-31)
iatime(5) | Month (1-12)
iatime(6) | Gregorian year (for example, 1990)
iatime(7) | Day of week (0-6, where 0 is Sunday)
iatime(8) | Day of year (1-366)
iatime(9) | Daylight savings flag (1 if daylight savings time is in effect; otherwise, 0)
ierror | (Output) INTEGER(4). The error status.

If successful, ierror is set to zero; otherwise, an error code.

The PXFLOCALTIME subroutine converts the time (in seconds since epoch) in the isecnds argument to the local date and time as described by the array iatime above.

Parent topic: POSIX* Library Routines