tzinfo 1.2.10 → 2.0.5

Sign up to get free protection for your applications and to get access to all the features.
Files changed (153) hide show
  1. checksums.yaml +4 -4
  2. checksums.yaml.gz.sig +0 -0
  3. data/.yardopts +3 -0
  4. data/CHANGES.md +573 -391
  5. data/LICENSE +12 -12
  6. data/README.md +368 -114
  7. data/lib/tzinfo/annual_rules.rb +32 -12
  8. data/lib/tzinfo/country.rb +141 -129
  9. data/lib/tzinfo/country_timezone.rb +70 -112
  10. data/lib/tzinfo/data_source.rb +400 -144
  11. data/lib/tzinfo/data_sources/constant_offset_data_timezone_info.rb +56 -0
  12. data/lib/tzinfo/data_sources/country_info.rb +42 -0
  13. data/lib/tzinfo/data_sources/data_timezone_info.rb +91 -0
  14. data/lib/tzinfo/data_sources/linked_timezone_info.rb +33 -0
  15. data/lib/tzinfo/data_sources/posix_time_zone_parser.rb +181 -0
  16. data/lib/tzinfo/data_sources/ruby_data_source.rb +145 -0
  17. data/lib/tzinfo/data_sources/timezone_info.rb +47 -0
  18. data/lib/tzinfo/data_sources/transitions_data_timezone_info.rb +214 -0
  19. data/lib/tzinfo/data_sources/zoneinfo_data_source.rb +596 -0
  20. data/lib/tzinfo/data_sources/zoneinfo_reader.rb +486 -0
  21. data/lib/tzinfo/data_sources.rb +8 -0
  22. data/lib/tzinfo/data_timezone.rb +33 -47
  23. data/lib/tzinfo/datetime_with_offset.rb +153 -0
  24. data/lib/tzinfo/format1/country_definer.rb +17 -0
  25. data/lib/tzinfo/format1/country_index_definition.rb +64 -0
  26. data/lib/tzinfo/format1/timezone_definer.rb +64 -0
  27. data/lib/tzinfo/format1/timezone_definition.rb +39 -0
  28. data/lib/tzinfo/format1/timezone_index_definition.rb +77 -0
  29. data/lib/tzinfo/format1.rb +10 -0
  30. data/lib/tzinfo/format2/country_definer.rb +68 -0
  31. data/lib/tzinfo/format2/country_index_definer.rb +68 -0
  32. data/lib/tzinfo/format2/country_index_definition.rb +46 -0
  33. data/lib/tzinfo/format2/timezone_definer.rb +94 -0
  34. data/lib/tzinfo/format2/timezone_definition.rb +73 -0
  35. data/lib/tzinfo/format2/timezone_index_definer.rb +45 -0
  36. data/lib/tzinfo/format2/timezone_index_definition.rb +55 -0
  37. data/lib/tzinfo/format2.rb +10 -0
  38. data/lib/tzinfo/info_timezone.rb +26 -21
  39. data/lib/tzinfo/linked_timezone.rb +33 -52
  40. data/lib/tzinfo/offset_timezone_period.rb +42 -0
  41. data/lib/tzinfo/string_deduper.rb +118 -0
  42. data/lib/tzinfo/time_with_offset.rb +154 -0
  43. data/lib/tzinfo/timestamp.rb +552 -0
  44. data/lib/tzinfo/timestamp_with_offset.rb +85 -0
  45. data/lib/tzinfo/timezone.rb +989 -502
  46. data/lib/tzinfo/timezone_offset.rb +84 -74
  47. data/lib/tzinfo/timezone_period.rb +151 -217
  48. data/lib/tzinfo/timezone_proxy.rb +70 -79
  49. data/lib/tzinfo/timezone_transition.rb +77 -109
  50. data/lib/tzinfo/transition_rule.rb +207 -77
  51. data/lib/tzinfo/transitions_timezone_period.rb +63 -0
  52. data/lib/tzinfo/untaint_ext.rb +18 -0
  53. data/lib/tzinfo/version.rb +7 -0
  54. data/lib/tzinfo/with_offset.rb +61 -0
  55. data/lib/tzinfo.rb +82 -40
  56. data.tar.gz.sig +0 -0
  57. metadata +49 -104
  58. metadata.gz.sig +0 -0
  59. data/Rakefile +0 -107
  60. data/lib/tzinfo/country_index_definition.rb +0 -31
  61. data/lib/tzinfo/country_info.rb +0 -42
  62. data/lib/tzinfo/data_timezone_info.rb +0 -55
  63. data/lib/tzinfo/linked_timezone_info.rb +0 -26
  64. data/lib/tzinfo/offset_rationals.rb +0 -77
  65. data/lib/tzinfo/posix_time_zone_parser.rb +0 -136
  66. data/lib/tzinfo/ruby_core_support.rb +0 -169
  67. data/lib/tzinfo/ruby_country_info.rb +0 -74
  68. data/lib/tzinfo/ruby_data_source.rb +0 -140
  69. data/lib/tzinfo/time_or_datetime.rb +0 -351
  70. data/lib/tzinfo/timezone_definition.rb +0 -36
  71. data/lib/tzinfo/timezone_index_definition.rb +0 -54
  72. data/lib/tzinfo/timezone_info.rb +0 -30
  73. data/lib/tzinfo/timezone_transition_definition.rb +0 -104
  74. data/lib/tzinfo/transition_data_timezone_info.rb +0 -274
  75. data/lib/tzinfo/zoneinfo_country_info.rb +0 -37
  76. data/lib/tzinfo/zoneinfo_data_source.rb +0 -512
  77. data/lib/tzinfo/zoneinfo_timezone_info.rb +0 -520
  78. data/test/assets/payload.rb +0 -1
  79. data/test/tc_annual_rules.rb +0 -95
  80. data/test/tc_country.rb +0 -238
  81. data/test/tc_country_index_definition.rb +0 -69
  82. data/test/tc_country_info.rb +0 -16
  83. data/test/tc_country_timezone.rb +0 -173
  84. data/test/tc_data_source.rb +0 -218
  85. data/test/tc_data_timezone.rb +0 -99
  86. data/test/tc_data_timezone_info.rb +0 -18
  87. data/test/tc_info_timezone.rb +0 -34
  88. data/test/tc_linked_timezone.rb +0 -155
  89. data/test/tc_linked_timezone_info.rb +0 -23
  90. data/test/tc_offset_rationals.rb +0 -23
  91. data/test/tc_posix_time_zone_parser.rb +0 -261
  92. data/test/tc_ruby_core_support.rb +0 -168
  93. data/test/tc_ruby_country_info.rb +0 -110
  94. data/test/tc_ruby_data_source.rb +0 -173
  95. data/test/tc_time_or_datetime.rb +0 -674
  96. data/test/tc_timezone.rb +0 -1361
  97. data/test/tc_timezone_definition.rb +0 -113
  98. data/test/tc_timezone_index_definition.rb +0 -73
  99. data/test/tc_timezone_info.rb +0 -11
  100. data/test/tc_timezone_london.rb +0 -143
  101. data/test/tc_timezone_melbourne.rb +0 -142
  102. data/test/tc_timezone_new_york.rb +0 -142
  103. data/test/tc_timezone_offset.rb +0 -126
  104. data/test/tc_timezone_period.rb +0 -555
  105. data/test/tc_timezone_proxy.rb +0 -136
  106. data/test/tc_timezone_transition.rb +0 -366
  107. data/test/tc_timezone_transition_definition.rb +0 -295
  108. data/test/tc_timezone_utc.rb +0 -27
  109. data/test/tc_transition_data_timezone_info.rb +0 -433
  110. data/test/tc_transition_rule.rb +0 -663
  111. data/test/tc_zoneinfo_country_info.rb +0 -78
  112. data/test/tc_zoneinfo_data_source.rb +0 -1223
  113. data/test/tc_zoneinfo_timezone_info.rb +0 -2153
  114. data/test/test_utils.rb +0 -208
  115. data/test/ts_all.rb +0 -7
  116. data/test/ts_all_ruby.rb +0 -5
  117. data/test/ts_all_zoneinfo.rb +0 -9
  118. data/test/tzinfo-data/tzinfo/data/definitions/America/Argentina/Buenos_Aires.rb +0 -89
  119. data/test/tzinfo-data/tzinfo/data/definitions/America/New_York.rb +0 -327
  120. data/test/tzinfo-data/tzinfo/data/definitions/Australia/Melbourne.rb +0 -230
  121. data/test/tzinfo-data/tzinfo/data/definitions/EST.rb +0 -19
  122. data/test/tzinfo-data/tzinfo/data/definitions/Etc/GMT__m__1.rb +0 -21
  123. data/test/tzinfo-data/tzinfo/data/definitions/Etc/GMT__p__1.rb +0 -21
  124. data/test/tzinfo-data/tzinfo/data/definitions/Etc/UTC.rb +0 -21
  125. data/test/tzinfo-data/tzinfo/data/definitions/Europe/Amsterdam.rb +0 -273
  126. data/test/tzinfo-data/tzinfo/data/definitions/Europe/Andorra.rb +0 -198
  127. data/test/tzinfo-data/tzinfo/data/definitions/Europe/London.rb +0 -333
  128. data/test/tzinfo-data/tzinfo/data/definitions/Europe/Paris.rb +0 -277
  129. data/test/tzinfo-data/tzinfo/data/definitions/Europe/Prague.rb +0 -235
  130. data/test/tzinfo-data/tzinfo/data/definitions/UTC.rb +0 -16
  131. data/test/tzinfo-data/tzinfo/data/indexes/countries.rb +0 -940
  132. data/test/tzinfo-data/tzinfo/data/indexes/timezones.rb +0 -609
  133. data/test/tzinfo-data/tzinfo/data/version.rb +0 -20
  134. data/test/tzinfo-data/tzinfo/data.rb +0 -8
  135. data/test/zoneinfo/America/Argentina/Buenos_Aires +0 -0
  136. data/test/zoneinfo/America/New_York +0 -0
  137. data/test/zoneinfo/Australia/Melbourne +0 -0
  138. data/test/zoneinfo/EST +0 -0
  139. data/test/zoneinfo/Etc/UTC +0 -0
  140. data/test/zoneinfo/Europe/Amsterdam +0 -0
  141. data/test/zoneinfo/Europe/Andorra +0 -0
  142. data/test/zoneinfo/Europe/London +0 -0
  143. data/test/zoneinfo/Europe/Paris +0 -0
  144. data/test/zoneinfo/Europe/Prague +0 -0
  145. data/test/zoneinfo/Factory +0 -0
  146. data/test/zoneinfo/iso3166.tab +0 -274
  147. data/test/zoneinfo/leapseconds +0 -78
  148. data/test/zoneinfo/posix/Europe/London +0 -0
  149. data/test/zoneinfo/posixrules +0 -0
  150. data/test/zoneinfo/right/Europe/London +0 -0
  151. data/test/zoneinfo/zone.tab +0 -452
  152. data/test/zoneinfo/zone1970.tab +0 -384
  153. data/tzinfo.gemspec +0 -21
