File Coverage

blib/lib/Data/ICal/Entry/TimeZone/Standard.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	sub	pod	time	code
1	2	2		11	use warnings;
	2			4
	2			62
2	2	2		8	use strict;
	2			4
	2			60
3
4					package Data::ICal::Entry::TimeZone::Standard;
5
6	2	2		8	use base qw/Data::ICal::Entry/;
	2			3
	2			246
7
8					=head1 NAME
9
10					Data::ICal::Entry::TimeZone::Standard - Represents a Standard 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	78	sub ical_entry_type {'STANDARD'}
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 standard time declaration:
72
73					dtstart tzoffsetto tzoffsetfrom
74
75					=cut
76
77					sub mandatory_unique_properties {
78	126	126	1	248	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 standard time 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 - 2019, 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;