.nameit symbol=setsave text='When finished, press :hp2.Save settings:ehp2. button, to write settings to CLOCK.INI. If you want to reset changes, press :hp2.Default:ehp2. button to use standard settings.'
:pd.Most of windows and dialogs in &greename. have status line in the bottom of window (except World Time window - status line is in the Title bar).
If you move pointer over some control (button, checkbox, radio button, list, entry field ...), you will see short description of action you can perform if you select this control.
:pt.:hp2.Manual:ehp2.
:pd.Detailed explanation and instruction about &greename. can be found in this manual.
Colors and styles used in manual&colon.
.br
:hp2.Bold - title, important information, button or other control to be selected:ehp2.
.br
:hp4.Blue - link to related topic in this manual:ehp4.
.br
:hp8.Red - warning, caution:ehp8.
:pt.:hp2.Contacting the author:ehp2.
:pd.If you need more help, and can't find it here, or you think some important information is missing in this manual,
:hp7.REXX MUST BE INSTALLED ON YOUR SYSTEM TO RUN WORLD CLOCK AND INSTALL PROGRAM.:ehp7.
:p.
Installation program (Install.exe) enables you to&colon.
:ul compact.
:li.Install &greename. to selected drive / directory. If you have previous version of &greename. (1.10) installed, you can use existing settings (Selected cities, alarms, programs to launch and notes in calendar),
:li.ReInstall &greename. after you copied/moved files to other drive/directory and refresh existing values in USER (OS2.INI) and object on Desktop,
:li.UnInstall &greename. - remove specific values from USER (OS2.INI) and destroy
objects on Desktop.
:eul.
:parml compact tsize=5.
:pt.
:hp2.Files in archive clock111.zip&colon.:ehp2.
:pd.
:dl compact tsize=15.
:dt.:hp5.File name:ehp5.
:dd.:hp5.Description:ehp5.
:dt.Install.exe
:dd.Install/UnInstall program :hp8.required!:ehp8.
After you pressed :hp2.Install:ehp2. button, you will see Copyright notice, License agreement and Disclaimer.
Read this carefuly and press :hp2.I agree:ehp2. button if you want to install &greename..
:p.
Install procedure will do following&colon.
:ol compact.
:li.add &greename.'s specific values in USER (OS2.INI) file,
:li.create &greename.'s folder and programs objects on Desktop,
:li.write default values to &greename.'s INI file (CLOCK.INI),
:li.use selected Cities, Alarms, Launcher and Calendar settings from previous version (if you have version 1.10 installed).
:eol.
:nt.
if you want to use settings from previous version (1.10) DO NOT UNINSTALL PREVIOUS VERSION before you install version 1.11.
After you installed &greename. 1.11, you can uninstall &greename. 1.10. You can also keep &greename. 1.10 on your computer and run both versions.
:ent.
You can install &greename.&colon.
:ul compact.
:li.to suggested directory (C&colon.\Clock111),
:li.to current directory - where you started Install program (press :hp2.Current:ehp2. button),
:li.to other drive/directory (press :hp2.Other:ehp2. button, then select drive/directory),
:li.to new directory (enter name for new directory - Install program will create new directory and copy files to this directory).
:nt.
If you selected current directory as target directory for installation and &greename. is already installed in this directory,
current settings in CLOCK.INI file will be OVERWRITTEN with default settings.
:p.
Install program can create only ONE directory - for example&colon. you can create :hp2.c&colon.\Newdir:ehp2., but not :hp8.c&colon.\Newdir1\Newdir2:ehp8..
.br
:hp8.DO NOT select ROOT DIRECTORY as target directory!:ehp8.
:p.
If Install program find files in directory where you want to install &greename., they will be OVERWRITTEN.
:ent.
:eul.
:p.
After Install procedure is finished, and :hp2.Start World Clock on exit:ehp2. checkbox is selected, when you press :hp2.Exit:ehp2. button, &greename. will start.
:p.
If you copied &greename. to new drive/directory, start Install/UnInstall program again, and select Install.
Select :hp2.Current:ehp2. directory and select :hp2.Use existing settings:ehp2. checkbox.
Program will write new values in USER (OS2.INI) file, and refresh objects on Desktop.
When you start &greename. you will see selected cities with their time, date, UTC difference
(+hh&colon.mm = eastern hemisphere, -hh&colon.mm = western hemisphere) and Time Zone descriptor -
for Standard time or Daylight Savings time (DST). If city has DST, there is a small circle after
DST descriptor. In title bar is displayed UDT, UTC,and/or Internet time ("Swatch beat").
:p.
:hp2.To open PopUp menu, move mouse pointer on World Clock's area and press second mouse button (right-click by default).:ehp2.
:p.
If &greename. has focus, you can use keyboard for following actions&colon.
:dl compact tsize=15.
:dt.:hp2.M, Enter:ehp2.
:dd.Open PopUp menu
:dt.:hp2.F1, H:ehp2.
:dd.Help - open &greename.'s manual
:dt.:hp2.X, Alt-F4:ehp2.
:dd.Exit &greename.
:edl.
:p.
When Installation procedure finished and &greename. starts for first time, you have to configure it.
As &greename. gets the time and date from your computer's internal clock, you first have to select your Time Zone and your current Daylight Savings Time status.
To do this, select YOUR CITY as FIRST city of possible 9.
:p.
&greename. accepts one command-line parameter&colon. d (:hp2.Clock.exe d:ehp2.). Use this parameter if you want to start &greename. with default settings.
You can select how to display &greename. on the screen&colon.
:parml tsize=5.
:pt.:hp2.Standard view:ehp2.
:pd.This is default view. You can select display number (1 to 9) of 9 selected cities. For every city is displayed&colon.
.br
city and country, time zone descriptor, local time and date. You can select vertical or horizontal orientation,
normal or compact display, etc.
:pt.:hp2.Banner view:ehp2.
:pd.&greename.'s height is reduced to title bar and width is set to screen width. To set display in banner view, open Settings notebook and go to "Other" page.
You can select to display time for cities in standard view (or for all 9 selected cities) and position of banner view on the screen (top or bottom).
Display is scrolled from right to left and time is displayed in format hh&colon.mm (without seconds).
:pt.:hp2.Minimized view:ehp2.
:pd.&greename.'s height is reduced to title bar. In title bar is displayed city name and local time (for 1st city).
You can select to display time for all 9 selected cities - open Settings notebook, go to "Other" page and check :hp2.Change cities:ehp2..
Local time for every city will be displayed 10 seconds. Position of minimized view is the same as position of standard view.
:eparml.
:p.
On exit, last selected view is remembered, and when you start &greename. again, it will be displayed in last selected view.
:nt.
If you select banner or minimized view, CPU usage is lower than in standard view.
:ent.
.*
.* Panel definition : PopUp menu
.*
:h1 id=400 res=400 x=0% y=0% width=100% height=100% group=1.PopUp menu
:i1 id=400.PopUp menu
:p.
:hp2.To open PopUp menu, press second mouse button (right-click by default) on World Clock's area,
or press M or Enter (if World Clock has focus).:ehp2.
:p.
Items in PopUp menu are&colon.
:dl compact tsize=15.
:dt.:hp2.Display:ehp2.
:dd.normal or compact, horizontal or vertical orientation
:dt.:hp2.Position:ehp2.
:dd.position on the screen (top left, top right, bottom left, bottom right, center)
:dt.:hp2.View:ehp2.
:dd.standard (display city, country, time, date, UTC difference, TZ descriptor), minimized or banner view (display only city and time)
:dt.:hp2.Settings:ehp2.
:dd.open Settings notebook - configure &greename.
:dt.:hp2.Cities:ehp2.
:dd.view/change city's properties, add new/change/delete city, set Alarm and Program launcher, set TZ environment variable
:dt.:hp2.World Time:ehp2.
:dd.display Standard time (no DST!) in ALL Time Zones, World Map and distance between selected locations
:dt.:hp2.Stopwatch:ehp2.
:dd.start Stopwatch
:dt.:hp2.Calendar:ehp2.
:dd.display Calendar for current month/year
:dt.:hp2.Universal:ehp2.
:dd.display universal date &. time (UDT, UTC, "Swatch beat")
:dt.:hp2.Help:ehp2.
:dd.show Help for &greename.
:dt.:hp2.About:ehp2.
:dd.Program and Author
:dt.:hp2.Exit:ehp2.
:dd.leave &greename.
:edl.
:p.
If &greename. has focus, you can use keyboard to perform following actions&colon.
To open Settings notebook, press second mouse button (right-click by default) on &greename. area and select :hp2.Settings:ehp2. in PopUp menu.
All settings are grouped in following pages in Settings notebook&colon.
:dl compact tsize=15.
:dt.:hp2.General:ehp2.
:dd.Display, orientation, number of displayed cities, position, size, free space on the screen
:dt.:hp2.DateTime:ehp2.
:dd.Date and time settings
:dt.:hp2.System:ehp2.
:dd.Enable or disable various messages, Set font, Set system clock
:dt.:hp2.World:ehp2.
:dd.World Time and World map settings, select Language
:dt.:hp2.Other:ehp2.
:dd.Settings for Banner and Minimized view, Stopwatch and miscellaneous settings
:edl.
:p.
When finished , press :hp2.Save settings:ehp2. button, to write settings to CLOCK.INI.
If you want to reset changes, press :hp2.Default:ehp2. button to use &greename.'s standard settings.
:p.
To configure display in Title bar, select :hp2.Universal:ehp2. in PopUp menu and select display to see in Title bar - UDT, UTC, "Swatch beat".
:p.
If you select :hp2.Countdown:ehp2. checkbox in Alarm window, remaining time until alarm for selected city will be displayed in Titlebar - hh&colon.mm to (message) in (selected city).
:link reftype=hd res=890.International Standard ISO 8601:elink. is based on date format represented with
the largest units given first, i.e., from left to right the ranking is year, month, week, day.
:p.
Representation of date is available in following formats, where :hp2.1999-09-14:ehp2.
is sample date, hyphen(:hp2.-:ehp2.) is default separator, comma(:hp2.,:ehp2.) is decimal
sign and symbols are&colon.
:dl compact tsize=10.
:dt.:hp2.CC:ehp2.
:dd.century
:dt.:hp2.YY:ehp2.
:dd.year
:dt.:hp2.MM:ehp2.
:dd.month
:dt.:hp2.DD:ehp2.
:dd.date
:dt.:hp2.Www:ehp2.
:dd.week designator and ordinal number of a calendar week within the year
:dt.:hp2.DDD:ehp2.
:dd.ordinal number of a day within the year
:dt.:hp2.D:ehp2.
:dd.ordinal number of a day within calendar week (Monday = 1, ... Sunday = 7)
:dt.:hp2.MON:ehp2.
:dd.name of a calendar month (1 = January, 2 = February, ... 12 = December)
:edl.
:dl compact tsize=25.
:dt. 1. :hp2.CCYY MM DD:ehp2.
:dd.Complete representation - calendar year, ordinal number of a calendar month within the calenday year and ordinal number of a day within the calendar month (:hp2.1999-09-14:ehp2.)
:dt. 2. :hp2.CCYY MM:ehp2.
:dd.Reduced precision - calendar year and ordinal number of a calendar month within the calenday year (:hp2.1999-09:ehp2.)
:dt. 3. :hp2.CCYY:ehp2.
:dd.Reduced precision - calendar year (:hp2.1999:ehp2.)
:dt. 4. :hp2.MM DD:ehp2.
:dd.Truncated representation - specific day of a month (:hp2.09-14:ehp2.)
:dt. 5. :hp2.MM:ehp2.
:dd.Truncated representation - specific month (:hp2.09:ehp2.)
:dt. 6. :hp2.DD:ehp2.
:dd.Truncated representation - specific day (:hp2.14:ehp2.)
:dt. 7. :hp2.CCYY DDD:ehp2.
:dd.Complete representation - calendar year and ordinal day of a year (:hp2.1999-257:ehp2.)
:dt. 8. :hp2.DDD:ehp2.
:dd.Truncated representation - ordinal day of a year only (:hp2.257:ehp2.)
:dt. 9. :hp2.CCYY Www D:ehp2.
:dd.Complete representation - calendar year, ordinal number of a week within the year and ordinal number of a day within the week (:hp2.1999-W38-2:ehp2.)
:dt.10. :hp2.CCYY Www:ehp2.
:dd.Reduced precission - calendar year and ordinal number of a week within the year (:hp2.1999-W38:ehp2.)
:dt.11. :hp2.Www D:ehp2.
:dd.Truncated representation - week and day of the current year (:hp2.W38-2:ehp2.)
:dt.12. :hp2.Www:ehp2.
:dd.Truncated representation - week of the current year (:hp2.W38:ehp2.)
:dt.13. :hp2.D:ehp2.
:dd.Truncated representation - day of the current week (:hp2.2:ehp2.)
:dt.14. :hp2.DD MM CCYY:ehp2.
:dd.Ordinal number of a day within the calendar month, ordinal number of a calendar month within the calenday year and calendar year (:hp2.14-09-1999:ehp2.)
:dt.15. :hp2.DD MON CCYY:ehp2.
:dd.Ordinal number of a day within the calendar month, name of a calendar month within the calenday year and calendar year (:hp2.14-Sep-1999:ehp2.)
:dt.16. :hp2.MM DD CCYY:ehp2.
:dd.Ordinal number of a calendar month within the calendar year, ordinal number of a day within the calendar month and calendar year (:hp2.09-14-1999:ehp2.)
:dt.17. :hp2.MON DD CCYY:ehp2.
:dd.Name of a calendar month within the calenday year, ordinal number of a day within the calendar month and calendar year (:hp2.Sep-14-1999:ehp2.)
:edl.
:p.
Here are options in date display (example is for 1st date format - CCYY MM DD ss)&colon.
:parml compact tsize=5.
:pt.:hp2.Separator:ehp2.
:pd.If selected, date is displayed with separator between year, month and day (:hp2.1999-09-14:ehp2.)
You can select separator (hyphen (-), dot (.), slash (/) or space.
If you unselect this checkbox, date is displayed without separator between year, month and day (:hp2.19990914:ehp2.)
:pt.:hp2.Century and year (4-digit):ehp2.
:pd.If selected, century and year is displayed (:hp2.1999-09-14:ehp2.). If you unselect this checkbox, year in current century is displayed (:hp2.99-09-14:ehp2.).
:pt.:hp2.Show day of week:ehp2.
:pd.If selected, day of week (Monday, Tuesday, ... Sunday) is displayed before date, separated with comma (:hp2.Tue, 1999-09-14:ehp2.)
:pt.:hp2.Leading zeroes:ehp2.
:pd.If selected, months, days, weeks are displayed in 2-digit format.
:eparml.
:nt.
If you select display without separator, then hours and minutes are displayed in 2-digit format (leading zeroes).
Also, if you select display without leading zeroes, separator is displayed. This is required for readable display of time.
:p.
Formats 14, 15, 16 and 17, display without leading zeroes and using other separator than hyphen
are not recommended by International Standard ISO 8601, but they are still in use in many countries.
:dd.&greename. did not find SET TZ environment variable in CONFIG.SYS.
:dt.:hp2.Wrong TZ variable:ehp2.
:dd.SET TZ= environment variable in CONFIG.SYS is incomplete.
:dt.:hp2.Different TZ variables:ehp2.
:dd.SET TZ= environment variable in CONFIG.SYS and values for 1st of 9 selected cities are different.
:dt.:hp2.Error in CLOCK.INI:ehp2.
:dd.Some values in configuration file (CLOCK.INI) are wrong or missing. Default values will be loaded.
:dt.:hp2.New city selected:ehp2.
:dd.One of 9 selected cites is selected from the city list.
:dt.:hp2.Alarm or Program is set:ehp2.
:dd.Alarm or Program at specified time for one of 9 selected cities is set.
:dt.:hp2.World map not found:ehp2.
:dd.&greename. did not find World map (World.met).
:edl.
:pt.:hp2.Open Font Palette:ehp2.
:pd.To change &greename.'s font, press :hp2.Open Font Palette:ehp2. button, then drag and drop font you want to use with &greename. on white rectangular with Font name.
:pt.:hp2.Set computer's system clock:ehp2.
:pd.Press :hp2.Set computer's system clock:ehp2. button to open System clock, set date and/or time, close System clock and press :hp2.Refresh date and time:ehp2. to accept changes.
To open Cities window, press second mouse button (right-click by default) on &greename. area and select Cities in PopUp menu.
Here is a list of all 9 cities with their properties&colon.
:ul compact.
:li.Sunrise, Sunset, Day length for current date - in hh&colon.mm (24-hour format) in local Standard time. For DST add one hour,
:li.Coordinates - Latitude (89°.59'S-89°.59'N) and Longitude (179°.59'W-179°.59'E)
:li.Universal Time (UTC) difference, Daylight Savings Time (DST) - start date and end date, Time Zone descriptor - for Standard and Summer (DST) time,
:li.Alarm&colon. - time, text, options,
:li.Program launcher&colon. - time, program, directory, parameters.
:eul.
:p.To see distance between 9 selected cities press :hp2.Distance:ehp2. button. Select one of cities in the list to see distance to other cities.
.br
Distance is displayed in kilometers (:hp2.km:ehp2.), miles (:hp2.mi:ehp2. = 1.609 km) or nautical miles (:hp2.nm:ehp2. = 1.852 km).
.br
To view 9 selected cities in the world map, or to calculate distance between two locations in the world, open :hp2.World Time:ehp2. window.
:p.
To add new city to list, change one of 9 selected cities (select new), select city you want
to change and press the :hp2.Select new city from list or change properties for City, Country:ehp2. button
(where City and Country is selected one).
.br
For example&colon. if you want to change 3rd city,select 3rd city in the list area and press the :hp2.Select new city from list or change properties for City, Country:ehp2. button.
:p.
New window with list of all cities will open.
:nt.
If one of 9 selected cities is missing, program loads :hp5.UTC, Coordinated Universal Time:ehp5..
.br
If values for one of 9 selected cities are missing or wrong, program loads values for :hp5.UTC, Coordinated Universal Time:ehp5..
You can later select this city and write correct data.
.br
If there are missing or wrong data for city, you will see error message.
:ent.
:hp5.Related topics&colon.:ehp5.
:sl compact.
:li.
:link reftype=hd res=610.All citiess
:elink.
:li.
:link reftype=hd res=640.Select (other) city
:elink.
:li.
:link reftype=hd res=650.Add new city / Change properties
The TZ (time zone) environment variable in CONFIG.SYS controls the interpretation of the hardware clock.
This variable is used by some applications.
:p.
To enable all options in &greename. (select only cities in your Time Zone, run DSTswitch to &greename. interface ...),
fully qualified TZ environment variable must be in CONFIG.SYS (not only TZ descriptor(s) and UTC difference).
:nt.
if you are in United States or Canada, TZ environment variable in your CONFIG.SYS probably looks like&colon. SET TZ=EST5EDT (example is for USA Eastern).
If you want to keep this variable (valid for some programs, not for &greename.) in CONFIG.SYS, disable TZ related messages in Settings notebook (System page).
:ent.
To set TZ environment variable for selected city, select correct values (city name, country,
UTC difference - Time Zone, Daylight Savings Time start and end) - press up and down
arrows on spin buttons. As you change values, TZ string will be changed.
.*:hp5.Following information is used from CM2CFG.DAT (part of CM/2 - CONFIG.SYS editor) by Klaus Staedtler&colon.:ehp5.
:p.
:hp2.If you change the TZ variable manually, complete variable is&colon.:ehp2.
:p.
:font facename=Helv size=24x18.
SET TZ=STD[+|-]nDST[,DSTm,DSTw,DSTd,DSTt,STDm,STDw,STDd,STDt,shift]
:font facename=default size=0x0.
:dl compact tsize=10.
:dt.:hp2.STD:ehp2.
:dd.Standard Time Zone Descriptor (3 characters - it may contain spaces, but first must be character)
:dt.:hp2.n:ehp2.
:dd.Difference to UTC (GMT) in Hours (positive are west of 0 degree length, negative are east of 0 degree length)
:dt.:hp2.DST:ehp2.
:dd.Daylight Savings Descriptor (3 characters - it may contain spaces, but first must be character)
:dt.:hp2.DSTm:ehp2.
:dd.Month in which Daylight Savings Time starts (1=January, 2=February ... , 12=December)
:dt.:hp2.DSTw:ehp2.
:dd.Week in which Daylight Savings Time starts (positive - from the beginning of the month, negative - from the end of the month)
:dt.:hp2.DSTd:ehp2.
:dd.Day at which Daylight Savings Time starts (0=Sunday, 1=Monday ..., 6=Saturday).
:dt.:hp2.DSTt:ehp2.
:dd.Time of Daylight Savings Time start in seconds
:dt.:hp2.STDm:ehp2.
:dd.Month in which Daylight Savings Time ends (1=January, 2=February ... , 12=December)
:dt.:hp2.STDw:ehp2.
:dd.Week in which Daylight Savings Time ends (positive - from the beginning of the month, negative - from the end of the month)
:dt.:hp2.STDd:ehp2.
:dd.Day at which Daylight Savings Time ends (0=Sunday, 1=Monday ..., 6=Saturday).
:dt.:hp2.STDt:ehp2.
:dd.Time of Daylight Savings Time end in seconds
:dt.:hp2.shift:ehp2.
:dd.Size of the Time shift in seconds
:edl.
:p.
:hp8.Don't write SET TZ= statement in entry field with TZ variable. Program will add this
statement and prepare fully qualified TZ variable.:ehp8.
:nt.
if you changed TZ environment variable in CONFIG.SYS, :hp5.restart your computer to accept changes:ehp5..
:ent.
:hp5.Related topics&colon.:ehp5.
:sl compact.
:li.
:link reftype=hd res=880.Time Zones
:elink.
:li.
:link reftype=hd res=890.Glossary
:elink.
:esl.
.*
.* Panel definition : World Time
.*
:h1 id=710 res=710 x=0% y=0% width=100% height=100% group=1.World Time
:i1 id=710.World Time
:p.
Here you can see Standard time (NOT Daylight Savings Time) for all Time Zones from West (UTC -12 hours) to East (UTC +12 hours).
If you move mouse pointer over time displayed in Time Zone, in Title bar is displayed information about this Time Zone (Military code, UTC +/- hours, countries and regions in this Time Zone).
Background colors in Time Zones are&colon. blue=night, white=day, light blue=twilight. Night, day and twilight are displayed for 1st city's latitude.
:p.
When you press :hp2.Position:ehp2. button, you can select position of World Time window on the screen - top left, top right, bottom left, bottom right or center (this option is also available in the Settings notebook - World page).
You can also :hp2.Show map:ehp2. or :hp2.Hide map:ehp2..
:p.
:i2 refid=710.World map
:hp2.World map:ehp2.
:p.
When you select :hp2.Show World map:ehp2. checkbox in Settings, or if you press :hp2.Show map:ehp2. button, World map will be displayed
(If &greename. does not find file World*.met in working directory, checkbox in Settings and button in this window are disabled).
Some features are available only if World map is displayed&colon.
:parml tsize=5.
:pt.:hp5.Coordinates:ehp5.
:pd.When you move cursor over World map, in lower left corner are displayed coordinates of location on the map
(Latitude in degrees and minutes from 180°. W(est) to 180°. E(ast) and Longitude in degrees and minutes from 90°. N(orth) to 90°. S(outh)).
:pt.:hp5.Distance:ehp5.
:pd.You can calculate distance between two selected locations in the world. To do this, move cursor to the first location,
press and HOLD 1st mouse button (left mouse button by default) down, move cursor to the second location, and release 1st mouse button. That's all!
.br
In status line you will see following information&colon.
:ol compact.
:li.First location's coordinates&colon. Latitude 180°.W(est) - 180°.E(ast) and Longitude 90°.N(orth) - 90°.S(outh)
:li.Distance in kilometers (km), miles (mi) and nautical miles (nm) - 1 mi = 1.609 km, 1 nm = 1.852 km.
:eol.
:pt.:hp5.PopUp Menu:ehp5.
:pd.When you press 2nd mouse button (right mouse button by default), PopUp menu with following items is displayed&colon.
:dl compact tsize=15.
:dt.:hp2.Position:ehp2.
:dd.Position of this window on the screen (TopLeft, TopRight, BottomLeft, BottomRight and Center)
:dt.:hp2.Hide map:ehp2.
:dd.Hide World map (you can also press :hp2.Hide map:ehp2. button)
:dt.:hp2.Show cities:ehp2.
:dd.Show position of 9 selected cities in &greename. on the map. To see distance between 9 selected cities, open :hp2.Cities:ehp2. window, and press :hp2.Distance:ehp2. button.
:dt.:hp2.Hide cities:ehp2.
:dd.Hide 9 selected cities in &greename. on the map
:dt.:hp2.Help:ehp2.
:dd.Show help about World Time (you can also press :hp2.Help:ehp2. button)
:dt.:hp2.Close:ehp2.
:dd.Close World Time and return to &greename. (you can also press :hp2.Close:ehp2. button)
:edl.
:eparml.
:p.
:hp5.Related topics&colon.:ehp5.
:sl compact.
:li.
:link reftype=hd res=711.Create your own World map
:elink.
:li.
:link reftype=hd res=500.Settings
:elink.
:li.
:link reftype=hd res=880.Time Zones
:elink.
:li.
:link reftype=hd res=890.Glossary
:elink.
:li.
:link reftype=hd res=800.Limitations
:elink.
:li.
:esl.
.*
.* Panel definition : Create your own World map
.*
:h2 id=711 res=711 x=0% y=0% width=100% height=100% group=2.Create your own World map
:i2 refid=710.Create your own World map
:p.
You can also create your own map and add it to the list of available World maps. To do this, follow these rules&colon.
:dl tsize=20.
:dt.:hp2.Image type:ehp2.
:dd.OS/2 metafile
:dt.:hp2.Image size:ehp2.
:dd.721 (width) * 361 (height)
:dt.:hp2.Map projection:ehp2.
:dd.Equidistant Cylindrical Projection (a linaer scaling of longitudes and latitudes - the meridians and the parallels are equally spaced.
It is also known as the Plate Car&ea.e projection. All meridians and parallels are straight lines).
:dt.:hp2.Map area:ehp2.
:dd.
180°. East (left border)
.br
180°. West (right border)
.br
90°. North (top border)
.br
90°. South (bottom border)
:edl.
:p.
When finished, add your creation to the list of available World maps&colon.
:ol compact.
:li.Exit &greename. (if it is running) and open CLOCK.INI with INI editor.
:li.Select Application (Section) :hp2.WorldMap:ehp2.. There are 4 Keys (World0.met to World3.met).
:li.Add new Key, where Key name. is name of your file (World4.met for example), and Value is description.
:li.Close CLOCK.INI, start &greename., open :hp2.Settings:ehp2. notebook and select :hp2.World:ehp2. page.
:li.Select your map from the list, press :hp2.Save settings:ehp2. button and close :hp2.Settings:ehp2. notebook.
:li.Open PopUp menu and select :hp2.World:ehp2. menu item. You should see your World map.
:eol.
:nt.
After you added new World map, I would appreciate if you send me new MET file, so I can include this file in next version of &greename..
Calendar displays current month and year. For every day you can write short note.
If day already has note, it is displayed with asterisk after date (:hp4.11*:ehp4. for example).
.br
To select other month/year, use buttons&colon.
:dl compact tsize=15.
:dt.:hp2.1st button:ehp2.
:dd.Select previous year and same month
:dt.:hp2.2nd button:ehp2.
:dd.Select previous month and same year
:dt.:hp2.3rd button:ehp2.
:dd.Select next month and same year
:dt.:hp2.4th button:ehp2.
:dd.Select next year and same month
:edl.
:p.
If you want to edit/view note for date, select it (use arrow keys) and double-click on selected date (or press :hp2.Enter:ehp2. key).
:p.
Then you can enter your note. Press :hp2.Save note:ehp2. button to save note for selected date (visible in title bar), or press :hp2.Delete note:ehp2. button to delete note for selected date.
:p.
Note for current date is displayed when &greename. starts.
.*
.* Panel definition : Universal date &. time
.*
:h1 id=745 res=745 x=0% y=0% width=100% height=100% group=1.Universal date &. time
:i1 id=745.Universal date &. time
:p.
The Gregorian calendar can be displayed in many different ways&colon. does 10/09/99 mean 10th of September 99 or 9th of October 99.
Or, does 3&colon.00 mean 3am, 3pm, 3pm UTC or 3 in any other time base?
You have to know what format the time/date has been written in, English or American etc., and common mistakes can easily happen.
:p.
Here are three ways how to display date &. time identical in all countries and/or time zones&colon.
:parml compact tsize=5.
:pt.:hp2.Coordinated Universal Time (UTC):ehp2.
:pd.is kept on the Greenwich meridian (longitude zero) and times given in UTC are almost always in terms of a 24-hour clock.
:pt.:hp2.Universal Date &. Time (UDT):ehp2.
:pd.is a metric based system promoted by Universal Time Organisation that is co-ordinated on UTC.
The day is divided in to any metric number that is required, normally a thousand units or a million units.
The day number of the year and the year can be displayed.
:pt.:hp2.Swatch beat - Internet time:ehp2.
:pd.is inaugurated by Swatch in late 1998. Day is divided into 1000 "beats" and new meridian in is created in Biel, Switzerland, home of Swatch as Biel Mean Time (BMT).
A day in Internet Time begins at midnight BMT (@000 Swatch Beats) (BMT = Central European Wintertime = CET = UTC + 1).
:eparml.
:p.
You can select any (or all) of this times to display in Title bar, when you select :hp2.Universal:ehp2. item in PopUp menu and check one of following&colon.
:dl compact tsize=10.
:dt.:hp2.UTD:ehp2.
:dd.to display Universal Date &. Time
:dt.:hp2.UTC:ehp2.
:dd.to display Coordinated Universal Time (UTC)
:dt.:hp2.Swatch:ehp2.
:dd.to display Swatch beat - Internet time
:edl.
:p.
To display selected time(s) in Title bar, press :hp2.Display:ehp2. button. UTC will be displayed without seconds;
UTD and Internet time ("Swatch beat") will be displayed as whole numbers (without fraction of unit).
:nt.
when you start &greename., selected time(s) will be displayed in Title bar in next full minute (i.e. 00 sec)
Language support for &greename. (buttons text, messages, frames text ...) is stored in Language INI files (ENGLISH.INI, CROATIAN.INI, etc.) and source of help file (this file - English.inf) is file English.ipf.
.br
If you want to add your Language support :link refid=author reftype=fn. visit my site:elink.
and download Translation tool (translat.zip).
:p.
:hp2.
To create new Language INI file&colon.
:ehp2.
:ol compact.
:li.Select source language (one of languages in the list).
:li.Press :hp2.New language!:ehp2. button, to create new language file. SOURCE LANGUAGE will be copied to new language file.
:li.Enter language name, comment, your name and email adress (REQUIRED!). Then press :hp2.OK - start translation:ehp2. button.
:li.Sections (pages in Notebook) are: Menu, Hint, Message, Button, Frame and Help. Overwrite text with your text.
:li.When finished, select your language in program and try it.
:eol.
:p.
:hp2.
To change existing Language INI file&colon.
:ehp2.
:ol compact.
:li.Select your language (as source language and your language).
:li.Change comment, your name and email adress if you want, then press :hp2.OK - start translation:ehp2. button.
:li.Sections (pages in Notebook) are: Menu, Hint, Message, Button, Frame and Help. Overwrite existing text with your text - press :hp2.Write changes:ehp2. button after EVERY CHANGE.
:li.When finished, select your language in INI editor and check changes.
:eol.
:p.
:hp2.
Important!
:ehp2.
:p.
Press :hp2.Write changes:ehp2. button after EVERY CHANGE to save changes. If you don't press this button and go to next item, changes WILL BE LOST!
:p.
When you create new Language INI file, program will write new Key to file CLOCK.INI, Language, where&colon.
.br
- Key name is name of new language
.br
- Key value is "English.inf" - it is default help file for &greename..
:p.
In section (Page) Help are stored titles of topics in English.inf and they are used as parameter when you press :hp2.Help:ehp2. button in &greename..
You should translate this section only if you want to
:link reftype=hd res=751.
translate source help file (English.ipf).
:elink.
Then items in Help section should be identical as translated titles in new IPF/INF file.
:nt.
After you added new Language support to &greename., I would appreciate if you send me new INI file, so I can include this file in next version of &greename..
:ent.
.*
.* Panel definition for:Translate help file
.*
:h1 id=751 res=751 x=left y=bottom width=100% height=100% group=2.Translate help file
:i1 id=751.Translate help file
:p.
:hp2.
To translate help file you need IPF compiler.
:ehp2.
:p.
If you want to translate English.ipf to your language, after you finished translation, make changes in Application "Language" in file CLOCK.INI.
:parml compact tsize=5.
:pt.
For example&colon.
:pd.
when you translated ENGLISH to MYLANG (where MYLANG is your Language), MYLANG.INI file is created.
When you translated English.ipf to Mylang.ipf and compile Mylang.ipf, Mylang.inf file is created.
.br
Edit in CLOCK.INI&colon.
.br
change in Application Language, Key MYLANG, Value English.inf to Mylang.inf.
:eparml.
:p.
Be sure you also translated Help section in MYLANG.INI.
In section (Page) Help are stored titles of topics help and they are used as parameter when you press :hp2.Help:ehp2. button in &greename..
Translate this section only when you translated source help file (English.ipf).
:nt.
After you translated help file, I would appreciate if you send me new IPF/INF file, so I can include this file in next version of &greename..
:ent.
.*
.* Panel definition : DSTswitch to World Clock Interface
.*
:h1 id=870 res=870 x=0% y=0% width=100% height=100% group=1.DSTswitch to World Clock Interface
:i1 id=870.DSTswitch to World Clock Interface
.*
:p.
DSTswitch is an automatic time changing utility for OS/2 developed by Mark Eckstein.
DSTswitch enables you to synchronize the time between computers and automatically adjust system
clock when Standard time changes to Daylight Savings time and vice versa.
:p.
:hp2.Difference between World Clock and DSTswitch is&colon.:ehp2.
:ul.
:li.
&greename. calculates UTC (and local times for cities 2-9) from properties for 1st city (i.e. 1st city MUST be in your Time Zone for correct dispay of time and date).
&greename. does not use values from TZ environment variable in CONFIG.SYS.
.br
When Standard time changes to Daylight Savings time (and Daylight Savings to Standard), World clock does NOT adjust computer's system clock (you will just see message box).
You have to adjust system clock manually.
:li.DSTswitch calculates UTC from TZ environment variable in CONFIG.SYS.
.br
When Standard time changes to Daylight Savings time (and Daylight Savings to Standard), DSTswitch automatically adjusts system clock.
:eul.
:p.
In this archive (clock111.zip) is included DSTswitch to World Clock Interface (DSTsWClk.exe).
.br
If you have DSTswitch installed (and running), you can use calculated UTC from DSTswitch and select city from any Time Zone as 1st city.
To do this, first start DSTsWClk.exe, then start &greename..
Now you can select 1st city in any Time Zone, and time and date for all 9 cities will be displayed correctly.
:nt.
If you exit DSTswitch and/or DSTswitch to World Clock Interface (DSTsWClk.EXE) while &greename. is running,
UTC (and local times for cities 2-9) will be again calculated from DSTswitch (within next minute or two).
.br
Also, if you start DSTswitch and DSTswitch to World Clock Interface (DSTsWClk.EXE) while &greename. is running,
UTC (and local times for cities 2-9) will be calculated from properties for 1st city (within next minute or two).
.br
:hp8.If you selected 1st city from different Time Zone (and do not use DSTswitch to World Clock Interface), local time and date for all 9 cities will be wrong.:ehp8.
Daylight Saving Time (also called "summer time") is a method of advancing clocks in a global
manner, in order to artificially expand the daylight hours. In general, clocks are set forward
one hour in Spring and are set back one hour in Fall.
.br
There are no international standards for "saving time". Each country is free to define its
own rules.
:i2 refid=890.GMT
:i2 refid=890.Greenwich Mean Time
:pt.:hp2.Greenwich Mean Time (GMT):ehp2.
:pd.
Common standard for time calculations related to Greenwich, England.
Greenwich Mean Time is a widely used historical term, but one that has been used in several ways.
Because of the ambiguity, its use is no longer recommended in technical contexts.
:i2 refid=890.UTC
:i2 refid=890.Coordinated Universal Time
:pt.:hp2.Coordinated Universal Time (UTC):ehp2.
:pd.The times are often given in "Universal Time" (abbreviated UTC) which is sometimes referred to
"Greenwich Mean Time" (abbreviated GMT).
The two terms are often used loosely to refer to time kept on the Greenwich meridian (longitude zero).
Times given in UTC are almost always given in terms of a 24-hour clock.
.br
In the most common civil usage, UT refers to a time scale called "Coordinated Universal Time"
(abbreviated UTC), which is the basis for the worldwide system of civil time.
This time scale is kept by time laboratories around the world, and is determined using highly precise atomic clocks.
:i2 refid=890.UDT
:i2 refid=890.Universal Date &. Time
:pt.:hp2.Universal Date &. Time (UDT):ehp2.
:pd.Universal Time Organisation is promoting a metric based system that is co-ordinated on UTC.
The day is divided in to any metric number that is required, normally a thousand units or a million units.
The day number of the year and the year can be displayed, thus giving it a date format.
.br
They have developed a system called Universal Date &. Time (UDT) that can be used internationally and mean only one thing.
:i2 refid=890.Swatch beat
:i2 refid=890.Internet time
:pt.:hp2.Swatch beat - Internet time:ehp2.
:pd.Internet Time (inaugurated by Swatch in late 1998) represents a new global concept
of time. The Swatch Beat, the new unit of time means the following&colon.
.br
- Day is divided into 1000 "beats". One Swatch beat is the equivalent of 86.4 seconds (1 minute 26.4 seconds).
That means that 12 noon is the equivalent of @500 Swatch beats.
.br
- A new meridian in is created in Biel, Switzerland, home of Swatch. Biel Mean Time (BMT)
will be the universal reference for Internet Time. A day in Internet Time begins at midnight
BMT (@000 Swatch Beats). BMT = Central European Wintertime = CET = UTC + 1 hour.
:i2 refid=890.Latitude
:i2 refid=890.Longitude
:pt.:hp2.Latitude and longitude:ehp2.
:pd.
Latitude gives the location of a point north or south of the equator. It is measured in angles ranging from 0°. at the equator to 90°. at the poles.
.br
Longitude gives the location of a point east or west of a north-south line called the prime meridian, is measured in angles ranging from 0°. at the prime meridian to 180°. at the International Date Line.
.br
Each degree of latitude and longitude is divided into 60 minutes, and each minute divided into 60 seconds, thereby allowing the assignment of a precise numerical location to any point on earth.
.br
The east-west lines of latitude and the north-south line of longitude intersect at right angles to form a grid.
:i2 refid=890.Sunrise
:i2 refid=890.Sunset
:pt.:hp2.Sun rise and set:ehp2.
:pd.
Sunrise is the instant in the morning under ideal meteorological conditions, with standard refraction of the sun's rays, when the upper edge of the sun's disk is coincident with an ideal horizon.
.br
Sunset is the instant in the evening under ideal meteorological conditions, with standard refraction of the sun's rays, when the upper edge of the sun's disk is coincident with an ideal horizon.
.br
Atmospheric conditions are assumed to be average, and the location is in a level region on the Earth's surface.
:eparml.
:p.
:nt.
:hp2.Here may be incorrect data (UTC difference, DST begin/end, Time Zones, Time Zone descriptors and/or coordinates for some cities).:ehp2.
.br
I would appreciate if you :link refid=author reftype=fn.send corrections:elink.
DO NOT EDIT CLOCK.INI WITH ANY INI EDITOR WHILE WORLD CLOCK IS RUNNING !!!
:ecaution.
:ehp8.
:parml tsize=5.
:pt.:hp2.Bugs in OS/2 and Rexx:ehp2.
:pd.Under some environment (Warp3 with FP35 and FP38, Warp4 with FP10 and FP11) there are bugs in OS/2 and/or Rexx.
Known problems (until now) are&colon. time calculation and display on the World map for cities in western hemisphere may be wrong.
If you have problem like this, check selected city (sometimes is longidude displayed in East), select correct values and save changes.
:pt.:hp2.Time delay in changes:ehp2.
:pd.&greename. is reading system date &. time from your computer's internal clock once in a minute (at 00 sec) to reduce CPU usage.
Some changes you made (selected time display in Title bar, start or end DSTswitch to &greename. Interface ...) will be visible in next minute.
If you can't wait so long, exit &greename. and start it again.
:pt.:hp2."Classic" vs. Object Rexx:ehp2.
:pd.&greename. can run under "Classic" or Object Rexx. If you have Object Rexx installed, performance is significantly slower (loading time is about 3x longer, etc.)
:pt.:hp2.FastIni.dll:ehp2.
:pd.FastIni.dll is library for fast acces to OS/2 INI files.
As &greename. stores all information in CLOCK.INI file (settings, cities ...), it is recommended to use this file (copy it to directory in LIBPATH statement in CONFIG.SYS, or keep it in &greename.'s directory).
&greename. can run without this library, but performance will be slower.
:pt.:hp2.Calculating date / time:ehp2.
:pd.
&greename. calculates UTC (and local dates/times for cities 2-9) from properties for 1st city
(it MUST be in your Time Zone for correct date &. time display for other cities).
If you are using :link reftype=hd res=870.DSTswitch to World Clock Interface.:elink.
(and if you have DSTswitch installed) you can select any city in any Time Zone as 1st city.
To do this, first start DSTswitch, then DSTsWClk.exe and finally &greename..
Now you can select 1st city in any Time Zone, and time and date for all 9 cities will be displayed correctly.
:pt.:hp2.Set System clock to UTC:ehp2.
:pd.
If you set computer's system clock to UTC, local time for cities will be calculated from computer's
time and (in most cases) local time for 1st city and computer's system time will be different.
.br
OS/2 does not use TZ envrionment variable and computer's time is always used when writing datestamp and timestamp for files, etc.
If other programs on your computer use TZ environment variable, they'll probably calculate wrong local time, if you set system clock to UTC.
.br
If you work with somebody in different Time Zone, maybe you want to synchronize computer's clocks.
:pt.:hp2.Daylight Savings time:ehp2.
:pd.
When Standard time changes to Daylight Savings time (and Daylight Savings to Standard), World clock does NOT adjust computer's system clock (you will just see message box).
You have to adjust system clock manually, or use some utility to do this (like DSTswitch).
:pt.:hp2.Distances in World map:ehp2.
:pd.
Formulas for distance calculation are using spherical coordinates on the earth.
They don't take into account the squashed nature of the earth (it is kind of fat around the equator, as a result of the centrifugal force it gets from spinning on its axis).
So that will throw a little error into these calculations.
Size of World map is 721 (width) * 361 (height) pixels (1°. = 2 pixels) and the smallest distance between two location you can select is 1 pixel or 30 minutes (about 55-56 km).
:pt.:hp2.Sun rise and set:ehp2.
:pd.
The times of rise and set cannot be precisely computed, because the actual times depend on unpredictable atmospheric conditions that affect the amount of refraction at the horizon.
.br
There are some errors in calculating the times of sunrise/sunset at high latitudes (> 66.5°.).
These errors are due to the algorithms used and if there is latitude for city higher than 66.5°., sunrise/sunset is calculated for latitude 66.5°..
:pt.:hp2.Possible errors:ehp2.
:pd.
Here may be incorrect data (UTC difference, DST begin/end, Time Zones, Time Zone descriptors and/or coordinates) for some cities/countries.
I would appreciate if you :link refid=author reftype=fn.send corrections:elink..
:eparml.
:p.
All &greename.'s settings are saved in file CLOCK.INI.
If some of then are missing or wrong, program loads default settings and writes them to CLOCK.INI.
Information about Time Zones, Daylight Savings Time, Internet Time, latitudes and longitudes, sunrise/sunset ... was compiled from various sources available freely on the Internet.
Credits are fully given to the known authors of any material that was used.
:p.
To find more information on the Internet, visit&colon.
