time 0.4.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c211ffd223b56fae14493d2d7fb187ac2e7fa4f089943fba05174f0ee9549c4c
-  data.tar.gz: df4434890036e502a795ac24cfb93920ace49539b4ef2f092942cdef049ba141
+  metadata.gz: 6ad6ef6fa9d67bc974c6b57e3885ddbf4950f1467be228eee70a9104f905a5ec
+  data.tar.gz: de3739295b2c8923b7e76b1a895235052dcb4b49a3fff8725aede781568cbea3
 SHA512:
-  metadata.gz: 247084d1b3bbdda9a0f21652daf9d729a2f32d3aa89a16c3e4b78d305c49fa487c75386a80ebcd88b9bf0ccec224ae1aa1989baa4a96bbdb88e580b97812521f
-  data.tar.gz: 578f214835d4259e3a4cd9aff080806b29a04c886b90f8acd4f95527af581698722423fd85a4ef3e0d911b7f8f797adfdddfb3239c4cba20e4970299271b3a70
+  metadata.gz: afdc920a6bb5caf7081e7d3019a0162559f9ed8fce7bd884c0c83f51caa88647d78ef0b1588fc1691f209aebae5a306341e2a155ed56a6a18005e191a52f5b56
+  data.tar.gz: cb6f69028390588f8986d32e4d3c9322fc5cd3ef96e5c161415d46562b6179158c9efb8490b920c59e4adcb3ccae16866ab370b8b15c2fc5b92540d1033a48b7

data/.document

@@ -0,0 +1,4 @@
+BSDL
+COPYING
+README.md
+lib/

data/.rdoc_options

@@ -0,0 +1,2 @@
+---
+main_page: README.md

data/README.md

@@ -8,13 +8,16 @@ and converting Times.
 This library extends the Time class with the following conversions between
 date strings and Time objects:
 
