/* iCalTimeZonePeriod.m - this file is part of SOPE * * Copyright (C) 2006-2014 Inverse inc. * * This file is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2, or (at your option) * any later version. * * This file is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; see the file COPYING. If not, write to * the Free Software Foundation, Inc., 59 Temple Place - Suite 330, * Boston, MA 02111-1307, USA. */ #import #import #import #import #import "iCalDateTime.h" #import "iCalByDayMask.h" #import "iCalUTCOffset.h" #import "iCalTimeZonePeriod.h" @implementation iCalTimeZonePeriod - (Class) classForTag: (NSString *) classTag { Class tagClass; if ([classTag isEqualToString: @"RRULE"]) tagClass = [iCalRecurrenceRule class]; else if ([classTag isEqualToString: @"RDATE"]) tagClass = [iCalDateTime class]; else if ([classTag isEqualToString: @"DTSTART"]) tagClass = [iCalDateTime class]; else if ([classTag isEqualToString: @"TZOFFSETFROM"] || [classTag isEqualToString: @"TZOFFSETTO"]) tagClass = [iCalUTCOffset class]; else if ([classTag isEqualToString: @"TZNAME"]) tagClass = [CardElement class]; else tagClass = [super classForTag: classTag]; return tagClass; } - (int) _secondsOfOffset: (NSString *) offsetName { NSString *offsetTo; BOOL negative; NSRange cursor; unsigned int length; unsigned int seconds; seconds = 0; offsetTo = [[self uniqueChildWithTag: offsetName] flattenedValuesForKey: @""]; length = [offsetTo length]; if (!length) return seconds; negative = [offsetTo hasPrefix: @"-"]; if (negative) { length--; cursor = NSMakeRange(1, 2); } else if ([offsetTo hasPrefix: @"+"]) { length--; cursor = NSMakeRange(1, 2); } else cursor = NSMakeRange(0, 2); seconds = 3600 * [[offsetTo substringWithRange: cursor] intValue]; cursor.location += 2; seconds += 60 * [[offsetTo substringWithRange: cursor] intValue]; if (length == 6) { cursor.location += 2; seconds += [[offsetTo substringWithRange: cursor] intValue]; } return ((negative) ? -seconds : seconds); } // - (unsigned int) dayOfWeekFromRruleDay: (iCalWeekDay) day // { // unsigned int dayOfWeek; // dayOfWeek = 0; // while (day >> (dayOfWeek + 1)) // dayOfWeek++; // return dayOfWeek; // } - (void) dealloc { [startDate release]; [super dealloc]; } - (NSCalendarDate *) startDate { if (!startDate) { startDate = [(iCalDateTime *) [self uniqueChildWithTag: @"dtstart"] dateTime]; [startDate retain]; } return startDate; } - (iCalRecurrenceRule *) recurrenceRule { return (iCalRecurrenceRule *) [self firstChildWithTag: @"rrule"]; } /** * This method returns the date corresponding for to the start of the period * in the year of the reference date. * We assume that a RRULE for a timezone will always be YEARLY with a BYMONTH * and a BYDAY rule. */ - (NSCalendarDate *) _occurrenceForDate: (NSCalendarDate *) refDate byRRule: (iCalRecurrenceRule *) rrule { NSCalendarDate *tmpDate; iCalByDayMask *byDayMask; int dayOfWeek, dateDayOfWeek, offset, pos; NSCalendarDate *tzStart; byDayMask = [rrule byDayMask]; dayOfWeek = 0; if (byDayMask == nil) { dayOfWeek = 0; pos = 1; } else { dayOfWeek = (int)[byDayMask firstDay]; pos = [byDayMask firstOccurrence]; } tzStart = [self startDate]; [tzStart setTimeZone: [NSTimeZone timeZoneWithName: @"GMT"]]; tmpDate = [NSCalendarDate dateWithYear: [refDate yearOfCommonEra] month: [[[rrule byMonth] objectAtIndex: 0] intValue] day: 1 hour: [tzStart hourOfDay] minute: [tzStart minuteOfHour] second: 0 timeZone: [NSTimeZone timeZoneWithName: @"GMT"]]; tmpDate = [tmpDate addYear: 0 month: ((pos > 0) ? 0 : 1) day: 0 hour: 0 minute: 0 second: 0]; /* If the day of the time change is "-XSU", we need to determine whether the first day of next month is in the same week. In practice, as most time changes occurs on sundays, it will be false only when that first day is a sunday, but we want to remain algorithmically exact. */ dateDayOfWeek = [tmpDate dayOfWeek]; if (dateDayOfWeek > dayOfWeek && pos < 0) pos++; /* We check if the days of the week are identical. This is important because if they are, "pos" actually includes the first day of tmpDate which means we must decrement pos by 1. This happens for example in the eastern timezone (America/Montreal) in 2015. We have: BEGIN:VTIMEZONE TZID:America/Montreal X-LIC-LOCATION:America/Montreal BEGIN:DAYLIGHT TZOFFSETFROM:-0500 TZOFFSETTO:-0400 TZNAME:EDT DTSTART:19700308T020000 RRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=2SU END:DAYLIGHT BEGIN:STANDARD TZOFFSETFROM:-0400 TZOFFSETTO:-0500 TZNAME:EST DTSTART:19701101T020000 RRULE:FREQ=YEARLY;BYMONTH=11;BYDAY=1SU END:STANDARD END:VTIMEZONE The time changes occur on a Sunday, but in March, the 1st is a Sunday itself and in November the 1st is also a Sunday. If we don't decrement "pos" by one, tmpDate (which is set to March or November 1st because of "day: 1" will have 14 more days added for March and 7 more days added for November - which will effectively shift the time change by a whole week. In Europe/Berlin, we have a different use-case for November. In 2015, November 1st is a Sunday. The time change in November must occur on October 25th but since tmpDate will be November 1st, so a Sunday, dateDayOfWeek will be 0 and dayOfWeek will also be 0 we would decrement tmpDate by 14 days, which is incorrect because it would shift the timezone change one week earlier. We take care about this one with check if pos is greater or equal than 0 and if so, we don't decrement it. BEGIN:VCALENDAR PRODID:-//Inverse inc.//NONSGML Olson 2014g//EN VERSION:2.0 BEGIN:VTIMEZONE TZID:Europe/Berlin X-LIC-LOCATION:Europe/Berlin BEGIN:DAYLIGHT TZOFFSETFROM:+0100 TZOFFSETTO:+0200 TZNAME:CEST DTSTART:19700329T020000 RRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=-1SU END:DAYLIGHT BEGIN:STANDARD TZOFFSETFROM:+0200 TZOFFSETTO:+0100 TZNAME:CET DTSTART:19701025T030000 RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU END:STANDARD END:VTIMEZONE END:VCALENDAR */ if (dayOfWeek == dateDayOfWeek && pos >= 0) pos--; offset = (dayOfWeek - dateDayOfWeek) + (pos * 7); tmpDate = [tmpDate addYear: 0 month: 0 day: offset hour: 0 minute: 0 second: 0]; return tmpDate; } - (NSCalendarDate *) _occurrenceFromRdate: (NSCalendarDate *) refDate rDates: (NSArray *) rDatesIn; { NSArray *rDates; NSEnumerator *dateList; NSCalendarDate *rDateCur, *rDateOut; NSString *dateString; unsigned i; rDateCur = nil; rDateOut = nil; dateList = [rDatesIn objectEnumerator]; while ((dateString = [dateList nextObject])) { rDates = [(iCalDateTime*) dateString dateTimes]; for (i = 0; i < [rDates count]; i++) { rDateCur = [rDates objectAtIndex: i]; if (!rDateOut || ([rDateCur yearOfCommonEra] > [rDateOut yearOfCommonEra] && [refDate yearOfCommonEra] >= [rDateCur yearOfCommonEra])) rDateOut = rDateCur; } } return rDateOut; } - (NSCalendarDate *) occurrenceForDate: (NSCalendarDate *) refDate; { NSCalendarDate *tmpDate; iCalRecurrenceRule *rrule; NSArray *rDates; tmpDate = nil; rrule = (iCalRecurrenceRule *) [self uniqueChildWithTag: @"rrule"]; rDates = (NSArray *) [self childrenWithTag: @"rdate"]; if ([rDates count]) { tmpDate = [self _occurrenceFromRdate: refDate rDates: rDates]; return tmpDate; } if ([rrule isVoid]) tmpDate = [(iCalDateTime *) [self uniqueChildWithTag: @"dtstart"] dateTime]; else if ([rrule untilDate] == nil || [refDate compare: [rrule untilDate]] == NSOrderedAscending) tmpDate = [self _occurrenceForDate: refDate byRRule: rrule]; else if ([[self _occurrenceForDate: refDate byRRule: rrule] compare: [rrule untilDate] ] == NSOrderedAscending) tmpDate = [rrule untilDate]; return tmpDate; } - (int) secondsOffsetFromGMT { return [self _secondsOfOffset: @"tzoffsetto"]; } - (NSComparisonResult) compare: (iCalTimeZonePeriod *) otherPeriod { return [[self startDate] compare: [otherPeriod startDate]]; } @end