package timezone

Not available on OCaml 5.5
  1. Overview
  2. Docs

Description

Timezone handles parsing timezone data and create [Timezone.t] that can later be used to manipulate time in core_kernel or core.

Added to opam-repository:

README

Timezone for OCaml

Timezone handles parsing timezone data and create [Timezone.t] that can later be used to manipulate time in core (using [Time] and [Time_ns] modules).

Timezone is currently only able to read the Timezone Database provided by IANA. It should work out of the box on Linux and macOS.

Where are the timezone data located ?

The location of the timezone files can be set using the environment variable TZDIR. If not set, [Timezone] will fallback to /usr/share/zoneinfo/.

What is the local timezone ?

The local timezone can be set using the environment variable TZ. If not set, [Timezone] will fallback to /etc/localtime. In a JavaScript context, we automatically set the environment variable TZ to Intl.DateTimeFormat().resolvedOptions().timeZone.

Compatibility with JavaScript.

The [Timezone] library can be used when constructing JavaScript applications with Js_of_ocaml.

Node.js

[Timezone] should work out of the box when running on a Node.js environment on Linux or macOS. The file-system is accessible in that case.

Web browsers

In a web browser environment, the [Timezone] library requires some additional setup. One should generate a JavaScript file that will embed all timezone data required by the application. This can be done by using a tool provided by js_of_ocaml called jsoo_fs. The generated JavaScript file will have to be included in the HTML page before the JavaScript program itself.

For example, one can embed all timezones in all-tz.js with the following command:

grep -r TZif /usr/share/zoneinfo -l | xargs -n 1 -I {} echo {}:{} | xargs jsoo_fs -o all-tz.js

Example

open Core

let now = Time_ns.now ()

let () =
  Time_ns.to_sec_string now ~zone:(Lazy.force (Timezone.local))
  |> print_endline

let () =
  Time_ns.to_sec_string now ~zone:(Timezone.find_exn "America/New_York")
  |> print_endline

Please report bugs and feature requests on GitHub.

You can find all of Jane Street's open-source libraries on GitHub.

Documentation can be found here.

Dependencies (4)

  1. dune >= "2.0.0"
  2. ppx_jane >= "v0.15" & < "v0.16"
  3. core >= "v0.15" & < "v0.16"
  4. ocaml >= "4.08.0"

Dev Dependencies

None

Optional Dependencies

None

Used by (1)

  1. core_unix >= "v0.15.0" & < "v0.16.0"

Conflicts

None

Build status

Results of building timezone with each compiler on check.ci.ocaml.org, run of against opam-repository 8d8d144. All results for this package.

Each result links to its build log. To keep crawlers from overloading the site, build logs require a GitHub sign-in (see ocurrent/opam-health-check). On your first log, GitHub asks you to “Authorize opam-health-check”, the OCurrent app that runs these checks; it sees only your public profile, not your repositories. The sign-in lasts 30 days.

Version OCaml 4.11 OCaml 4.14 OCaml 5.2 OCaml 5.4 OCaml 5.5
v0.17.0 n/a n/a internal good good
v0.16.0 n/a good good n/a n/a
v0.15.0 (this version) good good n/a n/a n/a
  • good Package successfully built
  • partial One of the dependencies failed to build
  • bad Package failed to build
  • n/a Package is not available in this environment
  • internal Internal failure