| Platform SDK: CDO 1.2.1 |
The TimeZone property returns or sets the time zone in which the calendar is to be rendered. Read/write.
objContRend.TimeZone
Long
The TimeZone property is used when a CalendarView is applied to the container renderer's CurrentView property.
The TimeZone property can have exactly one of the following values:
TimeZone setting |
Decimal value |
Time zone to render calendar in |
Difference from GMT |
|---|---|---|---|
| CdoTmzAbuDhabi | 24 | The time zone used in the United Arab Emirates | + 4:00 |
| CdoTmzAdelaide | 19 | The time zone used in central Australia | + 9:30 |
| CdoTmzAlaska | 14 | Alaska time zone (North America) | – 9:00 |
| CdoTmzAlmaty | 46 | The time zone used in Kazakhstan | + 6:00 |
| CdoTmzArizona | 38 | The time zone used in Arizona (USA) | – 7:00 |
| CdoTmzAthens | 7 | The time zone used in Greece | + 2:00 |
| CdoTmzAtlantic Canada |
9 | Atlantic time zone (North America) | – 4:00 |
| CdoTmzAzores | 29 | The time zone used in the Azores | – 1:00 |
| CdoTmzBaghdad | 26 | The time zone used in Iraq | + 3:00 |
| CdoTmzBangkok | 22 | The time zone used in Thailand | + 7:00 |
| CdoTmzBeijing | 45 | The time zone used in mainland China | + 8:00 |
| CdoTmzBerlin | 4 | The time zone used in Germany | + 1:00 |
| CdoTmzBogota | 35 | The time zone used in Colombia | – 5:00 |
| CdoTmzBombay | 23 | The time zone used in India | + 5:30 |
| CdoTmzBrisbane | 18 | The time zone used in eastern Australia | + 10:00 |
| CdoTmzBuenosAires | 32 | The time zone used in Argentina | – 3:00 |
| CdoTmzCairo | 49 | The time zone used in Egypt | + 2:00 |
| CdoTmzCaracas | 33 | The time zone used in Venezuela | – 4:00 |
| CdoTmzCentral | 11 | Central time zone (North America) | – 6:00 |
| CdoTmzDarwin | 44 | The time zone used in northern Australia | + 9:30 |
| CdoTmzEastern | 10 | Eastern time zone (North America) | – 5:00 |
| CdoTmzEastern Europe |
5 | The time zone used in Latvia, Lithuania, and Romania | + 2:00 |
| CdoTmzEnewetak | 39 | The time zone used on Enewetak | – 12:00 |
| CdoTmzFiji | 40 | The time zone used on the Fijian Islands | + 12:00 |
| CdoTmzGuam | 43 | The time zone used on Guam | + 10:00 |
| CdoTmzGMT | 1 | Greenwich Mean Time, also called UTC (Coordinated Universal Time) | + 0 |
| CdoTmzHarare | 50 | The time zone used in Zimbabwe | + 2:00 |
| CdoTmzHawaii | 15 | Hawaii time zone (North America) | – 10:00 |
| CdoTmzHobart | 42 | The time zone used in Tasmania | + 10:00 |
| CdoTmzHongKong | 21 | The time zone used in Hong Kong SAR, PRC | + 8:00 |
| CdoTmzIndiana | 34 | The time zone used in Indiana (USA) | – 5:00 |
| CdoTmzIslamabad | 47 | The time zone used in Pakistan | + 5:00 |
| CdoTmzIsrael | 27 | The time zone used in Israel | + 2:00 |
| CdoTmzKabul | 48 | The time zone used in Afghanistan | + 4:30 |
| CdoTmzLisbon | 2 | The time zone used in Portugal | + 0 |
| CdoTmzMagadan | 41 | The time zone used in eastern Russia | + 11:00 |
| CdoTmzMax | 52 | The first unused time zone value (not a valid setting) | –––––– |
| CdoTmzMexicoCity | 37 | The time zone used in central and eastern Mexico | – 6:00 |
| CdoTmzMidAtlantic | 30 | The time zone used on the mid-Atlantic islands | – 2:00 |
| CdoTmzMidway Island |
16 | The time zone used on Midway Island | – 11:00 |
| CdoTmzMonrovia | 31 | The time zone used in Liberia | + 0 |
| CdoTmzMoscow | 51 | The time zone used in western Russia | + 3:00 |
| CdoTmzMountain | 12 | Mountain time zone (North America) | – 7:00 |
| CdoTmzNewfoundlad | 28 | The time zone used in far eastern Canada | – 3:30 |
| CdoTmzOrigin | 0 | The time zone of the International Date Line, where each calendar day begins (not a valid setting) | + 12:00 |
| CdoTmzPacific | 13 | Pacific time zone (North America) | – 8:00 |
| CdoTmzParis | 3 | The time zone used in France | + 1:00 |
| CdoTmzPrague | 6 | The time zone used in Czechoslovakia | + 1:00 |
| CdoTmzRiode Janeiro |
8 | The time zone used in Brazil | – 3:00 |
| CdoTmzSaskatchewan | 36 | The time zone used in Saskatchewan (Canada) | – 6:00 |
| CdoTmzTehran | 25 | The time zone used in Iran | + 3:30 |
| CdoTmzTokyo | 20 | The time zone used in Japan | + 9:00 |
| CdoTmzWellington | 17 | The time zone used in New Zealand | + 12:00 |
You can also specify whether or not a time zone is susceptible to summer time, also known as daylight saving time. The flag CdoTmzNoDST, which has the value &H4000 ( = 16384 decimal) indicates that the time zone you are specifying does not change during the year. If you OR the time zone identifier with CdoTmzNoDST, the difference from GMT is always constant. If you supply the time zone identifier alone, the difference from GMT changes twice a year.
The values CdoTmzOrigin and CdoTmzMax are for comparison only and are not valid settings. An attempt to set TimeZone with a value of CdoTmzOrigin or less, or CdoTmzMax or greater, returns CdoE_INVALID_PARAMETER. The CdoTmzNoDST flag is ignored for the purpose of this validity check.
The TimeZone property can be set from the Session object's "TimeZone" option. It defaults to the Web server's current time zone if not set. The session's options are set by its SetOption method and retrieved with its GetOption method.
The session's "TimeZone" option and the container renderer's TimeZone property are not automatically kept in synchronization. Changing one does not cause the other to be changed. Your application is responsible for setting each of them as appropriate.