TimeZone

View Current World Times in FARR as you type.

This plugin allows you to display current times of major world cities based on your search criteria. Results can be in a "Country - State - City" or "City" form.

::Usage

Typing "tz" will present you with the 3 configuration utilities:

	Up to five favourite TimeZones can be set (via TimeZone Settings) that will display by default.
	Opens the Settings window so that TimeZone options can be changed.
	Downloads a fresh copy of the data from TimeAndDate.Com
	This file.

tz (.*)

"tz" followed by a space, and search characters, will display matching cities and their current time.

The search string will accept and use a Regular Expression.

tzs (.*)

"tzs" followed by a space, and search characters, will search DateAndTime.com for the search string.

The results of the search can be used to add a custom URL for Cities that are not available in the drop down.

::Options

List Type

The list is available in two formats:

Option	Example
City Name	Addis Ababa Wed 5:55 AM Guatemala Tue 8:55 PM Nassau Tue 9:55 PM Adelaide Wed 1:25 PM Halifax Tue 10:55 PM New Delhi Wed 8:25 AM
Country [- State ]- City	Afghanistan - Kabul Wed 7:27 AM Mexico - Federal District - Mexico City Tue 8:57 PM Algeria - Algiers Wed 3:57 AM Morocco - Casablanca Wed 2:57 AM Argentina - Buenos Aires Wed 12:57 AM Myanmar - Yangon Wed 9:27 AM Australia - Australian Capital Territory - Canberra Wed 1:57 PM Nepal - Kathmandu Wed 8:42 AM Australia - New South Wales - Sydney Wed 1:57 PM

Launch in FARR

Opens the selected city's TimeAndDate.com page in FARR's internal browser, otherwise the default external browser is used.

Download each Launch

Downloads a fresh version of the data file each time FARR is launched.

Log

Writes a log file for the download and data install process. If TimeZone is not reporting the correct times, this is the file to zip up and send me.

Date Format

The following format codes can be used to define the format of the date in the search results:

Field	Full Form	Short Form
Year	yyyy (4 digits)	yy (2 digits), y (2 or 4 digits)
Month	MMM (name or abbr.) NNN (abbr.)	MM (2 digits), M (1 or 2 digits)
Day of Month	dd (2 digits)	d (1 or 2 digits)
Day of Week	EE (name)	E (abbr)
Hour (1-12)	hh (2 digits)	h (1 or 2 digits)
Hour (0-23)	HH (2 digits)	H (1 or 2 digits)
Hour (0-11)	KK (2 digits)	K (1 or 2 digits)
Hour (1-24)	kk (2 digits)	k (1 or 2 digits)
Minute	mm (2 digits)	m (1 or 2 digits)
Second	ss (2 digits)	s (1 or 2 digits)
AM/PM	a

Examples:

"MMM d, y" matches:

January 01, 2000
Dec 1, 1900
Nov 20, 00

"M/d/yy" matches:

01/20/00
9/2/00

"MMM dd, yyyy hh:mm:ssa" matches:

"January 01, 2000 12:30:45AM"

Locale setting

Locales are loaded from the Locale directory and are simple ini files, feel free to make your own. Caution: FARR does not display Unicode correctly! If you create a new locale please send it through to me.

Favourites

Up to Five Favourites can be selected to display in FARR by default.

Favourites are displayed in FARR in the Settings order: Favourite 1 - First, Favourite 2 - Second, etc. If the Favourites are not enabled the Data Files need to be downloaded first.

Favourites can have the following settings:

TimeZone Timezone to use for this favourite.

URL The URL to use for this favourite. Selecting a new value in the TimeZone drop down will update the URL with the default value; if the required city is not available in the drop down a custom URL can be added here.

For example: Alice Springs is not available in the Drop Down List, but is in the Adelaide timezone and is available on TimeAndDate.com. The TimeZone would be set to Adelaide, the URL set to 929, the label set to Alice Springs.

Rep When checked on the Timezone label will be Replaced with the Favourite Label

Label The Favourite Label. The Favourite Label will be concatenated with the Timezone Label if the Replace checkbox is checked off.

Date Format The Date Format to use with this Favourite. This can be different for each Favourite.

The example settings above will display the following default results:
FARRTimeZoneResults.png, 52kB

::Tips

tzs can be used to search TimeAndDate.com for a particular city if it is not available in TimeZone.

For Example: typing tz Alice Spings will not produce a result in FARR, but it can be added as a Favourite; First the page parameter needs to be found from TimeAndDate.com, typing tzs Alice Spings will produce a result that will search TimeAndDate.com for the city. Find the page link that is titled "Current local time in..." and note the n parameter of the link. For Alice Springs the link is http://www.timeanddate.com/worldclock/city.html?n=929

Add a new Favourite in TimeZone Settings: In the Timezone dropdown select Adelaide (Alice Spings is in CST, ie Adelaide), change the default URL from 5 (Adelaide) to 929 (Alice Springs), check Replace, add Alice Spings to the Label.

Regardless of the Launch in FARR setting, you can use the Right Mouse Button Context Menu to open the url in the external browser.

There was an error reported where a particular timezone was displayed with the incorrect time. I have not found the problem, as the problem corrected itself, so I've added some logging functionality that will help find the problem if it surfaces again. If you do get some timezones that are incorrect, please zip up and send me the log (FindAndRunRobot\Plugins\TimeZone\Data\log.txt).

That bug has been fixed! But if you find an error in the time calculation the logging function is still available.

::Disclaimer

TimeZone is distributed "as is". No warranty of any kind is expressed or implied. You use at your own risk. The author will not be liable for data loss, damages, loss of profits or any other kind of loss while using or misusing this software.

::Credits

TimeZone uses the data published at TimeAndDate.com. I believe that TimeZone conforms to the Link Policy, and have informed the site owners of this project. TimeAndDate is a great site with lots of useful tools and information.