Compoze Software, Inc.

com.compoze.exchange
Class ExchangeTimeZone


java.lang.Object

  |

  +--com.compoze.exchange.ExchangeTimeZone

All Implemented Interfaces:
java.io.Serializable

public class ExchangeTimeZone
extends java.lang.Object
implements java.io.Serializable

This class represents a time zone as stored in Exchange. It provides a two-way mapping between a Java time zone and Exchange time zone and can be passed to the SessionInfo class to set the time zone persistently. When the time zone for the session is changed, all dates retrieved are adjusted accordingly. This means that when using the API the returned java.util.Date objects may not have their millisecond value set to UTC, but to the local time of the user. This has the effect that it is not necessary to use a DateFormat instance with time zone set on it to display dates and times. The calculation of time zone offsets is instead left to the service to avoid discrepancies in time zone calculation between Java and Exchange.

There are some effects to be aware of regarding time zone support that may at first be confusing. These can be most easily understood by working with the web example that ships with the Compoze Exchange Connector, as that provides a way to get and set the time zone in the Options screen and experiment with the effects of changing it.

See Also:
Serialized Form

Method Summary
 boolean equals(java.lang.Object o)
          Equals.
static ExchangeTimeZone get(int iNumber)
          Gets an Exchange time zone by its number.
static ExchangeTimeZone get(java.util.TimeZone tz)
          Gets an Exchange time zone from a Java time zone.
static ExchangeTimeZone[] getAllTimeZones()
          Gets all of the time zones available.
 java.util.Calendar getCalendarInstance()
          Gets an instance of a Java calendar that is in this time zone.
 java.lang.String getName()
          Gets the displayable name representing the time zone.
 int getNumber()
          Gets the time zone number.
 int getOffset()
          Gets the time zone offset from UTC standard in milliseconds.
 java.util.TimeZone getTimeZone()
          Gets a Java time zone for the Exchange time zone.
static void main(java.lang.String[] args)
          Main.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getNumber


public int getNumber()
Gets the time zone number.
Returns:
the time zone number

getAllTimeZones


public static ExchangeTimeZone[] getAllTimeZones()
Gets all of the time zones available.
Returns:
an array of all of the available time zones

getCalendarInstance


public java.util.Calendar getCalendarInstance()
Gets an instance of a Java calendar that is in this time zone.

get


public static ExchangeTimeZone get(java.util.TimeZone tz)
Gets an Exchange time zone from a Java time zone.
Parameters:
tz - the Java time zone to get the Exchange time zone for
Returns:
the Exchange time zone

get


public static ExchangeTimeZone get(int iNumber)
Gets an Exchange time zone by its number.

getTimeZone


public java.util.TimeZone getTimeZone()
Gets a Java time zone for the Exchange time zone.

getName


public java.lang.String getName()
Gets the displayable name representing the time zone.
Returns:
the time zone name

getOffset


public int getOffset()
Gets the time zone offset from UTC standard in milliseconds.
Returns:
the time zone offset

equals


public boolean equals(java.lang.Object o)
Equals.
Overrides:
equals in class java.lang.Object

main


public static void main(java.lang.String[] args)
Main.

Compoze Software, Inc.

Copyright ©1999-2003 Compoze Software, Inc. All rights reserved.