• file
• revisions
• annotate
• diff
• comparison
• raw

src/net/fortuna/ical4j/util/TimeZones.java@fb9019fb1bf7 (annotated)

src/net/fortuna/ical4j/util/TimeZones.java

Tue, 10 Feb 2015 18:12:00 +0100

author

Michael Schloh von Bennewitz <michael@schloh.com>

date

Tue, 10 Feb 2015 18:12:00 +0100

changeset 0

fb9019fb1bf7

permissions

-rw-r--r--

Import initial revisions of existing project AndroidCaldavSyncAdapater,
forked from upstream repository at 27e8a0f8495c92e0780d450bdf0c7cec77a03a55.

michael@0	1	/**
michael@0	2	* Copyright (c) 2012, Ben Fortuna
michael@0	3	* All rights reserved.
michael@0	4	*
michael@0	5	* Redistribution and use in source and binary forms, with or without
michael@0	6	* modification, are permitted provided that the following conditions
michael@0	7	* are met:
michael@0	8	*
michael@0	9	* o Redistributions of source code must retain the above copyright
michael@0	10	* notice, this list of conditions and the following disclaimer.
michael@0	11	*
michael@0	12	* o Redistributions in binary form must reproduce the above copyright
michael@0	13	* notice, this list of conditions and the following disclaimer in the
michael@0	14	* documentation and/or other materials provided with the distribution.
michael@0	15	*
michael@0	16	* o Neither the name of Ben Fortuna nor the names of any other contributors
michael@0	17	* may be used to endorse or promote products derived from this software
michael@0	18	* without specific prior written permission.
michael@0	19	*
michael@0	20	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
michael@0	21	* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
michael@0	22	* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
michael@0	23	* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
michael@0	24	* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
michael@0	25	* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
michael@0	26	* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
michael@0	27	* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
michael@0	28	* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
michael@0	29	* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
michael@0	30	* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
michael@0	31	*/
michael@0	32	package net.fortuna.ical4j.util;
michael@0	33
michael@0	34	import java.util.TimeZone;
michael@0	35
michael@0	36	/**
michael@0	37	* $Id$ [5/07/2004]
michael@0	38	*
michael@0	39	* Utility methods relevant to Java timezones.
michael@0	40	*
michael@0	41	* @author Ben Fortuna
michael@0	42	*/
michael@0	43	public final class TimeZones {
michael@0	44
michael@0	45	/**
michael@0	46	* The timezone identifier for UTC time.
michael@0	47	*/
michael@0	48	public static final String UTC_ID = "Etc/UTC";
michael@0	49
michael@0	50	/**
michael@0	51	* The timezone identifier for UTC time in the IBM JVM.
michael@0	52	*/
michael@0	53	public static final String IBM_UTC_ID = "GMT";
michael@0	54
michael@0	55	/**
michael@0	56	* The timezone identifier for GMT time.
michael@0	57	*/
michael@0	58	public static final String GMT_ID = "Etc/GMT";
michael@0	59
michael@0	60	private static final TimeZone UTC_TIMEZONE;
michael@0	61	static {
michael@0	62	UTC_TIMEZONE = TimeZone.getTimeZone(UTC_ID);
michael@0	63	}
michael@0	64
michael@0	65	/**
michael@0	66	* Constructor made private to enforce static nature.
michael@0	67	*/
michael@0	68	private TimeZones() {
michael@0	69	}
michael@0	70
michael@0	71	/**
michael@0	72	* Indicates whether the specified timezone is equivalent to
michael@0	73	* UTC time.
michael@0	74	* @param timezone a timezone instance
michael@0	75	* @return true if the timezone is UTC time, otherwise false
michael@0	76	*/
michael@0	77	public static boolean isUtc(final TimeZone timezone) {
michael@0	78	// return timezone.hasSameRules(TimeZone.getTimeZone(UTC_ID));
michael@0	79	// return timezone.getRawOffset() == 0;
michael@0	80	return UTC_ID.equals(timezone.getID())
michael@0	81	|| IBM_UTC_ID.equals(timezone.getID());
michael@0	82	}
michael@0	83
michael@0	84	/**
michael@0	85	* Although timezones are not really applicable to DATE instances in iCalendar, the implementation
michael@0	86	* in iCal4j requires the use of a timezone. Dates in iCal4j may be either "floating", in that they
michael@0	87	* use the default Java timezone, or alternatively will use UTC (this is the default).
michael@0	88	*
michael@0	89	* The use of floating dates may be configured by specifying the following as a system property or in
michael@0	90	* a file called "ical4j.properties" in the classpath:
michael@0	91	*
michael@0	92	* <pre>net.fortuna.ical4j.timezone.date.floating=true</pre>
michael@0	93	*
michael@0	94	* @return the timezone used for date instances
michael@0	95	*/
michael@0	96	public static TimeZone getDateTimeZone() {
michael@0	97	if ("true".equals(Configurator.getProperty("net.fortuna.ical4j.timezone.date.floating"))) {
michael@0	98	return TimeZone.getDefault();
michael@0	99	}
michael@0	100	return getUtcTimeZone();
michael@0	101	}
michael@0	102
michael@0	103	/**
michael@0	104	* Get the UTC Timezone.
michael@0	105	*/
michael@0	106	public static TimeZone getUtcTimeZone() {
michael@0	107	return UTC_TIMEZONE;
michael@0	108	}
michael@0	109	}