diff --git a/time.c b/time.c
index 53b3cde96dd134..557b26009d75d5 100644
--- a/time.c
+++ b/time.c
@@ -3585,6 +3585,8 @@ time_fixoff(VALUE time)
* local time (using the local time zone in effect for this process).
*
* If +utc_offset+ is given, it is used instead of the local time.
+ * +utc_offset+ can be given as a human-readable string (eg. "+09:00"
)
+ * or as a number of seconds (eg. 32400
).
*
* t = Time.utc(2000,1,1,20,15,1) #=> 2000-01-01 20:15:01 UTC
* t.utc? #=> true
@@ -3596,6 +3598,10 @@ time_fixoff(VALUE time)
* j = t.getlocal("+09:00") #=> 2000-01-02 05:15:01 +0900
* j.utc? #=> false
* t == j #=> true
+ *
+ * k = t.getlocal(9*60*60) #=> 2000-01-02 05:15:01 +0900
+ * k.utc? #=> false
+ * t == k #=> true
*/
static VALUE