TIME8 (The GNU Fortran Compiler)

### 8.286 `TIME8` — Time function (64-bit) ¶

Synopsis:

  `RESULT = TIME8()`

Description:

  Returns the current time encoded as an integer (in the manner of the function `time(3)` in the C standard library). This value is suitable for passing to `CTIME` — Convert a time into a string, `GMTIME` — Convert time to GMT info, and `LTIME` — Convert time to local time info.

  Warning: this intrinsic does not increase the range of the timing values over that returned by `time(3)`. On a system with a 32-bit `time(3)`, `TIME8` returns a 32-bit value, even though it is converted to a 64-bit `INTEGER(8)` value. That means overflows of the 32-bit value can still occur. Therefore, the values returned by this intrinsic might be or become negative or numerically less than previous values during a single run of the compiled program.

Class:

  Function

Return value:

  The return value is a scalar of type `INTEGER(8)`.

Standard:

  GNU extension

See also:

  `DATE_AND_TIME` — Date and time subroutine,
  `CTIME` — Convert a time into a string,
  `GMTIME` — Convert time to GMT info,
  `LTIME` — Convert time to local time info,
  `MCLOCK8` — Time function (64-bit),
  `TIME` — Time function