src/net/fortuna/ical4j/model/TimeZone.java

Tue, 10 Feb 2015 19:38:00 +0100

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Tue, 10 Feb 2015 19:38:00 +0100
changeset 3
73bdfa70b04e
parent 0
fb9019fb1bf7
permissions
-rw-r--r--

Upgrade embedded ical4j from ancient whatever to upstream version 1.0.6.

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.model;
michael@0 33
michael@0 34 import java.util.Calendar;
michael@0 35 import java.util.Collections;
michael@0 36 import java.util.Date;
michael@0 37 import java.util.List;
michael@0 38
michael@0 39 import net.fortuna.ical4j.model.component.Daylight;
michael@0 40 import net.fortuna.ical4j.model.component.Observance;
michael@0 41 import net.fortuna.ical4j.model.component.VTimeZone;
michael@0 42 import net.fortuna.ical4j.model.property.TzId;
michael@0 43 import net.fortuna.ical4j.model.property.TzOffsetTo;
michael@0 44
michael@0 45 /**
michael@0 46 * $Id$
michael@0 47 *
michael@0 48 * Created on 13/09/2005
michael@0 49 *
michael@0 50 * A Java timezone implementation based on an underlying VTimeZone
michael@0 51 * definition.
michael@0 52 * @author Ben Fortuna
michael@0 53 */
michael@0 54 public class TimeZone extends java.util.TimeZone {
michael@0 55
michael@0 56 private static final long serialVersionUID = -5620979316746547234L;
michael@0 57
michael@0 58 private final VTimeZone vTimeZone;
michael@0 59 private final int rawOffset;
michael@0 60
michael@0 61 /**
michael@0 62 * Constructs a new instance based on the specified VTimeZone.
michael@0 63 * @param vTimeZone a VTIMEZONE object instance
michael@0 64 */
michael@0 65 public TimeZone(final VTimeZone vTimeZone) {
michael@0 66 this.vTimeZone = vTimeZone;
michael@0 67 final TzId tzId = (TzId) vTimeZone.getProperty(Property.TZID);
michael@0 68 setID(tzId.getValue());
michael@0 69 this.rawOffset = getRawOffset(vTimeZone);
michael@0 70 }
michael@0 71
michael@0 72 /**
michael@0 73 * {@inheritDoc}
michael@0 74 */
michael@3 75 public final int getOffset(final int era, final int year, final int month, final int dayOfMonth,
michael@0 76 final int dayOfWeek, final int milliseconds) {
michael@3 77
michael@3 78 // calculate time of day
michael@3 79 int ms = milliseconds;
michael@3 80 final int hour = ms / 3600000;
michael@3 81 ms -= hour*3600000;
michael@3 82 final int minute = ms / 60000;
michael@3 83 ms -= minute*60000;
michael@3 84 final int second = ms / 1000;
michael@3 85 ms -= second*1000;
michael@3 86
michael@3 87 final Calendar cal = Calendar.getInstance();
michael@3 88 cal.clear(); // don't retain current date/time, it may disturb the calculation
michael@0 89
michael@3 90 // set date and time
michael@0 91 cal.set(Calendar.ERA, era);
michael@0 92 cal.set(Calendar.DAY_OF_WEEK, dayOfWeek);
michael@3 93 cal.set(year, month, dayOfMonth, hour, minute, second);
michael@3 94 cal.set(Calendar.MILLISECOND, ms);
michael@3 95
michael@0 96 final Observance observance = vTimeZone.getApplicableObservance(new DateTime(cal.getTime()));
michael@0 97 if (observance != null) {
michael@0 98 final TzOffsetTo offset = (TzOffsetTo) observance.getProperty(Property.TZOFFSETTO);
michael@0 99 return (int) offset.getOffset().getOffset();
michael@0 100 }
michael@0 101 return 0;
michael@0 102 }
michael@0 103
michael@0 104 /**
michael@0 105 * {@inheritDoc}
michael@0 106 */
michael@0 107 public int getOffset(long date) {
michael@0 108 final Observance observance = vTimeZone.getApplicableObservance(new DateTime(date));
michael@0 109 if (observance != null) {
michael@0 110 final TzOffsetTo offset = (TzOffsetTo) observance.getProperty(Property.TZOFFSETTO);
michael@3 111 if (offset.getOffset().getOffset() < getRawOffset()) {
michael@3 112 return getRawOffset();
michael@3 113 }
michael@3 114 else {
michael@3 115 return (int) offset.getOffset().getOffset();
michael@3 116 }
michael@0 117 }
michael@0 118 return 0;
michael@0 119 }
michael@0 120
michael@0 121 /**
michael@0 122 * {@inheritDoc}
michael@0 123 */
michael@0 124 public final int getRawOffset() {
michael@0 125 return rawOffset;
michael@0 126 }
michael@0 127
michael@0 128 /**
michael@0 129 * Determines if the specified date is in daylight time according to
michael@0 130 * this timezone. This is done by finding the latest supporting
michael@0 131 * observance for the specified date and identifying whether it is
michael@0 132 * daylight time.
michael@0 133 * @param date a date instance
michael@0 134 * @return true if the specified date is in daylight time, otherwise false
michael@0 135 */
michael@0 136 public final boolean inDaylightTime(final Date date) {
michael@0 137 final Observance observance = vTimeZone.getApplicableObservance(new DateTime(date));
michael@0 138 return (observance != null && observance instanceof Daylight);
michael@0 139 }
michael@0 140
michael@0 141 /**
michael@0 142 * {@inheritDoc}
michael@0 143 */
michael@0 144 public final void setRawOffset(final int offsetMillis) {
michael@0 145 throw new UnsupportedOperationException("Updates to the VTIMEZONE object must be performed directly");
michael@0 146 }
michael@0 147
michael@0 148 /**
michael@0 149 * {@inheritDoc}
michael@0 150 */
michael@0 151 public final boolean useDaylightTime() {
michael@0 152 final ComponentList daylights = vTimeZone.getObservances().getComponents(Observance.DAYLIGHT);
michael@0 153 return (!daylights.isEmpty());
michael@0 154 }
michael@0 155
michael@0 156 /**
michael@0 157 * @return Returns the VTimeZone backing this instance.
michael@0 158 */
michael@0 159 public final VTimeZone getVTimeZone() {
michael@0 160 return vTimeZone;
michael@0 161 }
michael@0 162
michael@0 163 private static final int getRawOffset(VTimeZone vt) {
michael@0 164
michael@0 165 List seasonalTimes = vt.getObservances().getComponents(Observance.STANDARD);
michael@0 166 // if no standard time use daylight time..
michael@3 167 if (seasonalTimes.isEmpty()) {
michael@0 168 seasonalTimes = vt.getObservances().getComponents(Observance.DAYLIGHT);
michael@3 169 if (seasonalTimes.isEmpty()) {
michael@3 170 return 0;
michael@3 171 }
michael@0 172 }
michael@0 173 Observance latestSeasonalTime = null;
michael@3 174 if (seasonalTimes.size() > 1) {
michael@3 175 // per java spec and when dealing with historical time,
michael@3 176 // rawoffset is the raw offset at the current date
michael@3 177 final DateTime now = new DateTime();
michael@3 178 Date latestOnset = null;
michael@3 179 for (int i = 0; i < seasonalTimes.size(); i++) {
michael@3 180 Observance seasonalTime = (Observance) seasonalTimes.get(i);
michael@3 181 Date onset = seasonalTime.getLatestOnset(now);
michael@3 182 if (onset == null) {
michael@3 183 continue;
michael@3 184 }
michael@3 185 if (latestOnset == null || onset.after(latestOnset)) {
michael@3 186 latestOnset = onset;
michael@3 187 latestSeasonalTime = seasonalTime;
michael@3 188 }
michael@0 189 }
michael@3 190 } else {
michael@3 191 latestSeasonalTime = (Observance)seasonalTimes.get(0);
michael@0 192 }
michael@0 193 if (latestSeasonalTime != null) {
michael@0 194 final TzOffsetTo offsetTo = (TzOffsetTo) latestSeasonalTime.getProperty(Property.TZOFFSETTO);
michael@0 195 if (offsetTo != null) {
michael@0 196 return (int) offsetTo.getOffset().getOffset();
michael@0 197 }
michael@0 198 }
michael@0 199 return 0;
michael@0 200 }
michael@3 201
michael@3 202 public boolean equals(Object o) {
michael@3 203 if (this == o) return true;
michael@3 204 if (o == null || getClass() != o.getClass()) return false;
michael@3 205
michael@3 206 TimeZone timeZone = (TimeZone) o;
michael@3 207
michael@3 208 if (rawOffset != timeZone.rawOffset) return false;
michael@3 209 if (vTimeZone != null ? !vTimeZone.equals(timeZone.vTimeZone) : timeZone.vTimeZone != null) return false;
michael@3 210
michael@3 211 return true;
michael@3 212 }
michael@3 213
michael@3 214 public int hashCode() {
michael@3 215 int result = vTimeZone != null ? vTimeZone.hashCode() : 0;
michael@3 216 result = 31 * result + rawOffset;
michael@3 217 return result;
michael@3 218 }
michael@0 219 }

mercurial