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

"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" 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.

The list is available in two formats:

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

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"

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.

TimeAndDate.com uses your language to display its date and time. Version 1.3.1 introduces the ability for TimeZone to interogate TimeAndDate.com for the current user's language settings. Generally this should function correctly without interaction from the user; this section only exists if something goes wrong.

Use INI Locale	If enabled TimeZone will use the settings in TimeZone.ini. Manually setting the days in the ini file should only be done if the automatic process fails. The ini file simply sets the text that TimeAndDate.com uses in its Day Time string for the Day. For example, the Norwegian setting would be: sun=søn mon=man tue=tir wed=ons thu=tor fri=fre sat=lør
Page	This button will open the TimeAndDate.com page where the language can be investigated / set.
Log	TimeZone keeps a log of the html that TimeAndDate.com have used for the Days of the Week. This can be used to define the settings in the ini files.

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

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

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.

Version 1.4.0 introduces new functionality that will help TimeZone to maintain the correct times during Daylight Savings Time changes around the globe.

If enabled TimeZone will check each of your Favourite's times with the current time reported on TimeAndDate.com. If a discrepency is found TimeZone will download a fresh version of the data.

Check Favourites has the following setting:

Months

The months to check in comma separated numeric format: 1-12. If the field is blank then each month will be checked. DST switches generally during the Spring/Autumn seasons, but the actual dates are determined on an ad-hoc basis each year. All but one TimeAndDate.com location is covered by the default "3,4,9,10,11", but this can be edited to suit your own list of Favourites. DST dates can be checked at TimeAndDate.com.

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

Favourites are displayed in FARR in the same order as arranged in the Settings list.

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.

Adding a Favourite

Select the time zone in the dropdown list, complete the other settings and click the Add button.

Editing a Faviourite

Double-Click the Favourite in the ListView to edit it. Click the Save button to save your changes back to the list.

Editing the List

The order of the list can be changed when an entry is being edited by using the Up and Down buttons.

Deleting a Favourite

Double-Click the Favourite in the ListView to edit it, click the Delete button.

The example settings above will display the following default results:

Saves the settings. As of Version 1.4.0 a backup of the previous version will be generated (timezone.ini.bak).

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.

The Alt-Shortcut for the Settings condrols can be edited in the Locale INI file by adding an ampersand (&) before the character to be the accelerator.

For example: to change the accelerator for the Launch in FARR checkbox to L:

1. Open your selected INI file in a text editor
2. Find the labelLaunchInFARR value pair
3. Change the value to: labelLaunchInFARR=&Launch in FARR

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!

If you find an error in the time calculation the logging function is still available. Please ensure that Logging is enabled, then create a zip file of the following files and email them to me:

• FindAndRunRobot\Plugins\TimeZone\Data\*
• FindAndRunRobot\Plugins\TimeZone\timezone.ini

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.