Managing Calendar Server Time Zones

This section describes these topics:

• Adding a New Time Zone

• Modifying an Existing Time Zone

Adding a New Time Zone

This section describes how to add a new time zone to Calendar Server, so that it is available in the Communications Express user interface. For example, you might want to add a new time zone for America/Miami.

The simplest way to add a new time zone is to copy and edit time-zone entries that are similar to the time zone you want to add in each of the files described in the following steps. For example, if you want to add a time zone for America/Miami, copy and edit the time-zone entries in each file for America/New_York.

To Add a New Time Zone

1. Add a time-zone block for the new time zone in the following file:

   cal_svr_base/SUNWics5/cal/data/timezones.ics

   Again, the simplest way to add a new time-zone block is to copy an existing block that is similar, including any daylight savings time (DST) offsets, to the time zone you want to add. Then, edit the new time-zone block, making any changes for the new time zone. If your new time zone has Daylight Savings Time (DST), try to find a similar

2. Modify the getDisplayNameofTZID template in the following file:

   cal_svr_base/SUNWics5/cal/html/language/i18n.xsl file

   where language specifies the directory for the language your site is using. For example: en for English, or fr for French.

   Add the new entry in the i18n.xsl file as:

   <xsl:when test="$tzid=’TimeZoneArea/ TimeZoneName’"TimeZoneArea/ TimeZoneName</xsl:when\>

   where:

   TimeZoneArea is one of the geographic divisions: Africa, America, Asia, Atlantic, Australia, Europe, or Pacific.

   TimeZoneName is the name of your new time zone.

   For example:

   <xsl:when test="$tzid='America/Miami'"\>America/Miami</xsl:when\>

3. Modify the following XML files:

   cal_svr_base/SUNWics5/cal/html/change_timezone.xml cal_svr_base/SUNWics5/cal/html/new_cal.xml cal_svr_base/SUNWics5/cal/html/new_group.xml

   In each of these files, add the following line:

   <timezone type="TimeZoneType" tzid="TimeZoneArea/TimeZoneName" offset="offset">

   where:

   TimeZoneType is "americas","europeAfrica", or "asiaPacific".

   TimeZoneArea and TimeZoneName are defined in Adding a New Time Zone.

   offset is the number of hours that your new time zone is ahead (+) or behind (-) GMT. For example, if your new time zone is four hours behind GMT, the offset would be "-04:00".

   For example:

   <timezone type="americas" tzid="America/Miami" offset="-05:00" daylightOffset="-04:00">

4. If you want the new time zone to be the default time zone for user preferences, modify the timezone entry in the following file:

   cal_svr_base/SUNWics5/cal/html/default_user_prefs.xml

5. Stop (if necessary) and then restart Calendar Server for your new time zone to take effect.

Modifying an Existing Time Zone

This section describes how to modify an existing time zone. For example, you might want to change the name of a time zone, such as “America/Phoenix” to “US/Arizona”.

To Modify an Existing Time Zone

1. Modify the time-zone block for the time zone you want to change in the following file:

   cal_svr_base/SUNWics5/cal/data/timezones.ics

   If you are changing a time-zone name, change the TZID entry to the new name.

2. Modify the getDisplayNameofTZID template in the following file:

   cal_svr_base/SUNWics5/cal/html/language/i18n.xsl file

   where: language specifies the directory for the language your site is using. For example: en for English or fr for French.

   If you are changing the name, change the existing time-zone name to the new name.

3. Modify the following XML files for changes to the time zone:

   cal_svr_base/SUNWics5/cal/html/change_timezone.xml cal_svr_base/SUNWics5/cal/html/new_cal.xml cal_svr_base/SUNWics5/cal/html/new_group.xml

   For information about the entries in these files, see Adding a New Time Zone.

4. If the change affects the default time zone for user preferences, modify the “icsTimeZone” entry in the following file:

   cal_svr_base/SUNWics5/cal/html/default_user_prefs.xml

5. Stop (if necessary) and then restart Calendar Server for your time-zone changes to take effect.