org.zkoss.util
Class TimeZones

java.lang.Object
  extended by org.zkoss.util.TimeZones

public class TimeZones
extends java.lang.Object

Utilities to access time-zone.

Author:
tomyeh

Constructor Summary
TimeZones()
           
 
Method Summary
static java.util.TimeZone getCurrent()
          Returns the current time zone; never null.
static java.util.TimeZone getThreadLocal()
          Returns the time zone defined by setThreadLocal(java.util.TimeZone).
static java.util.TimeZone getTimeZone(int ofsmins)
          Returns the time by specifying the offset in minutes.
static java.util.TimeZone setThreadLocal(java.util.TimeZone timezone)
          Sets the time-zone for the current thread only.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

TimeZones

public TimeZones()
Method Detail

getCurrent

public static final java.util.TimeZone getCurrent()
Returns the current time zone; never null. This is the time zone that every other objects shall use, unless they have special consideration.

Default: If setThreadLocal(java.util.TimeZone) was called with non-null, the value is returned. Otherwise, TimeZone.getDefault() is returned,


setThreadLocal

public static final java.util.TimeZone setThreadLocal(java.util.TimeZone timezone)
Sets the time-zone for the current thread only.

Each thread could have an independent time zone, called the thread time zone.

When Invoking this method under a thread that serves requests, remember to clean up the setting upon completing each request.

TimeZone old = TimeZones.setThreadLocal(newValue);
try { 
  ...
} finally {
  TimeZones.setThreadLocal(old);
}

Parameters:
timezone - the thread time zone; null to denote no thread time zone (and the system's timezone will be used instead)
Returns:
the previous thread time zone, or null if no previous time zone

getThreadLocal

public static final java.util.TimeZone getThreadLocal()
Returns the time zone defined by setThreadLocal(java.util.TimeZone).

Since:
3.0.0
See Also:
getCurrent()

getTimeZone

public static final java.util.TimeZone getTimeZone(int ofsmins)
Returns the time by specifying the offset in minutes.

For example, the following are equivalent.


TimeZone.getTimeZone("GMT+8");
TimeZones.getTimeZone(480);

Parameters:
ofsmins - the offset in minutes.


Copyright © 2005-2011 Potix Corporation. All Rights Reserved. SourceForge.net Logo