From de32ab1c1a359fb2400971231a5a810f38679659 Mon Sep 17 00:00:00 2001 From: Naoto Hamada Date: Thu, 23 May 2024 02:15:02 +0900 Subject: [PATCH 1/2] Add Time#new(iso8601, in: nil) document Added documentation because Time#new accepts strings in iso8602 format since Ruby 3.2. ref: https://bugs.ruby-lang.org/issues/18033 --- refm/api/src/_builtin/Time | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/refm/api/src/_builtin/Time b/refm/api/src/_builtin/Time index 44bb6bb2fa..79a7e5bbe5 100644 --- a/refm/api/src/_builtin/Time +++ b/refm/api/src/_builtin/Time @@ -330,6 +330,24 @@ zone に nil を指定した場合の値は、現在のタイムゾーンに従 p Time.new(2008, 6, 21, 13, 30, 0, "+09:00") # => 2008-06-21 13:30:00 +0900 #@end +#@since 3.2 +--- new(iso8601, in: nil) -> Time +引数で指定した地方時の Time オブジェクトを返します。 + +@param iso8601 Time#inspectの結果や制限されたISO-8601形式などの文字列を指定します。 + +@param in 協定世界時との時差を、秒を単位とする整数か、 + "UTC" かミリタリータイムゾーンの文字列または + "+HH:MM" "-HH:MM" 形式の文字列で指定します。 + iso8601 に指定された文字列がタイムゾーンを持っている場合は無視されます。 + +@raise ArgumentError iso8601が無効な形式の場合に発生します。 + +#@samplecode +p Time.new("2024-02-15 10:20:30 +0900", in: "+0800") # => 2024-02-15 10:20:30 +0900 +#@end +#@end + == Instance Methods --- +(other) -> Time From b4a93b9531423c961fd00339ed86d676975b05a6 Mon Sep 17 00:00:00 2001 From: Naoto Hamada Date: Sat, 25 May 2024 13:10:55 +0900 Subject: [PATCH 2/2] Fix samplecode --- refm/api/src/_builtin/Time | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/refm/api/src/_builtin/Time b/refm/api/src/_builtin/Time index 79a7e5bbe5..4ba0ae5b63 100644 --- a/refm/api/src/_builtin/Time +++ b/refm/api/src/_builtin/Time @@ -344,7 +344,9 @@ p Time.new(2008, 6, 21, 13, 30, 0, "+09:00") # => 2008-06-21 13:30:00 +0900 @raise ArgumentError iso8601が無効な形式の場合に発生します。 #@samplecode -p Time.new("2024-02-15 10:20:30 +0900", in: "+0800") # => 2024-02-15 10:20:30 +0900 +p Time.new("2024-02-15 10:20:30") # => 2024-02-15 10:20:30 +0900 +p Time.new("2024-02-15 10:20:30 UTC", in: "+0800") # => 2024-02-15 10:20:30 UTC +p Time.new("2024-02-15 10:20:30", in: "+0800") # => 2024-02-15 10:20:30 +0800 #@end #@end