tz-0.0.0.1: Time zones database and library

Copyright(C) 2014 Mihaly Barasz
LicenseApache-2.0, see LICENSE
MaintainerMihaly Barasz <klao@nilcons.com>
Stabilityexperimental
Safe HaskellNone
LanguageHaskell2010

Data.Time.Zones.Read

Description

 

Synopsis

Documentation

loadTZFromFile :: FilePath -> IO TZ Source

Reads and parses a time zone information file (in tzfile(5) aka. Olson file format) and returns the corresponding TZ data structure.

loadSystemTZ :: String -> IO TZ Source

Looks for the time zone file in the system timezone directory, which is /usr/share/zoneinfo, or if the TZDIR environment variable is set, then there.

loadLocalTZ :: IO TZ Source

Returns the local TZ based on the TZ and TZDIR environment variables.

See tzset(3) for details, but basically:

  • If TZ environment variable is unset, we loadTZFromFile "/etc/localtime".
  • If TZ is set, but empty, we loadSystemTZ "UTC".
  • Otherwise, we just loadSystemTZ it.

Note, this means we don't support POSIX-style TZ variables (like "EST5EDT"), only those that are explicitly present in the time zone database.

loadTZFromDB :: String -> IO TZ Source

Reads the corresponding file from the time zone database shipped with this package.