Simple TimeZone Converter Help

Quick Start

In its simplest form, all you need is to enter text in the first input area (Time). Ignore the rest.
The format is:

source to destination1 [, destination2,..., destinationN]

Where source is the time (and/or date) you want to convert from, destination is the TIMEZONE you want to convert to.
Timezones can be entered as "full timezones" (e.g. America/New_York), "short codes" (EST), or convenience names(e.g. "maryland","ca")
*see note on convenience names below

Valid Examples:

"9:30pm mar 14 2008 india to paris,london,amsterdam,MST"
"10:0 pm est to mst"
"10pm CST to IsT"
"november 12, 1990 14:00 america/new_york to pst"
"12 nov 2007 3pm pst to gmt"
"est to mst" (this will tell you what the current local time in est is in ist)
"paris to *" (* is a special directive to convert the source timezone to ALL convenience names defined)
"paris to **" (** is a special directive to convert the source timezone to ALL TIMEZONES available)


 As you can see, the text can be very free flowing and the parser accepts many variations.
You can play around and figure out what variations don't work.
The need was not to have a fool proof parser, but use one that accepts many acceptable formats.

Motivation

I wrote this timezone converter simply because I did not find any other timezone tool that let me convert very easily,
without having to go through complicated lists, selections etc. Ideally I wanted a single textbox where I could enter
nov 29 2006, 10:30am est to ist and that's it.

I also know that entering freeform text may result in variations of text, and I should not be bothered with it.

This program can also take multiple destination timezones separated by commas
NOTE: If you want to see more details, while converting time, check the "Debug" box - it is quite useful, especially when
you think the conversion is not right. More likely, you entered something ambiguous and I did my best guess

Adding Convenience Mappings

You can add new convienence mappings ad-infinitum. Just click on the place on the form where it says "Click here" to add convenience
names and enter your new data in the new form. That's all. Please don't add junk..

If you are using a local version then:

You can add any amount of convenience mappings. Just open "mycities.inc" and add away
The format is: convenience_name:timezone
example: to say "rockville" should map to "America/New_York", simply add:
rockville:America/New_York to the end of mycities.inc
Now, if you enter "8:30pm rockville to london", the program will know rockville is America/New_York

Source Code

Click here