Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help

       tz_convert - Timezone converter from operating system tz	format into
       libical format used by Orage and	several	other calander tools.

       tz_convert [OPTION...] [INFILE]

       tz_convert is a command line tool, which	can be used to convert
       timezone	data from so called tz binary format, usually used in
       operating systems, to libical format, used by several calenders like

       There are several options available to only convert certain files or
       files in	certain	directory. Or only convert part	of the file and	ignore
       for example old data. It	is also	possible to add	new timezone files,
       which are based on old timezone data.

       There are tools,	which generate ical timezones data from	tz source
       database, but those are often not available for normal users and	are
       difficult to use. So often libical timezones are	not upto date.
       tz_convert reads	directly the binary tz data and	makes it possible to
       keep libical timezones up to date. The tool is mainly meant to be used
       by distro maintainers, but it should be easy and	clear enough for all

       tz timezone files often can be found in directory /usr/share/zoneinfo.
       For example Europe/Helsinki. libical timezone files needs to be where
       you calendar can	find them. For Xfce and	Orage systems they are located
       under your Xfce directory in share/orage/libical/zoneinfo. For example
       Europe/Helsinki.ics. (use locate	to find	them.)

       -V, --version
	   Print version information and exit.

       -?, --help
	   Show	this help message and exit.

	   Show	short usage summary.

       -i, --infile
	   tz file name	from operating system to convert from. If this is
	   directory, all files	in it are processed. Default is

       -o, --outfile
	   ical	timezone file name to be written. This can not be directory.
	   It is meant to be used together with	timezone parameter. This is
	   very	seldom used. Default is	timezone/infile.ics

       -m, --message
	   debug message level.	How much exra information is shown. 0 is least
	   and 10 is highest (1=default). May give usefull information when
	   things do not work as expected.

       -l, --limit
	   limit processing to newer than this year. Often there is a lot of
	   old data available, which is	not needed in normal day to day	work
	   and skipping	unused years helps to improve performance. Default is
	   to ignore older than	year 1970 time changes.

       -t, --timezone
	   timezone name to be used in the actual file.	Normally file name is
	   the same as timezone	name, but if you want to create	your own
	   timezone, you need new file name, which contains some known
	   timezone name. This is used together	with outfile parameter.

       -r, --norecursive
	   process only	main directory,	instead	of all subdirectories. 0 =
	   recursive 1 = only main directory (0=default).

       -c, --exclude count
	   number of excluded directories. 5 = default (You only need this if
	   you have more than 5	excluded directories). This is used together
	   with	exclude	parameter.

       -x, --exclude
	   do not process this directory, skip it. You can give	several
	   directories with separate parameters. By default directories	right
	   and posix are excluded, but if you use this parameter, you have to
	   specify those also. You need	to use exclude count if	you have more
	   than	5 exclude directories.

       -u, --norrule
	   do not use RRULE ical repeating rule, but use RDATE instead.	Not
	   all calendars are able to understand	RRULE correctly	with
	   timezones. (Orage should work fine with RRULE). 0 = use RRULE 1 =
	   do not use RRULE (0=default).

       Please report any bugs and enhancement requests to Note that tz_convert is part of orage	so
       bugs are	reported against orage and component tz_convert. Usage related
       questions can be	sent to email list.


       tz_convert was written by Juha Kautto <>.

       This manual page	was written by Juha Kautto <>.

				  05/28/2009			 TZ_CONVERT(1)


Want to link to this manual page? Use this URL:

home | help