From 67345bfa8222fe4d9b15d1d6ebf8cab31a9b1f6e Mon Sep 17 00:00:00 2001 From: tadf Date: Sat, 11 Jun 2011 16:07:37 +0000 Subject: * ext/date/date_core.c: edited doc. git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@32016 b2dd03c8-39d4-4d8f-98ff-823fe69b080e --- ChangeLog | 4 ++++ ext/date/date_core.c | 50 +++++++++++++++++++++++++++----------------------- 2 files changed, 31 insertions(+), 23 deletions(-) diff --git a/ChangeLog b/ChangeLog index 5d228f4797..222e8f6ba2 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +Sun Jun 12 01:07:09 2011 Tadayoshi Funaba + + * ext/date/date_core.c: edited doc. + Sat Jun 11 23:18:00 2011 KOSAKI Motohiro * vm_core.h (RUBY_VM_SET_TIMER_INTERRUPT, RUBY_VM_SET_INTERRUPT, diff --git a/ext/date/date_core.c b/ext/date/date_core.c index 26bc3ff8a7..a8492e4913 100644 --- a/ext/date/date_core.c +++ b/ext/date/date_core.c @@ -3224,10 +3224,10 @@ date_s_ordinal(int argc, VALUE *argv, VALUE klass) * They should not be zero. * * The last argument should be a Julian day number which denotes the - * day of calendar reform. Date::ITALY (1582-10-15), Date::ENGLAND - * (1752-09-14), Date::GREGORIAN (the proleptic Gregorian calendar) - * and Date::JULIAN (the proleptic Julian calendar) can be specified - * as a day of calendar reform. + * day of calendar reform. Date::ITALY (2299161=1582-10-15), + * Date::ENGLAND (2361222=1752-09-14), Date::GREGORIAN (the proleptic + * Gregorian calendar) and Date::JULIAN (the proleptic Julian + * calendar) can be specified as a day of calendar reform. * * For example: * @@ -4718,7 +4718,7 @@ d_lite_year(VALUE self) /* * call-seq: - * d.yday -> integer + * d.yday -> fixnum * * Returns the day of the year (1-366). */ @@ -4731,8 +4731,8 @@ d_lite_yday(VALUE self) /* * call-seq: - * d.mon -> integer - * d.month -> integer + * d.mon -> fixnum + * d.month -> fixnum * * Returns the month (1-12). */ @@ -4745,8 +4745,8 @@ d_lite_mon(VALUE self) /* * call-seq: - * d.mday -> integer - * d.day -> integer + * d.mday -> fixnum + * d.day -> fixnum * * Returns the day of the month (1-31). */ @@ -4787,7 +4787,7 @@ d_lite_cwyear(VALUE self) /* * call-seq: - * d.cweek -> integer + * d.cweek -> fixnum * * Returns the calendar week number (1-53). */ @@ -4800,7 +4800,7 @@ d_lite_cweek(VALUE self) /* * call-seq: - * d.cwday -> integer + * d.cwday -> fixnum * * Returns the day of calendar week (1-7, Monday is 1). */ @@ -4827,7 +4827,7 @@ d_lite_wnum1(VALUE self) /* * call-seq: - * d.wday -> integer + * d.wday -> fixnum * * Returns the day of week (0-6, Sunday is zero). */ @@ -4951,7 +4951,7 @@ d_lite_nth_kday_p(VALUE self, VALUE n, VALUE k) /* * call-seq: - * d.hour -> integer + * d.hour -> fixnum * * Returns the hour (0-23). */ @@ -4964,8 +4964,8 @@ d_lite_hour(VALUE self) /* * call-seq: - * d.min -> integer - * d.minute -> integer + * d.min -> fixnum + * d.minute -> fixnum * * Returns the minute (0-59). */ @@ -4978,8 +4978,8 @@ d_lite_min(VALUE self) /* * call-seq: - * d.sec -> integer - * d.second -> integer + * d.sec -> fixnum + * d.second -> fixnum * * Returns the second (0-59). */ @@ -6070,6 +6070,9 @@ cmp_dd(VALUE self, VALUE other) * Date.new(2001,2,3) <=> Date.new(2001,2,3) #=> 0 * Date.new(2001,2,3) <=> Date.new(2001,2,2) #=> 1 * Date.new(2001,2,3) <=> Object.new #=> nil + * Date.new(2001,2,3) <=> Rational(4903887,2)#=> 0 + * + * See also Comparable. */ static VALUE d_lite_cmp(VALUE self, VALUE other) @@ -6633,7 +6636,7 @@ date_strftime_internal(int argc, VALUE *argv, VALUE self, * * %M - Minute of the hour (00..59) * - * %S - Second of the minute (00..60) + * %S - Second of the minute (00..59) * * %L - Millisecond of the second (000..999) * %N - Fractional seconds digits, default is 9 digits (nanosecond) @@ -8002,7 +8005,7 @@ dt_lite_to_s(VALUE self) * * %M - Minute of the hour (00..59) * - * %S - Second of the minute (00..60) + * %S - Second of the minute (00..59) * * %L - Millisecond of the second (000..999) * %N - Fractional seconds digits, default is 9 digits (nanosecond) @@ -8869,7 +8872,8 @@ Init_date_core(void) * * An optional argument the day of calendar reform (start) as a * Julian day number, which should be 2298874 to 2426355 or -/+oo. - * The default value is Date::ITALY. See also sample/cal.rb. + * The default value is Date::ITALY (2299161=1582-10-15). See + * also sample/cal.rb. * * $ ruby sample/cal.rb -c it 10 1582 * October 1582 @@ -8922,8 +8926,8 @@ Init_date_core(void) * An optional argument offset indicates the difference between * the local time and UTC. For example, Rational(3,24) represents * ahead of 3 hours of UTC, Rational(-5,24) represents behind of 5 - * hours of UTC. The offset's precision is at most second. The - * default value is zero (UTC). + * hours of UTC. The offset should be -1 to +1, and its precision + * is at most second. The default value is zero (equals to UTC). * * DateTime.new(2001,2,3,4,5,6,Rational(3,24)) * #=> # @@ -8934,7 +8938,7 @@ Init_date_core(void) * * An optional argument the day of calendar reform (start) denotes * a Julian day number, which should be 2298874 to 2426355 or - * -/+oo. The default value is Date::ITALY. + * -/+oo. The default value is Date::ITALY (2299161=1582-10-15). * * DateTime object has various methods. See each reference. * -- cgit v1.2.3