github
/
ruby
зеркало из https://github.com/github/ruby.git
1
0
Форкнуть 0
Код Задачи Пакеты Проекты Релизы Вики Активность

time.c: improve docs for Time 

* time.c: [DOC] fix typos, drop unnecessary `p' from code examples,
  add missing `#' for return values, other small improvements.

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@66389 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
This commit is contained in:
stomar 2018-12-13 22:41:44 +00:00
Родитель 6b6b59f7fd
Коммит bd78a07f46
1 изменённых файлов: 44 добавлений и 44 удалений
Показать статистику Скачать Patch файл Скачать Diff файл Показать все файлы Свернуть все файлы

88
time.c
Просмотреть файл

@ -2325,8 +2325,8 @@ time_init_1(int argc, VALUE *argv, VALUE time)
* *Note:* The new object will use the resolution available on your * *Note:* The new object will use the resolution available on your
* system clock, and may include fractional seconds. * system clock, and may include fractional seconds.
* *
* If one or more arguments specified, the time is initialized to the specified * If one or more arguments are specified, the time is initialized to the
* time. * specified time.
* *
* +sec+ may have fraction if it is a rational. * +sec+ may have fraction if it is a rational.
* *
@ -2350,10 +2350,10 @@ time_init_1(int argc, VALUE *argv, VALUE time)
* t6 = Time.new(2007,11,5,11,21,0, "-05:00") # EST (Detroit) * 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) * 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) * t8 = Time.new(2007,11,6,17,10,0, "+09:00") # JST (Narita)
* p((t2-t1)/3600.0) #=> 10.666666666666666 * (t2-t1)/3600.0 #=> 10.666666666666666
* p((t4-t3)/3600.0) #=> 2.466666666666667 * (t4-t3)/3600.0 #=> 2.466666666666667
* p((t6-t5)/3600.0) #=> 1.95 * (t6-t5)/3600.0 #=> 1.95
* p((t8-t7)/3600.0) #=> 13.416666666666666 * (t8-t7)/3600.0 #=> 13.416666666666666
* *
* Or it can be a timezone object. * Or it can be a timezone object.
* See {Timezone argument}[#class-Time-label-Timezone+argument] for * See {Timezone argument}[#class-Time-label-Timezone+argument] for
@ -2695,7 +2695,7 @@ get_scale(VALUE unit)
* Time.at(-284061600) #=> 1960-12-31 00:00:00 -0600 * Time.at(-284061600) #=> 1960-12-31 00:00:00 -0600
* Time.at(946684800.2).usec #=> 200000 * Time.at(946684800.2).usec #=> 200000
* Time.at(946684800, 123456.789).nsec #=> 123456789 * Time.at(946684800, 123456.789).nsec #=> 123456789
* Time.at(946684800, 123456789, :nsec).nsec #=> 123456789 * Time.at(946684800, 123456789, :nsec).nsec #=> 123456789
*/ */
static VALUE static VALUE
@ -3436,7 +3436,7 @@ time_to_i(VALUE time)
* t.to_i #=> 1270968744 * t.to_i #=> 1270968744
* *
* Note that IEEE 754 double is not accurate enough to represent * Note that IEEE 754 double is not accurate enough to represent
* the number of nanoseconds since the Epoch. * the exact number of nanoseconds since the Epoch.
*/ */
static VALUE static VALUE
@ -3456,7 +3456,7 @@ time_to_f(VALUE time)
* since the Epoch. * since the Epoch.
* *
* t = Time.now * t = Time.now
* p t.to_r #=> (1270968792716287611/1000000000) * t.to_r #=> (1270968792716287611/1000000000)
* *
* This methods is intended to be used to get an accurate value * This methods is intended to be used to get an accurate value
* representing the nanoseconds since the Epoch. You can use this method * representing the nanoseconds since the Epoch. You can use this method
@ -3559,7 +3559,7 @@ time_subsec(VALUE time)
/* /*
* call-seq: * call-seq:
* time <=> other_time -> -1, 0, +1 or nil * time <=> other_time -> -1, 0, +1, or nil
* *
* Comparison---Compares +time+ with +other_time+. * Comparison---Compares +time+ with +other_time+.
* *
@ -3756,7 +3756,7 @@ time_zonelocal(VALUE time, VALUE off)
* t.localtime("+09:00") #=> 2000-01-02 05:15:01 +0900 * t.localtime("+09:00") #=> 2000-01-02 05:15:01 +0900
* t.utc? #=> false * t.utc? #=> false
* *
* If +utc_offset+ is not given and _time_ is local time, just return * If +utc_offset+ is not given and _time_ is local time, just returns
* the receiver. * the receiver.
*/ */
@ -3961,11 +3961,11 @@ time_asctime(VALUE time)
* #strftime with the appropriate format string. * #strftime with the appropriate format string.
* *
* t = Time.now * t = Time.now
* t.to_s => "2012-11-10 18:16:12 +0100" * t.to_s #=> "2012-11-10 18:16:12 +0100"
* t.strftime "%Y-%m-%d %H:%M:%S %z" => "2012-11-10 18:16:12 +0100" * t.strftime "%Y-%m-%d %H:%M:%S %z" #=> "2012-11-10 18:16:12 +0100"
* *
* t.utc.to_s => "2012-11-10 17:16:12 UTC" * t.utc.to_s #=> "2012-11-10 17:16:12 UTC"
* t.strftime "%Y-%m-%d %H:%M:%S UTC" => "2012-11-10 17:16:12 UTC" * t.strftime "%Y-%m-%d %H:%M:%S UTC" #=> "2012-11-10 17:16:12 UTC"
*/ */
static VALUE static VALUE
@ -4096,35 +4096,35 @@ rb_time_succ(VALUE time)
* *
* Rounds sub seconds to a given precision in decimal digits (0 digits by default). * Rounds sub seconds to a given precision in decimal digits (0 digits by default).
* It returns a new Time object. * It returns a new Time object.
* +ndigits+ should be zero or positive integer. * +ndigits+ should be zero or a positive integer.
* *
* require 'time' * require 'time'
* *
* t = Time.utc(2010,3,30, 5,43,"25.123456789".to_r) * t = Time.utc(2010,3,30, 5,43,"25.123456789".to_r)
* p t.iso8601(10) #=> "2010-03-30T05:43:25.1234567890Z" * t.iso8601(10) #=> "2010-03-30T05:43:25.1234567890Z"
* p t.round.iso8601(10) #=> "2010-03-30T05:43:25.0000000000Z" * t.round.iso8601(10) #=> "2010-03-30T05:43:25.0000000000Z"
* p t.round(0).iso8601(10) #=> "2010-03-30T05:43:25.0000000000Z" * t.round(0).iso8601(10) #=> "2010-03-30T05:43:25.0000000000Z"
* p t.round(1).iso8601(10) #=> "2010-03-30T05:43:25.1000000000Z" * t.round(1).iso8601(10) #=> "2010-03-30T05:43:25.1000000000Z"
* p t.round(2).iso8601(10) #=> "2010-03-30T05:43:25.1200000000Z" * t.round(2).iso8601(10) #=> "2010-03-30T05:43:25.1200000000Z"
* p t.round(3).iso8601(10) #=> "2010-03-30T05:43:25.1230000000Z" * t.round(3).iso8601(10) #=> "2010-03-30T05:43:25.1230000000Z"
* p t.round(4).iso8601(10) #=> "2010-03-30T05:43:25.1235000000Z" * t.round(4).iso8601(10) #=> "2010-03-30T05:43:25.1235000000Z"
* p t.round(5).iso8601(10) #=> "2010-03-30T05:43:25.1234600000Z" * t.round(5).iso8601(10) #=> "2010-03-30T05:43:25.1234600000Z"
* p t.round(6).iso8601(10) #=> "2010-03-30T05:43:25.1234570000Z" * t.round(6).iso8601(10) #=> "2010-03-30T05:43:25.1234570000Z"
* p t.round(7).iso8601(10) #=> "2010-03-30T05:43:25.1234568000Z" * t.round(7).iso8601(10) #=> "2010-03-30T05:43:25.1234568000Z"
* p t.round(8).iso8601(10) #=> "2010-03-30T05:43:25.1234567900Z" * t.round(8).iso8601(10) #=> "2010-03-30T05:43:25.1234567900Z"
* p t.round(9).iso8601(10) #=> "2010-03-30T05:43:25.1234567890Z" * t.round(9).iso8601(10) #=> "2010-03-30T05:43:25.1234567890Z"
* p t.round(10).iso8601(10) #=> "2010-03-30T05:43:25.1234567890Z" * t.round(10).iso8601(10) #=> "2010-03-30T05:43:25.1234567890Z"
* *
* t = Time.utc(1999,12,31, 23,59,59) * t = Time.utc(1999,12,31, 23,59,59)
* p((t + 0.4).round.iso8601(3)) #=> "1999-12-31T23:59:59.000Z" * (t + 0.4).round.iso8601(3) #=> "1999-12-31T23:59:59.000Z"
* p((t + 0.49).round.iso8601(3)) #=> "1999-12-31T23:59:59.000Z" * (t + 0.49).round.iso8601(3) #=> "1999-12-31T23:59:59.000Z"
* p((t + 0.5).round.iso8601(3)) #=> "2000-01-01T00:00:00.000Z" * (t + 0.5).round.iso8601(3) #=> "2000-01-01T00:00:00.000Z"
* p((t + 1.4).round.iso8601(3)) #=> "2000-01-01T00:00:00.000Z" * (t + 1.4).round.iso8601(3) #=> "2000-01-01T00:00:00.000Z"
* p((t + 1.49).round.iso8601(3)) #=> "2000-01-01T00:00:00.000Z" * (t + 1.49).round.iso8601(3) #=> "2000-01-01T00:00:00.000Z"
* p((t + 1.5).round.iso8601(3)) #=> "2000-01-01T00:00:01.000Z" * (t + 1.5).round.iso8601(3) #=> "2000-01-01T00:00:01.000Z"
* *
* t = Time.utc(1999,12,31, 23,59,59) * t = Time.utc(1999,12,31, 23,59,59)
* p (t + 0.123456789).round(4).iso8601(6) #=> "1999-12-31T23:59:59.123500Z" * (t + 0.123456789).round(4).iso8601(6) #=> "1999-12-31T23:59:59.123500Z"
*/ */
static VALUE static VALUE
@ -4348,7 +4348,7 @@ time_sunday(VALUE time)
* Returns +true+ if _time_ represents Monday. * Returns +true+ if _time_ represents Monday.
* *
* t = Time.local(2003, 8, 4) #=> 2003-08-04 00:00:00 -0500 * t = Time.local(2003, 8, 4) #=> 2003-08-04 00:00:00 -0500
* p t.monday? #=> true * t.monday? #=> true
*/ */
static VALUE static VALUE
@ -4364,7 +4364,7 @@ time_monday(VALUE time)
* Returns +true+ if _time_ represents Tuesday. * Returns +true+ if _time_ represents Tuesday.
* *
* t = Time.local(1991, 2, 19) #=> 1991-02-19 00:00:00 -0600 * t = Time.local(1991, 2, 19) #=> 1991-02-19 00:00:00 -0600
* p t.tuesday? #=> true * t.tuesday? #=> true
*/ */
static VALUE static VALUE
@ -4380,7 +4380,7 @@ time_tuesday(VALUE time)
* Returns +true+ if _time_ represents Wednesday. * Returns +true+ if _time_ represents Wednesday.
* *
* t = Time.local(1993, 2, 24) #=> 1993-02-24 00:00:00 -0600 * t = Time.local(1993, 2, 24) #=> 1993-02-24 00:00:00 -0600
* p t.wednesday? #=> true * t.wednesday? #=> true
*/ */
static VALUE static VALUE
@ -4396,7 +4396,7 @@ time_wednesday(VALUE time)
* Returns +true+ if _time_ represents Thursday. * Returns +true+ if _time_ represents Thursday.
* *
* t = Time.local(1995, 12, 21) #=> 1995-12-21 00:00:00 -0600 * t = Time.local(1995, 12, 21) #=> 1995-12-21 00:00:00 -0600
* p t.thursday? #=> true * t.thursday? #=> true
*/ */
static VALUE static VALUE
@ -4764,15 +4764,15 @@ strftime_cstr(const char *fmt, size_t len, VALUE time, rb_encoding *enc)
* America/Havana (-05:00), Asia/Harbin (+08:00), Australia/Darwin (+09:30) * America/Havana (-05:00), Asia/Harbin (+08:00), Australia/Darwin (+09:30)
* and Australia/Adelaide (+10:30). * and Australia/Adelaide (+10:30).
* Also, %Z is highly dependent on the operating system. * Also, %Z is highly dependent on the operating system.
* For example, it may generate a non ASCII string on Japanese Windows. * For example, it may generate a non ASCII string on Japanese Windows,
* i.e. the result can be different to "JST". * i.e. the result can be different to "JST".
* So the numeric time zone offset, %z, is recommended. * So the numeric time zone offset, %z, is recommended.
* *
* Examples: * Examples:
* *
* t = Time.new(2007,11,19,8,37,48,"-06:00") #=> 2007-11-19 08:37:48 -0600 * t = Time.new(2007,11,19,8,37,48,"-06:00") #=> 2007-11-19 08:37:48 -0600
* t.strftime("Printed on %m/%d/%Y") #=> "Printed on 11/19/2007" * t.strftime("Printed on %m/%d/%Y") #=> "Printed on 11/19/2007"
* t.strftime("at %I:%M%p") #=> "at 08:37AM" * t.strftime("at %I:%M %p") #=> "at 08:37 AM"
* *
* Various ISO 8601 formats: * Various ISO 8601 formats:
* %Y%m%d => 20071119 Calendar date (basic) * %Y%m%d => 20071119 Calendar date (basic)
@ -5479,7 +5479,7 @@ rb_time_zone_abbreviation(VALUE zone, VALUE time)
* *
* The +name+ method is used for marshaling. If this method is not * The +name+ method is used for marshaling. If this method is not
* defined on a timezone object, Time objects using that timezone * defined on a timezone object, Time objects using that timezone
* object are not able to dump by Marshal. * object can not be dumped by Marshal.
* *
* The +abbr+ method is used by '%Z' in #strftime. * The +abbr+ method is used by '%Z' in #strftime.
* *