Module Ptime_clock

POSIX time clock.

Ptime_clock provides access to a system POSIX time clock and to the system's current time zone offset.

This time does not increase monotically and is subject to system calendar time adjustments. Use Mtime if you need monotonic wall-clock time to measure time spans.

Consult important information about error handling and platform support.

v0.8.5 - homepage

POSIX clock

val now : unit -> Ptime.t

now () is the current POSIX time, by definition always on the UTC timeline.

raises Sys_error

see error handling.

val period : unit -> Ptime.span option

period () is a positive POSIX time span representing the clock's period (if available).

System time zone offset

val current_tz_offset_s : unit -> Ptime.tz_offset_s option

current_tz_offset_s () is the system's current local time zone offset to UTC in seconds, if known. This is the duration local time - UTC time in seconds.

POSIX clock raw interface

val now_d_ps : unit -> int * int64

now_d_ps () is (d, ps) representing POSIX time occuring at d * 86'400e12 + ps POSIX picoseconds from the epoch 1970-01-01 00:00:00 UTC. ps is in the range [0;86_399_999_999_999_999L].

raises Sys_error

see error handling

val period_d_ps : unit -> (int * int64) option

period_d_ps () is if available Some (d, ps) representing the clock's picosecond period d * 86'400e12 + ps. ps is in the range [0;86_399_999_999_999_999L].

Error handling

Platform support