time 0.4.2 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc9964ca1d565e8395c46c83ffcf74b0a69ba3655dae9869a1a90f349b8d6586
-  data.tar.gz: c7500638e2132c8d5ed66243bea7d3e93f52933ecd504e159385a788e4682bc2
+  metadata.gz: 6ad6ef6fa9d67bc974c6b57e3885ddbf4950f1467be228eee70a9104f905a5ec
+  data.tar.gz: de3739295b2c8923b7e76b1a895235052dcb4b49a3fff8725aede781568cbea3
 SHA512:
-  metadata.gz: 28c4cdaa51d8060a1ba0282fbe6d49e5f1b7574e693631fe2fd038503bc26a1e95004e8e931a908bdd3b8af11e7018307541e40163d62898422319d07ff40c02
-  data.tar.gz: 68b674ba7b85e2f7a2bb731bf89f515b81fcda6a5dd3501e8f1debb9bda574a530c6941fce013179ea54d91e8ddbf53ab1e7c1312226098bc17a10cb9a57bee5
+  metadata.gz: afdc920a6bb5caf7081e7d3019a0162559f9ed8fce7bd884c0c83f51caa88647d78ef0b1588fc1691f209aebae5a306341e2a155ed56a6a18005e191a52f5b56
+  data.tar.gz: cb6f69028390588f8986d32e4d3c9322fc5cd3ef96e5c161415d46562b6179158c9efb8490b920c59e4adcb3ccae16866ab370b8b15c2fc5b92540d1033a48b7

data/lib/time.rb

@@ -27,7 +27,7 @@ require 'date'
 # #
 class Time
 
-  VERSION = "0.4.2"             # :nodoc:
+  VERSION = "0.5.0"             # :nodoc:
 
   class << Time
 
@@ -369,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.
     #
@@ -382,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
 
     #
@@ -507,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.
     #
@@ -624,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
@@ -652,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
 
   #
@@ -731,4 +777,5 @@ class Time
     end
   end
   alias iso8601 xmlschema unless method_defined?(:iso8601)
+  alias rfc3339 xmlschema
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: time
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.5.0
 platform: ruby
 authors:
 - Tanaka Akira
 bindir: exe
 cert_chain: []
-date: 2025-12-17 00:00:00.000000000 Z
+date: 2026-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: date
@@ -43,6 +43,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/ruby/time
   source_code_uri: https://github.com/ruby/time
+  changelog_uri: https://github.com/ruby/time/releases
 rdoc_options: []
 require_paths:
 - lib