86 lines
2.3 KiB
OCaml
86 lines
2.3 KiB
OCaml
(** Duration - conversions to various time units
|
|
|
|
A duration is represented in nanoseconds as an unsigned 64 bit integer.
|
|
This has a range of up to 584 years, or 213503 days, or 5124095 hours, or
|
|
307445734 minutes, or 18446744073 seconds, or 18446744073709 milliseconds,
|
|
or 18446744073709549 microseconds.
|
|
|
|
All functions converting to [t] raise [Invalid_argument] on out of bound
|
|
or negative input.
|
|
|
|
{e v0.2.1 - {{:https://github.com/hannesm/duration }homepage}}
|
|
*)
|
|
|
|
(** The type for a duration, exposed as an int64 to provide interoperability. *)
|
|
type t = int64
|
|
|
|
(** [pp ppf t] prints the duration in a concise way. *)
|
|
val pp : Format.formatter -> t -> unit
|
|
|
|
(** [of_us us] are the microseconds in nanoseconds. *)
|
|
val of_us : int -> t
|
|
|
|
(** [of_us_64 us] are the microseconds in nanoseconds. *)
|
|
val of_us_64 : int64 -> t
|
|
|
|
(** [of_ms ms] are the milliseconds in nanoseconds. *)
|
|
val of_ms : int -> t
|
|
|
|
(** [of_ms_64 ms] are the milliseconds in nanoseconds. *)
|
|
val of_ms_64 : int64 -> t
|
|
|
|
(** [of_sec s] are the seconds in nanoseconds. *)
|
|
val of_sec : int -> t
|
|
|
|
(** [of_sec_64 s] are the seconds in nanoseconds. *)
|
|
val of_sec_64 : int64 -> t
|
|
|
|
(** [of_min m] are the minutes in nanoseconds. *)
|
|
val of_min : int -> t
|
|
|
|
(** [of_hour h] are the hours in nanoseconds. *)
|
|
val of_hour : int -> t
|
|
|
|
(** [of_day d] are the days in nanoseconds. *)
|
|
val of_day : int -> t
|
|
|
|
(** [of_year y] are the years in nanoseconds. *)
|
|
val of_year : int -> t
|
|
|
|
(** [of_f f] is the floating point seconds in nanoseconds. *)
|
|
val of_f : float -> t
|
|
|
|
|
|
(** [to_us t] are the microseconds of [t]. *)
|
|
val to_us : t -> int
|
|
|
|
(** [to_us_64 t] are the microseconds of [t]. *)
|
|
val to_us_64 : t -> int64
|
|
|
|
(** [to_ms t] are the milliseconds of [t]. *)
|
|
val to_ms : t -> int
|
|
|
|
(** [to_ms_64 t] are the milliseconds of [t]. *)
|
|
val to_ms_64 : t -> int64
|
|
|
|
(** [to_sec t] are the seconds of [t]. *)
|
|
val to_sec : t -> int
|
|
|
|
(** [to_sec_64 t] are the seconds of [t]. *)
|
|
val to_sec_64 : t -> int64
|
|
|
|
(** [to_min t] are the minutes of [t]. *)
|
|
val to_min : t -> int
|
|
|
|
(** [to_hour t] are the hours of [t]. *)
|
|
val to_hour : t -> int
|
|
|
|
(** [to_day t] are the days of [t]. *)
|
|
val to_day : t -> int
|
|
|
|
(** [to_year t] are the years of [t]. *)
|
|
val to_year : t -> int
|
|
|
|
(** [to_f t] is the floating point representation of [t]. *)
|
|
val to_f : t -> float
|
|
|