From d019cac08a3eb77d71bbe47f9b651088ff07ac19 Mon Sep 17 00:00:00 2001 From: zverok Date: Sun, 8 Mar 2020 10:44:46 +0200 Subject: Clarify Time::at documentation for in: argument --- time.c | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) (limited to 'time.c') diff --git a/time.c b/time.c index e5e71e562e..e310ea3a96 100644 --- a/time.c +++ b/time.c @@ -2810,8 +2810,9 @@ get_scale(VALUE unit) * * If +in+ argument is given, the result is in that timezone or UTC offset, or * if a numeric argument is given, the result is in local time. - * The +in+ argument accepts timezones in +HH:MM or -HH:MM format along with - * accepting military timezones and UTC. + * The +in+ argument accepts the same types of arguments as +tz+ argument of + * Time::new: string, number of seconds, or a timezone object. + * * * Time.at(0) #=> 1969-12-31 18:00:00 -0600 * Time.at(Time.at(0)) #=> 1969-12-31 18:00:00 -0600 @@ -2820,9 +2821,15 @@ get_scale(VALUE unit) * Time.at(946684800.2).usec #=> 200000 * Time.at(946684800, 123456.789).nsec #=> 123456789 * Time.at(946684800, 123456789, :nsec).nsec #=> 123456789 + * * Time.at(1582721899, in: "+09:00") #=> 2020-02-26 21:58:19 +0900 * Time.at(1582721899, in: "UTC") #=> 2020-02-26 12:58:19 UTC * Time.at(1582721899, in: "C") #=> 2020-02-26 13:58:19 +0300 + * Time.at(1582721899, in: 32400) #=> 2020-02-26 21:58:19 +0900 + * + * require 'tzinfo' + * Time.at(1582721899, in: TZInfo::Timezone.get('Europe/Kiev')) + * #=> 2020-02-26 14:58:19 +0200 */ static VALUE -- cgit v1.2.1