mirror of
https://github.com/ruby/ruby.git
synced 2022-11-09 12:17:21 -05:00
[ruby/date] [DOC] Fix about calendars difference
https://github.com/ruby/date/commit/0ae93e26aa
This commit is contained in:
parent
1607c6d281
commit
289d219758
1 changed files with 7 additions and 8 deletions
|
@ -4,19 +4,16 @@ The difference between the
|
|||
{Julian calendar}[https://en.wikipedia.org/wiki/Julian_calendar]
|
||||
and the
|
||||
{Gregorian calendar}[https://en.wikipedia.org/wiki/Gregorian_calendar]
|
||||
may matter to your program if it uses dates in the interval:
|
||||
may matter to your program if it uses dates before the switchovers.
|
||||
|
||||
- October 15, 1582.
|
||||
- September 14, 1752.
|
||||
|
||||
A date outside that interval (including all dates in modern times)
|
||||
is the same in both calendars.
|
||||
However, a date _within_ that interval will be different
|
||||
in the two calendars.
|
||||
A date will be different in the two calendars, in general.
|
||||
|
||||
=== Different Calendar, Different \Date
|
||||
=== Different switchover dates
|
||||
|
||||
The reason for the difference is this:
|
||||
The reasons for the difference are religious/political histories.
|
||||
|
||||
- On October 15, 1582, several countries changed
|
||||
from the Julian calendar to the Gregorian calendar;
|
||||
|
@ -25,10 +22,12 @@ The reason for the difference is this:
|
|||
- On September 14, 1752, most of the British empire
|
||||
changed from the Julian calendar to the Gregorian calendar.
|
||||
|
||||
When your code uses a date in this "gap" interval,
|
||||
When your code uses a date before these switchover dates,
|
||||
it will matter whether it considers the switchover date
|
||||
to be the earlier date or the later date (or neither).
|
||||
|
||||
See also {a concrete example here}[rdoc-ref:DateTime@When+should+you+use+DateTime+and+when+should+you+use+Time-3F].
|
||||
|
||||
=== Argument +start+
|
||||
|
||||
Certain methods in class \Date handle differences in the
|
||||
|
|
Loading…
Reference in a new issue