kotovalexarian-likes-github/ruby--ruby
1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00
Code Releases Activity

* ext/date/date_core.c: [DOC] Clean up whitespace, examples, and typos

Browse source 
in date_core based on a patch by @vipulnsward [Fixes GH-724]
  https://github.com/ruby/ruby/pull/724


git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@47895 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
This commit is contained in:
zzak 2014-10-12 18:21:41 +00:00
parent 37d0c873f6
commit 6769d5d5ac
2 changed files with 37 additions and 25 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
ChangeLog
View file

@ -1,3 +1,9 @@
Mon Oct 13 03:20:23 2014 Zachary Scott <e@zzak.io>
* ext/date/date_core.c: [DOC] Clean up whitespace, examples, and typos
in date_core based on a patch by @vipulnsward [Fixes GH-724]
https://github.com/ruby/ruby/pull/724
Mon Oct 13 02:39:26 2014 Nobuyoshi Nakada <nobu@ruby-lang.org> Mon Oct 13 02:39:26 2014 Nobuyoshi Nakada <nobu@ruby-lang.org>
* parse.y (remove_duplicate_keys): should not simply eliminate all * parse.y (remove_duplicate_keys): should not simply eliminate all

56
ext/date/date_core.c
View file

@ -9051,7 +9051,7 @@ Init_date_core(void)
* The calendar week is a seven day period within a calendar year, * The calendar week is a seven day period within a calendar year,
* starting on a Monday and identified by its ordinal number within * starting on a Monday and identified by its ordinal number within
* the year; the first calendar week of the year is the one that * the year; the first calendar week of the year is the one that
* includes the first Thursday of that year. In the Gregorian * includes the first Thursday of that year. In the Gregorian
* calendar, this is equivalent to the week which includes January 4. * calendar, this is equivalent to the week which includes January 4.
* *
* In those classes, this so-called "commercial". * In those classes, this so-called "commercial".
@ -9062,8 +9062,8 @@ Init_date_core(void)
* time) on January 1, 4713 BCE (in the Julian calendar). * time) on January 1, 4713 BCE (in the Julian calendar).
* *
* In this document, the astronomical Julian day number is same as the * In this document, the astronomical Julian day number is same as the
* original Julian day number. And the chronological Julian day * original Julian day number. And the chronological Julian day
* number is a variation of the Julian day number. Its days begin at * number is a variation of the Julian day number. Its days begin at
* midnight on local time. * midnight on local time.
* *
* In this document, when the term "Julian day number" simply appears, * In this document, when the term "Julian day number" simply appears,
@ -9079,9 +9079,9 @@ Init_date_core(void)
* Gregorian calendar). * Gregorian calendar).
* *
* In this document, the astronomical modified Julian day number is * In this document, the astronomical modified Julian day number is
* same as the original modified Julian day number. And the * same as the original modified Julian day number. And the
* chronological modified Julian day number is a variation of the * chronological modified Julian day number is a variation of the
* modified Julian day number. Its days begin at midnight on local * modified Julian day number. Its days begin at midnight on local
* time. * time.
* *
* In this document, when the term "modified Julian day number" simply * In this document, when the term "modified Julian day number" simply
@ -9090,10 +9090,9 @@ Init_date_core(void)
* *
* In those classes, this is so-called "mjd". * In those classes, this is so-called "mjd".
* *
*
* == Date * == Date
* *
* A subclass of Object includes Comparable module, easily handles * A subclass of Object that includes Comparable module and easily handles
* date. * date.
* *
* Date object is created with Date::new, Date::jd, Date::ordinal, * Date object is created with Date::new, Date::jd, Date::ordinal,
@ -9102,14 +9101,20 @@ Init_date_core(void)
* *
* require 'date' * require 'date'
* *
* Date.new(2001,2,3) #=> #<Date: 2001-02-03 ...> * Date.new(2001,2,3)
* Date.jd(2451944) #=> #<Date: 2001-02-03 ...> * #=> #<Date: 2001-02-03 ...>
* Date.ordinal(2001,34) #=> #<Date: 2001-02-03 ...> * Date.jd(2451944)
* Date.commercial(2001,5,6) #=> #<Date: 2001-02-03 ...> * #=> #<Date: 2001-02-03 ...>
* Date.parse('2001-02-03') #=> #<Date: 2001-02-03 ...> * Date.ordinal(2001,34)
* #=> #<Date: 2001-02-03 ...>
* Date.commercial(2001,5,6)
* #=> #<Date: 2001-02-03 ...>
* Date.parse('2001-02-03')
* #=> #<Date: 2001-02-03 ...>
* Date.strptime('03-02-2001', '%d-%m-%Y') * Date.strptime('03-02-2001', '%d-%m-%Y')
* #=> #<Date: 2001-02-03 ...> * #=> #<Date: 2001-02-03 ...>
* Time.new(2001,2,3).to_date #=> #<Date: 2001-02-03 ...> * Time.new(2001,2,3).to_date
* #=> #<Date: 2001-02-03 ...>
* *
* All date objects are immutable; hence cannot modify themselves. * All date objects are immutable; hence cannot modify themselves.
* *
@ -9117,11 +9122,11 @@ Init_date_core(void)
* of the day count, the offset and the day of calendar reform. * of the day count, the offset and the day of calendar reform.
* *
* The day count denotes the absolute position of a temporal * The day count denotes the absolute position of a temporal
* dimension. The offset is relative adjustment, which determines * dimension. The offset is relative adjustment, which determines
* decoded local time with the day count. The day of calendar * decoded local time with the day count. The day of calendar
* reform denotes the start day of the new style. The old style * reform denotes the start day of the new style. The old style
* of the West is the Julian calendar which was adopted by * of the West is the Julian calendar which was adopted by
* Caersar. The new style is the Gregorian calendar, which is the * Caesar. The new style is the Gregorian calendar, which is the
* current civil calendar of many countries. * current civil calendar of many countries.
* *
* The day count is virtually the astronomical Julian day number. * The day count is virtually the astronomical Julian day number.
@ -9162,10 +9167,10 @@ Init_date_core(void)
* *
* == DateTime * == DateTime
* *
* A subclass of Date easily handles date, hour, minute, second and * A subclass of Date that easily handles date, hour, minute, second and
* offset. * offset.
* *
* DateTime does not consider any leapseconds, does not track * DateTime does not consider any leap seconds, does not track
* any summer time rules. * any summer time rules.
* *
* DateTime object is created with DateTime::new, DateTime::jd, * DateTime object is created with DateTime::new, DateTime::jd,
@ -9177,7 +9182,7 @@ Init_date_core(void)
* DateTime.new(2001,2,3,4,5,6) * DateTime.new(2001,2,3,4,5,6)
* #=> #<DateTime: 2001-02-03T04:05:06+00:00 ...> * #=> #<DateTime: 2001-02-03T04:05:06+00:00 ...>
* *
* The last element of day, hour, minute or senond can be * The last element of day, hour, minute or second can be
* fractional number. The fractional number's precision is assumed * fractional number. The fractional number's precision is assumed
* at most nanosecond. * at most nanosecond.
* *
@ -9185,14 +9190,15 @@ Init_date_core(void)
* #=> #<DateTime: 2001-02-03T12:00:00+00:00 ...> * #=> #<DateTime: 2001-02-03T12:00:00+00:00 ...>
* *
* An optional argument the offset indicates the difference * An optional argument the offset indicates the difference
* between the local time and UTC. For example, Rational(3,24) * between the local time and UTC. For example, Rational(3,24)
* represents ahead of 3 hours of UTC, Rational(-5,24) represents * represents ahead of 3 hours of UTC, Rational(-5,24) represents
* behind of 5 hours of UTC. The offset should be -1 to +1, and * behind of 5 hours of UTC. The offset should be -1 to +1, and
* its precision is assumed at most second. The default value is * its precision is assumed at most second. The default value is
* zero (equals to UTC). * zero(equals to UTC).
* *
* DateTime.new(2001,2,3,4,5,6,Rational(3,24)) * DateTime.new(2001,2,3,4,5,6,Rational(3,24))
* #=> #<DateTime: 2001-02-03T04:05:06+03:00 ...> * #=> #<DateTime: 2001-02-03T04:05:06+03:00 ...>
*
* also accepts string form. * also accepts string form.
* *
* DateTime.new(2001,2,3,4,5,6,'+03:00') * DateTime.new(2001,2,3,4,5,6,'+03:00')