Summary: Inherited Fields | Methods | Inherited Methods | [Expand All]

public class

CachedDateTimeZone

extends DateTimeZone

java.lang.Object
↳	org.joda.time.DateTimeZone
	↳	org.joda.time.tz.CachedDateTimeZone

Class Overview

Improves the performance of requesting time zone offsets and name keys by caching the results. Time zones that have simple rules or are fixed should not be cached, as it is unlikely to improve performance.

CachedDateTimeZone is thread-safe and immutable.

Summary

[Expand]

Inherited Fields

From class org.joda.time.DateTimeZone

Public Methods
boolean	equals(Object obj) Compare this datetime zone with another.
static CachedDateTimeZone	forZone(DateTimeZone zone) Returns a new CachedDateTimeZone unless given zone is already cached.
String	getNameKey(long instant) Returns a non-localized name that is unique to this time zone.
int	getOffset(long instant) Gets the millisecond offset to add to UTC to get local time.
int	getStandardOffset(long instant) Gets the standard millisecond offset to add to UTC to get local time, when standard time is in effect.
DateTimeZone	getUncachedZone() Returns the DateTimeZone being wrapped.
int	hashCode() Gets a hash code compatable with equals.
boolean	isFixed() Returns true if this time zone has no transitions.
long	nextTransition(long instant) Advances the given instant to where the time zone offset or name changes.
long	previousTransition(long instant) Retreats the given instant to where the time zone offset or name changes.

[Expand]

Inherited Methods

From class org.joda.time.DateTimeZone

long	convertLocalToUTC(long instantLocal, boolean strict) Converts a local instant to a standard UTC instant with the same local time.
long	convertUTCToLocal(long instantUTC) Converts a standard UTC instant to a local instant with the same local time.
abstract boolean	equals(Object object) Compare this datetime zone with another.
static DateTimeZone	forID(String id) Gets a time zone instance for the specified time zone id.
static DateTimeZone	forOffsetHours(int hoursOffset) Gets a time zone instance for the specified offset to UTC in hours.
static DateTimeZone	forOffsetHoursMinutes(int hoursOffset, int minutesOffset) Gets a time zone instance for the specified offset to UTC in hours and minutes.
static DateTimeZone	forOffsetMillis(int millisOffset) Gets a time zone instance for the specified offset to UTC in milliseconds.
static DateTimeZone	forTimeZone(TimeZone zone) Gets a time zone instance for a JDK TimeZone.
static Set	getAvailableIDs() Gets all the available IDs supported.
static DateTimeZone	getDefault() Gets the default time zone.
final String	getID() Gets the ID of this datetime zone.
long	getMillisKeepLocal(DateTimeZone newZone, long oldInstant) Gets the millisecond instant in another zone keeping the same local time.
final String	getName(long instant) Gets the long name of this datetime zone suitable for display using the default locale.
String	getName(long instant, Locale locale) Gets the long name of this datetime zone suitable for display using the specified locale.
abstract String	getNameKey(long instant) Returns a non-localized name that is unique to this time zone.
static NameProvider	getNameProvider() Gets the name provider factory.
final int	getOffset(ReadableInstant instant) Gets the millisecond offset to add to UTC to get local time.
abstract int	getOffset(long instant) Gets the millisecond offset to add to UTC to get local time.
int	getOffsetFromLocal(long instantLocal) Gets the millisecond offset to subtract from local time to get UTC time.
static Provider	getProvider() Gets the zone provider factory.
final String	getShortName(long instant) Gets the short name of this datetime zone suitable for display using the default locale.
String	getShortName(long instant, Locale locale) Gets the short name of this datetime zone suitable for display using the specified locale.
abstract int	getStandardOffset(long instant) Gets the standard millisecond offset to add to UTC to get local time, when standard time is in effect.
int	hashCode() Gets a hash code compatable with equals.
abstract boolean	isFixed() Returns true if this time zone has no transitions.
boolean	isLocalDateTimeGap(LocalDateTime localDateTime) Checks if the given `LocalDateTime` is within a gap.
boolean	isStandardOffset(long instant) Checks whether, at a particular instant, the offset is standard or not.
abstract long	nextTransition(long instant) Advances the given instant to where the time zone offset or name changes.
abstract long	previousTransition(long instant) Retreats the given instant to where the time zone offset or name changes.
static void	setDefault(DateTimeZone zone) Sets the default time zone.
static void	setNameProvider(NameProvider nameProvider) Sets the name provider factory.
static void	setProvider(Provider provider) Sets the zone provider factory.
String	toString() Gets the datetime zone as a string, which is simply its ID.
TimeZone	toTimeZone() Get the datetime zone as a `TimeZone`.
Object	writeReplace() By default, when DateTimeZones are serialized, only a "stub" object referring to the id is written out.

From class java.lang.Object

Public Methods

public boolean equals (Object obj)

Compare this datetime zone with another.

Parameters

obj	the object to compare with

Returns

true if equal, based on the ID and all internal rules

public static CachedDateTimeZone forZone (DateTimeZone zone)

Returns a new CachedDateTimeZone unless given zone is already cached.

public String getNameKey (long instant)

Returns a non-localized name that is unique to this time zone. It can be combined with id to form a unique key for fetching localized names.

Parameters

instant	milliseconds from 1970-01-01T00:00:00Z to get the name for

Returns

name key or null if id should be used for names

public int getOffset (long instant)

Gets the millisecond offset to add to UTC to get local time.

Parameters

instant	milliseconds from 1970-01-01T00:00:00Z to get the offset for

Returns

the millisecond offset to add to UTC to get local time

public int getStandardOffset (long instant)

Gets the standard millisecond offset to add to UTC to get local time, when standard time is in effect.

Parameters

instant	milliseconds from 1970-01-01T00:00:00Z to get the offset for

Returns

the millisecond offset to add to UTC to get local time

public DateTimeZone getUncachedZone ()

Returns the DateTimeZone being wrapped.

public int hashCode ()

Gets a hash code compatable with equals.

Returns

suitable hashcode

public boolean isFixed ()

Returns true if this time zone has no transitions.

Returns

true if no transitions

public long nextTransition (long instant)

Advances the given instant to where the time zone offset or name changes. If the instant returned is exactly the same as passed in, then no changes occur after the given instant.

Parameters

instant	milliseconds from 1970-01-01T00:00:00Z

Returns

milliseconds from 1970-01-01T00:00:00Z

public long previousTransition (long instant)

Retreats the given instant to where the time zone offset or name changes. If the instant returned is exactly the same as passed in, then no changes occur before the given instant.

Parameters

instant	milliseconds from 1970-01-01T00:00:00Z

Returns

milliseconds from 1970-01-01T00:00:00Z

Interfaces

Classes

CachedDateTimeZone

Class Overview

Summary

Public Methods

public boolean equals (Object obj)

Parameters

Returns

public static CachedDateTimeZone forZone (DateTimeZone zone)

public String getNameKey (long instant)

Parameters

Returns

public int getOffset (long instant)

Parameters

Returns

public int getStandardOffset (long instant)

Parameters

Returns

public DateTimeZone getUncachedZone ()

public int hashCode ()

Returns

public boolean isFixed ()

Returns

public long nextTransition (long instant)

Parameters

Returns

public long previousTransition (long instant)

Parameters

Returns