Merge pull request #2886 from ham0215/add-time-new

Time#new(iso8601, in: nil)を追加

refm/api/src/_builtin/Time

@@ -330,6 +330,26 @@ 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")                  # => 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
+
 == Instance Methods
 
 --- +(other)    -> Time