summaryrefslogtreecommitdiff
path: root/timev.rb
diff options
context:
space:
mode:
authorNobuyoshi Nakada <nobu@ruby-lang.org>2020-12-28 21:13:41 +0900
committerNobuyoshi Nakada <nobu@ruby-lang.org>2021-01-13 18:15:50 +0900
commit4b15caee8fe7a5aaa52ed5a3ab2a3517c9206fd7 (patch)
tree4f1daf3b9beaa6298d690094636c5d37f40556e2 /timev.rb
parent6f6dfdcc685077f0f85dcdd63843ecfc0f6fbfb6 (diff)
Added `in:` timezone option to `Time.new` [Feature #17485]
Notes
Notes: Merged: https://github.com/ruby/ruby/pull/4010
Diffstat (limited to 'timev.rb')
-rw-r--r--timev.rb55
1 files changed, 54 insertions, 1 deletions
diff --git a/timev.rb b/timev.rb
index 37cefafd42..d0989cb06d 100644
--- a/timev.rb
+++ b/timev.rb
@@ -7,7 +7,7 @@
#
# Time.now #=> 2009-06-24 12:39:54 +0900
def Time.now(in: nil)
- __builtin.time_s_now(__builtin.arg!(:in))
+ new(in: __builtin.arg!(:in))
end
#
@@ -60,3 +60,56 @@ end
def Time.at(time, subsec = (nosubsec = true), unit = (nounit = true), in: nil)
__builtin.time_s_at(time, subsec, unit, __builtin.arg!(:in), nosubsec, nounit)
end
+
+class Time
+ # call-seq:
+ # Time.new -> time
+ # Time.new(year, month=nil, day=nil, hour=nil, min=nil, sec=nil, tz=nil) -> time
+ # Time.new(year, month=nil, day=nil, hour=nil, min=nil, sec=nil, in: tz) -> time
+ #
+ # Returns a Time object.
+ #
+ # It is initialized to the current system time if no argument is given.
+ #
+ # *Note:* The new object will use the resolution available on your
+ # system clock, and may include subsecond.
+ #
+ # If one or more arguments are specified, the time is initialized to the
+ # specified time.
+ #
+ # +sec+ may have subsecond if it is a rational.
+ #
+ # +tz+ specifies the timezone.
+ # It can be an offset from UTC, given either as a string such as "+09:00"
+ # or a single letter "A".."Z" excluding "J" (so-called military time zone),
+ # or as a number of seconds such as 32400.
+ # Or it can be a timezone object,
+ # see {Timezone argument}[#class-Time-label-Timezone+argument] for details.
+ #
+ # a = Time.new #=> 2020-07-21 01:27:44.917547285 +0900
+ # b = Time.new #=> 2020-07-21 01:27:44.917617713 +0900
+ # a == b #=> false
+ # "%.6f" % a.to_f #=> "1595262464.917547"
+ # "%.6f" % b.to_f #=> "1595262464.917618"
+ #
+ # Time.new(2008,6,21, 13,30,0, "+09:00") #=> 2008-06-21 13:30:00 +0900
+ #
+ # # A trip for RubyConf 2007
+ # t1 = Time.new(2007,11,1,15,25,0, "+09:00") # JST (Narita)
+ # t2 = Time.new(2007,11,1,12, 5,0, "-05:00") # CDT (Minneapolis)
+ # t3 = Time.new(2007,11,1,13,25,0, "-05:00") # CDT (Minneapolis)
+ # t4 = Time.new(2007,11,1,16,53,0, "-04:00") # EDT (Charlotte)
+ # t5 = Time.new(2007,11,5, 9,24,0, "-05:00") # EST (Charlotte)
+ # t6 = Time.new(2007,11,5,11,21,0, "-05:00") # EST (Detroit)
+ # t7 = Time.new(2007,11,5,13,45,0, "-05:00") # EST (Detroit)
+ # t8 = Time.new(2007,11,6,17,10,0, "+09:00") # JST (Narita)
+ # (t2-t1)/3600.0 #=> 10.666666666666666
+ # (t4-t3)/3600.0 #=> 2.466666666666667
+ # (t6-t5)/3600.0 #=> 1.95
+ # (t8-t7)/3600.0 #=> 13.416666666666666
+ def initialize(year = (now = true), mon = nil, mday = nil, hour = nil, min = nil, sec = nil, zone = nil, in: zone)
+ zone = __builtin.arg!(:in)
+ return __builtin.time_init_now(zone) if now
+ __builtin.time_init_args(year, mon, mday, hour, min, sec, zone)
+ end
+end