-* date-time defined by {RFC 2822}[http://www.ietf.org/rfc/rfc2822.txt]
-* HTTP-date defined by {RFC 2616}[http://www.ietf.org/rfc/rfc2616.txt]
-* dateTime defined by XML Schema Part 2: Datatypes ({ISO
-  8601}[http://www.iso.org/iso/date_and_time_format])
+* date-time defined by [RFC 2822]
+* HTTP-date defined by [RFC 2616]
+* dateTime defined by XML Schema Part 2: Datatypes ([ISO 8601])
 * various formats handled by Date._parse
 * custom formats handled by Date._strptime
 
+[RFC 2822]: http://www.ietf.org/rfc/rfc2822.txt
+[RFC 2616]: http://www.ietf.org/rfc/rfc2616.txt
+[ISO 8601]: http://www.iso.org/iso/date_and_time_format
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -51,4 +54,3 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/ruby/time.
-

data/lib/time.rb

@@ -24,9 +24,10 @@ require 'date'
 
 # :startdoc:
 
+# #
 class Time
 
-  VERSION = "0.4.1"             # :nodoc:
+  VERSION = "0.5.0"             # :nodoc:
 
   class << Time
 
@@ -79,7 +80,7 @@ class Time
     #
     # You must require 'time' to use this method.
     #
-    def zone_offset(zone, year=self.now.year)
+    def zone_offset(zone, year=nil)
       off = nil
       zone = zone.upcase
       if /\A([+-])(\d\d)(:?)(\d\d)(?:\3(\d\d))?\z/ =~ zone
@@ -88,10 +89,13 @@ class Time
         off = zone.to_i * 3600
       elsif ZoneOffset.include?(zone)
         off = ZoneOffset[zone] * 3600
-      elsif ((t = self.local(year, 1, 1)).zone.upcase == zone rescue false)
-        off = t.utc_offset
-      elsif ((t = self.local(year, 7, 1)).zone.upcase == zone rescue false)
-        off = t.utc_offset
+      else
+        year ||= self.now.year
+        if ((t = self.local(year, 1, 1)).zone.upcase == zone rescue false)
+          off = t.utc_offset
+        elsif ((t = self.local(year, 7, 1)).zone.upcase == zone rescue false)
+          off = t.utc_offset
+        end
       end
       off
     end
@@ -365,6 +369,9 @@ class Time
     # If the extracted time zone abbreviation does not match any of them,
     # it is ignored and the given time is regarded as a local time.
     #
+    # A +zone+ argument can be provided to specify the zone for the given
+    # +date+, if the +date+ does not include a time zone or offset.
+    #
     # ArgumentError is raised if Date._parse cannot extract information from
     # +date+ or if the Time class cannot represent specified date.
     #
@@ -378,12 +385,12 @@ class Time
     #
     # You must require 'time' to use this method.
     #
-    def parse(date, now=self.now)
+    def parse(date, now=self.now, zone: nil)
       comp = !block_given?
       d = Date._parse(date, comp)
       year = d[:year]
       year = yield(year) if year && !comp
-      make_time(date, year, d[:yday], d[:mon], d[:mday], d[:hour], d[:min], d[:sec], d[:sec_fraction], d[:zone], now)
+      make_time(date, year, d[:yday], d[:mon], d[:mday], d[:hour], d[:min], d[:sec], d[:sec_fraction], d[:zone] || zone, now)
     end
 
     #
@@ -503,7 +510,7 @@ class Time
     #     require 'time'
     #
     #     Time.rfc2822("Wed, 05 Oct 2011 22:26:12 -0400")
-    #     #=> 2010-10-05 22:26:12 -0400
+    #     #=> 2011-10-05 22:26:12 -0400
     #
     # You must require 'time' to use this method.
     #
@@ -620,13 +627,58 @@ class Time
     # You must require 'time' to use this method.
     #
     def xmlschema(time)
-      if /\A\s*
+      pattern = /\A\s*
           (-?\d+)-(\d\d)-(\d\d)
           T
           (\d\d):(\d\d):(\d\d)
           (\.\d+)?
           (Z|[+-]\d\d(?::?\d\d)?)?
-          \s*\z/ix =~ time
+          \s*\z/ix
+      _xmlschema(pattern, time) or
+        raise ArgumentError.new("invalid xmlschema format: #{time.inspect}")
+    end
+    alias iso8601 xmlschema
+
+    #
+    # Parses +time+ as a dateTime defined by RFC3339 and converts it to
+    # a Time object.
+    #
+    # ArgumentError is raised if +time+ is not compliant with the format or if
+    # the Time class cannot represent the specified time.
+    #
+    # See #xmlschema for more information on this format.
+    #
+    #     require 'time'
+    #
+    #     Time.rfc3339("2011-10-05T22:26:12-04:00")
+    #     #=> 2011-10-05 22:26:12-04:00
+    #
+    # You must require 'time' to use this method.
+    #
+    def rfc3339(time)
+      pattern = /\A\s*
+          (-?\d{4})-(\d\d)-(\d\d)
+          [T ]
+          (\d\d):(\d\d):(\d\d)
+          (\.\d+)?
+          (Z|[+-]\d\d:\d\d)
+          \s*\z/ix
+      _xmlschema(pattern, time) or
+        raise ArgumentError.new("invalid rfc3339 format: #{time.inspect}")
+    end
+
+    private
+
+    if RUBY_VERSION >= "3.2"
+      def _xmlschema(pattern, time) # :nodoc:
+        return unless pattern.match?(time)
+        time = time.strip
+        time.upcase!
+        new(time)
+      end
+    else
+      def _xmlschema(pattern, time) # :nodoc:
+        return unless pattern =~ time
         year = $1.to_i
         mon = $2.to_i
         day = $3.to_i
@@ -648,11 +700,9 @@ class Time
         else
           self.local(year, mon, day, hour, min, sec, usec)
         end
-      else
-        raise ArgumentError.new("invalid xmlschema format: #{time.inspect}")
       end
     end
-    alias iso8601 xmlschema
+
   end # class << self
 
   #
@@ -727,4 +777,5 @@ class Time
     end
   end
   alias iso8601 xmlschema unless method_defined?(:iso8601)
+  alias rfc3339 xmlschema
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: time
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Tanaka Akira
-autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-11-08 00:00:00.000000000 Z
+date: 2026-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: date
@@ -31,6 +30,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".document"
+- ".rdoc_options"
 - BSDL
 - COPYING
 - README.md
@@ -42,7 +43,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/ruby/time
   source_code_uri: https://github.com/ruby/time
-post_install_message: 
+  changelog_uri: https://github.com/ruby/time/releases
 rdoc_options: []
 require_paths:
 - lib
@@ -57,8 +58,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Extends the Time class with methods for parsing and conversion.
 test_files: []