convertclock dateString ?GMT|{}? ?baseClock? Convert dateString to an integer clock value (see getclock). This command can parse and convert vir- tually any standard date and/or time string, which can include standard time zone mnemonics. If only a time is specified, the current date is assumed. If the string does not contain a time zone mnemonic, the local time zone is assumed, unless the GMT argument is specified, in which case the clock value is calculated assuming that the speci- fied time is relative to Greenwich Mean Time. If baseClock is specified, it is taken as the current clock value. This is useful for determining the time on a specific day. The character string consists of zero or more spec- ifications of the following form: time - A time of day, which is of the form hh[:mm[:ss]] [meridian] [zone] or hhmm [meridian] [zone]. If no meridian is specified, hh is inter- preted on a 24-hour clock. date - A specific month and day with optional year. The acceptable formats are mm/dd[/yy], yyyy/mm/dd, monthname dd[, yy], dd monthname [yy], and day, dd monthname yy. The default year is the current year. If the year is less then 100, then 1900 is added to it. relative time - A specification relative to the current time. The format is number unit; accept- able units are year, fortnight, month, week, day, hour, minute (or min), and second (or sec). The unit can be specified as a singular or plural, as in 3 weeks. These modifiers may also be specified: tomorrow, yesterday, today, now, last, this, next, ago. The actual date is calculated according to the fol- lowing steps. First, any absolute date and/or time is processed and converted. Using that time as the base, day-of-week specifications are added. Next, relative specifications are used. If a date or day is specified, and no absolute or relative time is given, midnight is used. Finally, a correction is applied so that the correct hour of the day is pro- duced after allowing for daylight savings time dif- ferences. convertclock ignores case when parsing all words. The names of the months and days of the week can be abbreviated to their first three letters, with optional trailing period. Periods are ignored in any timezone or meridian values. Note that convertclock will convert symbolic time- zone names, but these are not standardized and there are conflicts with various parts of the world. Use GMT when trying to produce a portable time that can then be converted back to a numeric value. The only dates in the range 1902 and 2037 may be converted. Some examples are: convertclock "14 Feb 92" convertclock "Feb 14, 1992 12:20 PM PST" convertclock "12:20 PM Feb 14, 1992" This command is provided by Extended Tcl.