tzinfo 0.3.62 → 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4528fdaf2d333c768db081b62c4a17775f4831ba
+  data.tar.gz: 67b2c0fe496fe49ecd841e350ef12c543f54af73
+SHA512:
+  metadata.gz: 97020f33249326b5d02e64ecb34507efd9bb208ada4906a490629b33cfe593bbc7c1e4bf2d69594da77ac0dd3348c1cd29118cc31a5ba86e53ef69b10189dbb5
+  data.tar.gz: 0edc8726e627d6ea0226941bcf26841e17513144e79df3e18229981d53c5af4b2cfb4a7fd59b5b5b5c26058b0637cea3ec2668144dac83f581b98f5b84adf7fc

data/CHANGES

@@ -1,159 +1,26 @@
-== Version 0.3.62 (tzdata v2023c) - 10-Apr-2023
-
-* Updated to tzdata version 2023c
-  (https://mm.icann.org/pipermail/tz-announce/2023-March/000079.html).
-* Increased the maximum year from 2050 to 2073 (include 50 years of future data
-  to match tzinfo-data).
-
-
-== Version 0.3.61 (tzdata v2022a) - 19-Jul-2022
-
-* Fixed a relative path traversal bug that could cause arbitrary files to be
-  loaded with require from the Ruby load path. Please refer to
-  https://github.com/tzinfo/tzinfo/security/advisories/GHSA-5cm2-9h8c-rvfx for
-  details. CVE-2022-31163.
-* Updated to tzdata version 2022a
-  (https://mm.icann.org/pipermail/tz-announce/2022-March/000070.html).
-
-
-== Version 0.3.60 (tzdata v2021a) - 6-Feb-2021
-
-* Updated to tzdata version 2021a
-  (https://mm.icann.org/pipermail/tz-announce/2021-January/000065.html).
-
-
-== Version 0.3.59 (tzdata v2020e) - 24-Dec-2020
-
-* Updated to tzdata version 2020e
-  (https://mm.icann.org/pipermail/tz-announce/2020-December/000063.html).
-
-
-== Version 0.3.58 (tzdata v2020d) - 8-Nov-2020
-
-* Updated to tzdata version 2020d
-  (https://mm.icann.org/pipermail/tz-announce/2020-October/000062.html).
-
-
-== Version 0.3.57 (tzdata v2020a) - 17-May-2020
-
-* Updated to tzdata version 2020a
-  (https://mm.icann.org/pipermail/tz-announce/2020-April/000058.html).
-
-
-== Version 0.3.56 (tzdata v2019c) - 1-Nov-2019
-
-* Updated to tzdata version 2019c
-  (https://mm.icann.org/pipermail/tz-announce/2019-September/000057.html).
-
-
-== Version 0.3.55 (tzdata v2018g) - 27-Oct-2018
-
-* Updated to tzdata version 2018g
-  (https://mm.icann.org/pipermail/tz-announce/2018-October/000052.html).
-
-
-== Version 0.3.54 (tzdata v2018d) - 25-Mar-2018
-
-* Updated to tzdata version 2018d
-  (https://mm.icann.org/pipermail/tz-announce/2018-March/000049.html).
-
-
-== Version 0.3.53 (tzdata v2017b) - 23-Mar-2017
-
-* Updated to tzdata version 2017b
-  (https://mm.icann.org/pipermail/tz-announce/2017-March/000046.html).
-
-
-== Version 0.3.52 (tzdata v2016h) - 28-Oct-2016
-
-* Updated to tzdata version 2016h
-  (https://mm.icann.org/pipermail/tz-announce/2016-October/000042.html).
-
-
-== Version 0.3.51 (tzdata v2016f) - 5-Jul-2016
-
-* Updated to tzdata version 2016f
-  (https://mm.icann.org/pipermail/tz-announce/2016-July/000040.html).
-
-
-== Version 0.3.50 (tzdata v2016e) - 14-Jun-2016
-
-* Updated to tzdata version 2016e
-  (https://mm.icann.org/pipermail/tz-announce/2016-June/000039.html).
-
-
-== Version 0.3.49 (tzdata v2016d) - 18-Apr-2016
-
-* Updated to tzdata version 2016d
-  (https://mm.icann.org/pipermail/tz-announce/2016-April/000038.html).
-
-
-== Version 0.3.48 (tzdata v2016c) - 23-Mar-2016
-
-* Updated to tzdata version 2016c
-  (https://mm.icann.org/pipermail/tz-announce/2016-March/000037.html).
-
-
-== Version 0.3.47 (tzdata v2016b) - 15-Mar-2016
-
-* Updated to tzdata version 2016b
-  (https://mm.icann.org/pipermail/tz-announce/2016-March/000036.html).
-
-
-== Version 0.3.46 (tzdata v2015g) - 2-Dec-2015
-
-* From version 2015e, the IANA time zone database uses non-ASCII characters in
-  country names. Backport the encoding handling from TZInfo::Data to allow
-  TZInfo 0.3.x to support Ruby 1.9 (which would otherwise fail with an invalid
-  byte sequence error when loading the countries index). Resolves #41.
-
-
-== Version 0.3.45 (tzdata v2015g) - 3-Oct-2015
-
-* Updated to tzdata version 2015g
-  (http://mm.icann.org/pipermail/tz-announce/2015-October/000034.html).
-
-
-== Version 0.3.44 (tzdata v2015d) - 24-Apr-2015
-
-* Updated to tzdata version 2015d
-  (http://mm.icann.org/pipermail/tz-announce/2015-April/000031.html).
-
-
-== Version 0.3.43 (tzdata v2015a) - 31-Jan-2015
-
-* Updated to tzdata version 2015a
-  (http://mm.icann.org/pipermail/tz-announce/2015-January/000028.html).
-
-
-== Version 0.3.42 (tzdata v2014i) - 23-Oct-2014
-
-* Updated to tzdata version 2014i
-  (http://mm.icann.org/pipermail/tz-announce/2014-October/000026.html).
-
-
-== Version 0.3.41 (tzdata v2014f) - 8-Aug-2014
-
-* Updated to tzdata version 2014f
-  (http://mm.icann.org/pipermail/tz-announce/2014-August/000023.html).
-
-
-== Version 0.3.40 (tzdata v2014e) - 10-Jul-2014
-
-* Updated to tzdata version 2014e
-  (http://mm.icann.org/pipermail/tz-announce/2014-June/000022.html).
-
-
-== Version 0.3.39 (tzdata v2014a) - 9-Mar-2014
-
-* Updated to tzdata version 2014a
-  (http://mm.icann.org/pipermail/tz-announce/2014-March/000018.html).
-
-
-== Version 0.3.38 (tzdata v2013g) - 8-Oct-2013
-
-* Updated to tzdata version 2013g
-  (http://mm.icann.org/pipermail/tz-announce/2013-October/000015.html).
+== Version 1.0.0 - 2-Jun-2013
+
+* Allow TZInfo to be used with different data sources instead of just the
+  built-in Ruby module data files.
+* Include a data source that allows TZInfo to load data from the binary
+  zoneinfo files produced by zic and included with many Linux and Unix-like
+  distributions.
+* Remove the definition and index Ruby modules from TZInfo and move them into
+  a separate TZInfo::Data library (available as the tzinfo-data gem).
+* Default to using the TZInfo::Data library as the data source if it is 
+  installed, otherwise use zoneinfo files instead.
+* Preserve the nanoseconds of local timezone Time objects when performing 
+  conversions (issue #29705).
+* Don't add the tzinfo lib directory to the search path when requiring 'tzinfo'.
+  The tzinfo lib directory must now be in the search path before 'tzinfo' is
+  required.
+* Add utc_start_time, utc_end_time, local_start_time and local_end_time instance
+  methods to TimezonePeriod. These return an identical value as the existing
+  utc_start, utc_end, local_start and local_end methods, but return Time
+  instances instead of DateTime.
+* Make the start_transition, end_transition and offset properties of
+  TimezonePeriod protected. To access properties of the period, callers should
+  use other TimezonePeriod instance methods instead (issue #7655).
 
 
 == Version 0.3.37 (tzdata v2013b) - 11-Mar-2013
@@ -448,9 +315,9 @@
 * The zdumptest utility now checks local to utc conversions in addition to
   utc to local conversions.
 * eql? method defined on Country and Timezone that is equivalent to ==.
-* == method of Timezone no longer raises an exception when passed an object
+* The == method of Timezone no longer raises an exception when passed an object
   with no identifier method.
-* == method of Country no longer raises an exception when passed an object
+* The == method of Country no longer raises an exception when passed an object
   with no code method.
 * hash method defined on Country that returns the hash of the code.
 * hash method defined on Timezone that returns the hash of the identifier.

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2005-2023 Philip Ross
+Copyright (c) 2005-2013 Philip Ross
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of 
 this software and associated documentation files (the "Software"), to deal in 

data/README

@@ -1,98 +1,132 @@
-= TZInfo -- Daylight-savings aware timezone support for Ruby
+= TZInfo - Ruby Timezone Library
 
-TZInfo[http://tzinfo.github.io] uses the IANA Time Zone Database 
-(http://www.iana.org/time-zones) to provide
-daylight-savings aware transformations between times in different timezones.
-This is the same database as used for zoneinfo on Unix machines.
+TZInfo[http://tzinfo.rubyforge.org] provides daylight savings aware 
+transformations between times in different timezones.
 
-The Time Zone database has been imported (using TZDataParser) and turned into a 
-set of Ruby modules (which are packaged with this release).
+
+== Data Sources
+
+TZInfo requires a source of timezone data. There are two built-in options:
+
+1. The TZInfo::Data library (the tzinfo-data gem). TZInfo::Data contains a set 
+   of Ruby modules that are generated from the {IANA Time Zone Database}[http://www.iana.org/time-zones].
+2. A zoneinfo directory. Most Unix-like systems include a zoneinfo directory 
+   containing timezone definitions. These are also generated from the 
+   {IANA Time Zone Database}[http://www.iana.org/time-zones].
+
+By default, TZInfo::Data will be used. If TZInfo::Data is not available (i.e. 
+if require 'tzinfo/data' fails), then TZInfo will search for a zoneinfo
+directory instead (using the search path specified by 
+TZInfo::ZoneinfoDataSource::DEFAULT_SEARCH_PATH).
+
+If no data source can be found, a TZInfo::DataSourceNotFound exception will be
+raised when TZInfo is used.
+
+The default data source selection can be overridden using 
+TZInfo::DataSource.set.
+
+Custom data sources can also be used. See TZInfo::DataSource.set for
+further details.
+
+
+== Installation
+
+The TZInfo gem can be installed by running:
+
+  $ gem install tzinfo
+
+To use the Ruby modules as the data source, TZInfo::Data will also need to be
+installed:
+
+  $ gem install tzinfo-data
+  
+
+== Download
+
+Tar, Zip and RubyGem packages of TZInfo and TZInfo::Data can be downloaded from
+http://rubyforge.org/frs/?group_id=894
 
 
 == Example usage
 
-To convert a time in UTC to a local time in the America/New_York timezone, you
-can do the following:
+The following code will obtain the America/New_York timezone (as an instance
+of TZInfo::Timezone) and covert a time in UTC to local New York time:
 
   require 'tzinfo'
   
   tz = TZInfo::Timezone.get('America/New_York')
   local = tz.utc_to_local(Time.utc(2005,8,29,15,35,0))
 
-Note that the Time returned will look like it is UTC (Time.zone will return 
-"UTC"). This is because it is not currently possible to change the offset of 
-an individual Time instance.
+Note that the local Time returned will have a UTC timezone (local.zone will 
+return "UTC"). This is because the Ruby Time class only supports two timezones: 
+UTC and the current system local timezone.
   
-To convert from a local time to UTC, the local_to_utc method can be used. 
+To convert from a local time to UTC, the local_to_utc method can be used as
+follows:
 
   utc = tz.local_to_utc(local)
 
-Note that the timezone information of the time you pass in is ignored. The
-following two lines will return the same result regardless of the local 
-timezone:
+Note that the timezone information of the local Time object is ignored (TZInfo
+will just read the date and time and treat them as if there were in the 'tz'
+timezone). The following two lines will return the same result regardless of 
+the system's local timezone:
 
   tz.local_to_utc(Time.local(2006,6,26,1,0,0))
   tz.local_to_utc(Time.utc(2006,6,26,1,0,0))
   
-To get information about the rules in force at a particular UTC or local time,
-the Timezone.period_for_utc and Timezone.period_for_local methods can be used.
-Both of these methods return TimezonePeriod objects. The following gets the 
-identifier for the period (in this case EDT).
+To obtain information about the rules in force at a particular UTC or local 
+time, the TZInfo::Timezone.period_for_utc and TZInfo::Timezone.period_for_local
+methods can be used. Both of these methods return TZInfo::TimezonePeriod 
+objects. The following gets the identifier for the period (in this case EDT).
 
-  period = tz.period_for_utc(DateTime.new(2005,8,29,15,35,0))
+  period = tz.period_for_utc(Time.utc(2005,8,29,15,35,0))
   id = period.zone_identifier
   
-In all the above examples, instances of Time can be used instead of DateTime.
-Timezone#utc_to_local and Timezone#local_to_utc both return the type they are 
-passed.
-
-You can get the current local time in a Timezone with the Timezone#now method:
+The current local time in a Timezone can be obtained with the 
+TZInfo::Timezone#now method:
 
   now = tz.now
 
-All methods in TZInfo that take a time can be used with either Time, DateTime
-or Integers (Time#to_i). The return type will be the same as the type passed in.
-  
-You can also access Timezones by Country (ISO 3166 country code). The following 
-gets all the Timezone identifiers for the US:
+All methods in TZInfo that operate on a time can be used with either Time or 
+DateTime instances or with Integer timestamps (i.e. as returned by Time#to_i). 
+The type of the values returned will match the the type passed in.
+
+A list of all the available Timezone identifiers can be obtained using the
+TZInfo::Timezone.all_identifiers method. TZInfo::Timezone.all can be called
+to get an Array of all the TZInfo::Timezone instances.
+
+Timezones can also be accessed by country (using an ISO 3166-1 alpha-2 country 
+code). The following code retrieves the TZInfo::Country instance representing 
+the USA (country code 'US') and then gets all the Timezone identifiers used in 
+the USA.
 
   us = TZInfo::Country.get('US')
   timezones = us.zone_identifiers
   
-The zone_info method of Country provides an additional description and
-location for each Timezone in the Country.
+The TZInfo::Country#zone_info method provides an additional description and 
+geographic location for each Timezone in a Country.
+
+A list of all the available country codes can be obtained using the
+TZInfo::Country.all_codes method. TZInfo::Country.all can be called to get an 
+Array of all the Country instances.
   
-The above covers the most common uses of Timezone and Country. For more detail,
-see the API documentation for the individual classes.
+For further detail, please refer to the API documentation for the 
+TZInfo::Timezone and TZInfo::Country classes.
 
 
 == Documentation
 
-API documentation for TZInfo is available on RubyDoc.info[http://rubydoc.info/gems/tzinfo/frames].
+API documentation can be found at 
 
+* http://tzinfo.rubyforge.org/doc/
 
-== Installation
-
-The preferred method of installing TZInfo is through the GEM file (RubyGems[http://docs.rubygems.org/] required):
-
-  % gem install tzinfo-x.y.z.gem
-  
-or to automatically download and install:
-
-  % gem install tzinfo --remote
-  
 
 == License
 
-TZInfo is released under the MIT[http://opensource.org/licenses/mit-license.html] license.
-
-
-== Source Code
-
-Source code for TZInfo is available on GitHub[https://github.com/tzinfo/tzinfo].
+TZInfo is released under the MIT license, see LICENSE for details.
 
 
-== Issue Tracker
+== Support
 
-Please post any bugs, issues, feature requests or questions to the 
-{GitHub issue tracker}[https://github.com/tzinfo/tzinfo/issues].
+Please post to the {TZInfo Users mailing list}[http://rubyforge.org/mailman/listinfo/tzinfo-users]
+if you require assistance or have any suggestions.