File Coverage

blib/lib/Data/ICal/Entry/TimeZone/Daylight.pm
Criterion Covered Total %
statement 12 12 100.0
branch n/a
condition n/a
subroutine 6 6 100.0
pod 3 3 100.0
total 21 21 100.0


line stmt bran cond sub pod time code
1 2     2   6 use warnings;
  2         2  
  2         60  
2 2     2   6 use strict;
  2         2  
  2         55  
3              
4             package Data::ICal::Entry::TimeZone::Daylight;
5              
6 2     2   7 use base qw/Data::ICal::Entry/;
  2         2  
  2         246  
7              
8             =head1 NAME
9              
10             Data::ICal::Entry::TimeZone::Daylight - Represents a Daylight Time base offset from UTC for parent TimeZone
11              
12             =head1 DESCRIPTION
13              
14             A time zone is unambiguously defined by the set of time measurement
15             rules determined by the governing body for a given geographic
16             area. These rules describe at a minimum the base offset from UTC for
17             the time zone, often referred to as the Standard Time offset. Many
18             locations adjust their Standard Time forward or backward by one hour,
19             in order to accommodate seasonal changes in number of daylight hours,
20             often referred to as Daylight Saving Time. Some locations adjust their
21             time by a fraction of an hour. Standard Time is also known as Winter
22             Time. Daylight Saving Time is also known as Advanced Time, Summer
23             Time, or Legal Time in certain countries. The following table shows
24             the changes in time zone rules in effect for New York City starting
25             from 1967. Each line represents a description or rule for a particular
26             observance.
27              
28             Effective Observance Rule
29              
30             Date (Date/Time) Offset Abbreviation
31              
32             1967-* last Sun in Oct, 02:00 -0500 EST
33              
34             1967-1973 last Sun in Apr, 02:00 -0400 EDT
35              
36             1974-1974 Jan 6, 02:00 -0400 EDT
37              
38             1975-1975 Feb 23, 02:00 -0400 EDT
39              
40             1976-1986 last Sun in Apr, 02:00 -0400 EDT
41              
42             1987-* first Sun in Apr, 02:00 -0400 EDT
43              
44             Note: The specification of a global time zone registry is not
45             addressed by this document and is left for future study. However,
46             implementers may find the Olson time zone database [TZ] a useful
47             reference. It is an informal, public-domain collection of time zone
48             information, which is currently being maintained by volunteer Internet
49             participants, and is used in several operating systems. This database
50             contains current and historical time zone information for a wide
51             variety of locations around the globe; it provides a time zone
52             identifier for every unique time zone rule set in actual use since
53             1970, with historical data going back to the introduction of standard
54             time.
55              
56             =head1 METHODS
57              
58             =cut
59              
60             =head2 ical_entry_type
61              
62             Returns C, its iCalendar entry name.
63              
64             =cut
65              
66 30     30 1 1939 sub ical_entry_type {'DAYLIGHT'}
67              
68             =head2 mandatory_unique_properties
69              
70             According to the iCalendar standard, the following properties must be
71             specified exactly one time in a daylight declaration:
72              
73             dtstart tzoffsetto tzoffsetfrom
74              
75             =cut
76              
77             sub mandatory_unique_properties {
78 126     126 1 242 qw(
79             dtstart
80             tzoffsetto
81             tzoffsetfrom
82             );
83             }
84              
85             =head2 optional_repeatable_properties
86              
87             According to the iCalendar standard, the following properties may be
88             specified any number of times for a daylight declaration:
89              
90             comment rdate rrule tzname
91              
92             =cut
93              
94             sub optional_repeatable_properties {
95 60     60 1 114 qw(
96             comment
97             rdate
98             rrule
99             tzname
100             );
101             }
102              
103             =head1 AUTHOR
104              
105             Best Practical Solutions, LLC Emodules@bestpractical.comE
106              
107             =head1 LICENCE AND COPYRIGHT
108              
109             Copyright (c) 2005 - 2015, Best Practical Solutions, LLC. All rights reserved.
110              
111             This module is free software; you can redistribute it and/or
112             modify it under the same terms as Perl itself. See L.
113              
114             =cut
115              
116             1;