line |
stmt |
bran |
cond |
sub |
pod |
time |
code |
1
|
2
|
|
|
2
|
|
14
|
use warnings; |
|
2
|
|
|
|
|
5
|
|
|
2
|
|
|
|
|
80
|
|
2
|
2
|
|
|
2
|
|
11
|
use strict; |
|
2
|
|
|
|
|
4
|
|
|
2
|
|
|
|
|
61
|
|
3
|
|
|
|
|
|
|
|
4
|
|
|
|
|
|
|
package Data::ICal::Entry::TimeZone::Standard; |
5
|
|
|
|
|
|
|
|
6
|
2
|
|
|
2
|
|
10
|
use base qw/Data::ICal::Entry/; |
|
2
|
|
|
|
|
4
|
|
|
2
|
|
|
|
|
306
|
|
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
|
94
|
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
|
303
|
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
|
147
|
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 - 2020, 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; |