@@ -1,274 +0,0 @@
1
- module TZInfo
2
- # Raised if no offsets have been defined when calling period_for_utc or
3
- # periods_for_local. Indicates an error in the timezone data.
4
- class NoOffsetsDefined < StandardError
5
- end
6
-
7
- # Represents a data timezone defined by a set of offsets and a set
8
- # of transitions.
9
- #
10
- # @private
11
- class TransitionDataTimezoneInfo < DataTimezoneInfo #:nodoc:
12
-
13
- # Constructs a new TransitionDataTimezoneInfo with its identifier.
14
- def initialize(identifier)
15
- super(identifier)
16
- @offsets = {}
17
- @transitions = []
18
- @previous_offset = nil
19
- @transitions_index = nil
20
- end
21
-
22
- # Defines a offset. The id uniquely identifies this offset within the
23
- # timezone. utc_offset and std_offset define the offset in seconds of
24
- # standard time from UTC and daylight savings from standard time
25
- # respectively. abbreviation describes the timezone offset (e.g. GMT, BST,
26
- # EST or EDT).
27
- #
28
- # The first offset to be defined is treated as the offset that applies
29
- # until the first transition. This will usually be in Local Mean Time (LMT).
30
- #
31
- # ArgumentError will be raised if the id is already defined.
32
- def offset(id, utc_offset, std_offset, abbreviation)
33
- raise ArgumentError, 'Offset already defined' if @offsets.has_key?(id)
34
-
35
- offset = TimezoneOffset.new(utc_offset, std_offset, abbreviation)
36
- @offsets[id] = offset
37
- @previous_offset = offset unless @previous_offset
38
- end
39
-
40
- # Defines a transition. Transitions must be defined in chronological order.
41
- # ArgumentError will be raised if a transition is added out of order.
42
- # offset_id refers to an id defined with offset. ArgumentError will be
43
- # raised if the offset_id cannot be found. numerator_or_time and
44
- # denomiator specify the time the transition occurs as. See
45
- # TimezoneTransition for more detail about specifying times.
46
- def transition(year, month, offset_id, numerator_or_timestamp, denominator_or_numerator = nil, denominator = nil)
47
- offset = @offsets[offset_id]
48
- raise ArgumentError, 'Offset not found' unless offset
49
-
50
- if @transitions_index
51
- if year < @last_year || (year == @last_year && month < @last_month)
52
- raise ArgumentError, 'Transitions must be increasing date order'
53
- end
54
-
55
- # Record the position of the first transition with this index.
56
- index = transition_index(year, month)
57
- @transitions_index[index] ||= @transitions.length
58
-
59
- # Fill in any gaps
60
- (index - 1).downto(0) do |i|
61
- break if @transitions_index[i]
62
- @transitions_index[i] = @transitions.length
63
- end
64
- else
65
- @transitions_index = [@transitions.length]
66
- @start_year = year
67
- @start_month = month
68
- end
69
-
70
- @transitions << TimezoneTransitionDefinition.new(offset, @previous_offset,
71
- numerator_or_timestamp, denominator_or_numerator, denominator)
72
- @last_year = year
73
- @last_month = month
74
- @previous_offset = offset
75
- end
76
-
77
- # Returns the TimezonePeriod for the given UTC time.
78
- # Raises NoOffsetsDefined if no offsets have been defined.
79
- def period_for_utc(utc)
80
- unless @transitions.empty?
81
- utc = TimeOrDateTime.wrap(utc)
82
- index = transition_index(utc.year, utc.mon)
83
-
84
- start_transition = nil
85
- start = transition_before_end(index)
86
- if start
87
- start.downto(0) do |i|
88
- if @transitions[i].at <= utc
89
- start_transition = @transitions[i]
90
- break
91
- end
92
- end
93
- end
94
-
95
- end_transition = nil
96
- start = transition_after_start(index)
97
- if start
98
- start.upto(@transitions.length - 1) do |i|
99
- if @transitions[i].at > utc
100
- end_transition = @transitions[i]
101
- break
102
- end
103
- end
104
- end
105
-
106
- if start_transition || end_transition
107
- TimezonePeriod.new(start_transition, end_transition)
108
- else
109
- # Won't happen since there are transitions. Must always find one
110
- # transition that is either >= or < the specified time.
111
- raise 'No transitions found in search'
112
- end
113
- else
114
- raise NoOffsetsDefined, 'No offsets have been defined' unless @previous_offset
115
- TimezonePeriod.new(nil, nil, @previous_offset)
116
- end
117
- end
118
-
119
- # Returns the set of TimezonePeriods for the given local time as an array.
120
- # Results returned are ordered by increasing UTC start date.
121
- # Returns an empty array if no periods are found for the given time.
122
- # Raises NoOffsetsDefined if no offsets have been defined.
123
- def periods_for_local(local)
124
- unless @transitions.empty?
125
- local = TimeOrDateTime.wrap(local)
126
- index = transition_index(local.year, local.mon)
127
-
128
- result = []
129
-
130
- start_index = transition_after_start(index - 1)
131
- if start_index && @transitions[start_index].local_end_at > local
132
- if start_index > 0
133
- if @transitions[start_index - 1].local_start_at <= local
134
- result << TimezonePeriod.new(@transitions[start_index - 1], @transitions[start_index])
135
- end
136
- else
137
- result << TimezonePeriod.new(nil, @transitions[start_index])
138
- end
139
- end
140
-
141
- end_index = transition_before_end(index + 1)
142
-
143
- if end_index
144
- start_index = end_index unless start_index
145
-
146
- start_index.upto(transition_before_end(index + 1)) do |i|
147
- if @transitions[i].local_start_at <= local
148
- if i + 1 < @transitions.length
149
- if @transitions[i + 1].local_end_at > local
150
- result << TimezonePeriod.new(@transitions[i], @transitions[i + 1])
151
- end
152
- else
153
- result << TimezonePeriod.new(@transitions[i], nil)
154
- end
155
- end
156
- end
157
- end
158
-
159
- result
160
- else
161
- raise NoOffsetsDefined, 'No offsets have been defined' unless @previous_offset
162
- [TimezonePeriod.new(nil, nil, @previous_offset)]
163
- end
164
- end
165
-
166
- # Returns an Array of TimezoneTransition instances representing the times
167
- # where the UTC offset of the timezone changes.
168
- #
169
- # Transitions are returned up to a given date and time up to a given date
170
- # and time, specified in UTC (utc_to).
171
- #
172
- # A from date and time may also be supplied using the utc_from parameter
173
- # (also specified in UTC). If utc_from is not nil, only transitions from
174
- # that date and time onwards will be returned.
175
- #
176
- # Comparisons with utc_to are exclusive. Comparisons with utc_from are
177
- # inclusive. If a transition falls precisely on utc_to, it will be excluded.
178
- # If a transition falls on utc_from, it will be included.
179
- #
180
- # Transitions returned are ordered by when they occur, from earliest to
181
- # latest.
182
- #
183
- # utc_to and utc_from can be specified using either DateTime, Time or
184
- # integer timestamps (Time.to_i).
185
- #
186
- # If utc_from is specified and utc_to is not greater than utc_from, then
187
- # transitions_up_to raises an ArgumentError exception.
188
- def transitions_up_to(utc_to, utc_from = nil)
189
- utc_to = TimeOrDateTime.wrap(utc_to)
190
- utc_from = utc_from ? TimeOrDateTime.wrap(utc_from) : nil
191
-
192
- if utc_from && utc_to <= utc_from
193
- raise ArgumentError, 'utc_to must be greater than utc_from'
194
- end
195
-
196
- unless @transitions.empty?
197
- if utc_from
198
- from = transition_after_start(transition_index(utc_from.year, utc_from.mon))
199
-
200
- if from
201
- while from < @transitions.length && @transitions[from].at < utc_from
202
- from += 1
203
- end
204
-
205
- if from >= @transitions.length
206
- return []
207
- end
208
- else
209
- # utc_from is later than last transition.
210
- return []
211
- end
212
- else
213
- from = 0
214
- end
215
-
216
- to = transition_before_end(transition_index(utc_to.year, utc_to.mon))
217
-
218
- if to
219
- while to >= 0 && @transitions[to].at >= utc_to
220
- to -= 1
221
- end
222
-
223
- if to < 0
224
- return []
225
- end
226
- else
227
- # utc_to is earlier than first transition.
228
- return []
229
- end
230
-
231
- @transitions[from..to]
232
- else
233
- []
234
- end
235
- end
236
-
237
- private
238
- # Returns the index into the @transitions_index array for a given year
239
- # and month.
240
- def transition_index(year, month)
241
- index = (year - @start_year) * 2
242
- index += 1 if month > 6
243
- index -= 1 if @start_month > 6
244
- index
245
- end
246
-
247
- # Returns the index into @transitions of the first transition that occurs
248
- # on or after the start of the given index into @transitions_index.
249
- # Returns nil if there are no such transitions.
250
- def transition_after_start(index)
251
- if index >= @transitions_index.length
252
- nil
253
- else
254
- index = 0 if index < 0
255
- @transitions_index[index]
256
- end
257
- end
258
-
259
- # Returns the index into @transitions of the first transition that occurs
260
- # before the end of the given index into @transitions_index.
261
- # Returns nil if there are no such transitions.
262
- def transition_before_end(index)
263
- index = index + 1
264
-
265
- if index <= 0
266
- nil
267
- elsif index >= @transitions_index.length
268
- @transitions.length - 1
269
- else
270
- @transitions_index[index] - 1
271
- end
272
- end
273
- end
274
- end
@@ -1,37 +0,0 @@
1
- module TZInfo
2
- # Represents information about a country returned by ZoneinfoDataSource.
3
- #
4
- # @private
5
- class ZoneinfoCountryInfo < CountryInfo #:nodoc:
6
- # Constructs a new CountryInfo with an ISO 3166 country code, name and
7
- # an array of CountryTimezones.
8
- def initialize(code, name, zones)
9
- super(code, name)
10
- @zones = zones.dup.freeze
11
- @zone_identifiers = nil
12
- end
13
-
14
- # Returns a frozen array of all the zone identifiers for the country ordered
15
- # geographically, most populous first.
16
- def zone_identifiers
17
- # Thread-safety: It is possible that the value of @zone_identifiers may be
18
- # calculated multiple times in concurrently executing threads. It is not
19
- # worth the overhead of locking to ensure that @zone_identifiers is only
20
- # calculated once.
21
-
22
- unless @zone_identifiers
23
- result = zones.collect {|zone| zone.identifier}.freeze
24
- return result if frozen?
25
- @zone_identifiers = result
26
- end
27
-
28
- @zone_identifiers
29
- end
30
-
31
- # Returns a frozen array of all the timezones for the for the country
32
- # ordered geographically, most populous first.
33
- def zones
34
- @zones
35
- end
36
- end
37
- end