Module Ecaml.Elisp_time

Elisp's analog of Core.Time_ns, but with picosecond precision and a wider range of allowed times.

(Info-goto-node "(elisp)Time of Day")

type t = private Ecaml__.Import.Value.t
val compare : t -> t -> int
include Ecaml__.Import.Value.Subtype with type t := t
type value
type t = private value

We expose private value for free identity conversions when the value is nested in some covariant type, e.g. (symbols : Symbol.t list :> Value.t list) rather than List.map symbols ~f:Symbol.to_value.

val sexp_of_t : t -> Ppx_sexp_conv_lib.Sexp.t
val eq : t -> t -> bool

eq t1 t2 = Value.eq (to_value t1) (to_value t2), i.e. eq checks whether the Emacs values underlying t1 and t2 are physically equal. This is different than phys_equal t1 t2, because we don't always wrap eq Emacs values in phys_equal OCaml values. I.e. phys_equal t1 t2 implies eq t1 t2, but not the converse.

val is_in_subtype : value -> bool
include Ecaml_value__.Valueable0.S with type t := t
type t
type 'a type_
val of_value_exn : Ecaml_value__.Value0.t -> t
val to_value : t -> Ecaml_value__.Value0.t
val type_ : t type_
val t : t type_
val format : t -> format_string:string -> string

(describe-function 'format-time-string) (Info-goto-node "(elisp)Time Parsing")

val of_time_ns : Core_kernel.Time_ns.t -> t
val to_time_ns_exn : t -> Core_kernel.Time_ns.t

to_time_ns_exn t ignores the sub-nanonsecond component of t. It raises if t is outside Time_ns.min_value and Time_ns.max_value.