README · typeable/timezone-olson

git.iko.soy/typeable/timezone-olson

on 79a38a2 help sign in

49 lines 1.9 kB history raw

1timezone-olson version 0.1.0

3This package provides a parser and renderer for binary Olson timezone

4files whose format is specified by the tzfile(5) man page on Unix-like

5systems. For more information about this format, see

6<http://www.twinsun.com/tz/tz-link.htm>. Functions are provided for

7converting the parsed data into 'TimeZoneSeries' objects from the

8timezone-series package. On many platforms, binary Olson timezone

9files suitable for use with this package are available in the

10directory /usr/share/zoneinfo and its subdirectories on your computer.

12This version of timezone-olson is highly experimental. Expect there

13to be bugs, and do not rely on any stability of the exposed

14interfaces.

17For licensing information, see the BSD3-style license in the file

18LICENSE that was originally distributed by the author together with

19this file.

21This package is part of the time-ng project:

22http://projects.haskell.org/time-ng/

24Send suggestions, bug reports, and patches to:

25yitz@community.haskell.org

27INSTALLATION:

29To install the latest version of this package, make sure that

30cabal-install is installed on your system (it is if you have installed

31the Haskell Platform) and type the commands:

33cabal update

34cabal install timezone-olson

36TESTING UTILITIES:

38This package also provides two Haskell files, each of which can be

39compiled into a command-line utility that might be helpful for testing

40purposes.

42zhdump.hs: A clone of zdump(8), including most of its bugs, that

43 is usually present on systems that have an Olson timezone

44 database, except hzdump takes paths to timezone files

45 instead of timezone identifiers on the command line.

47catTZ: Read and parse a timezone file, then render it. With the

48 -i flag, interprets the timezone data as a TimeZoneSeries

49 object before rendering.