Skip to content

Commit 0ae93e2

Browse files
committed
[DOC] Fix about calendars difference
1 parent 9906677 commit 0ae93e2

File tree

1 file changed

+7
-8
lines changed

1 file changed

+7
-8
lines changed

doc/date/calendars.rdoc

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,16 @@ The difference between the
44
{Julian calendar}[https://en.wikipedia.org/wiki/Julian_calendar]
55
and the
66
{Gregorian calendar}[https://en.wikipedia.org/wiki/Gregorian_calendar]
7-
may matter to your program if it uses dates in the interval:
7+
may matter to your program if it uses dates before the switchovers.
88

99
- October 15, 1582.
1010
- September 14, 1752.
1111

12-
A date outside that interval (including all dates in modern times)
13-
is the same in both calendars.
14-
However, a date _within_ that interval will be different
15-
in the two calendars.
12+
A date will be different in the two calendars, in general.
1613

17-
=== Different Calendar, Different \Date
14+
=== Different switchover dates
1815

19-
The reason for the difference is this:
16+
The reasons for the difference are religious/political histories.
2017

2118
- On October 15, 1582, several countries changed
2219
from the Julian calendar to the Gregorian calendar;
@@ -25,10 +22,12 @@ The reason for the difference is this:
2522
- On September 14, 1752, most of the British empire
2623
changed from the Julian calendar to the Gregorian calendar.
2724

28-
When your code uses a date in this "gap" interval,
25+
When your code uses a date before these switchover dates,
2926
it will matter whether it considers the switchover date
3027
to be the earlier date or the later date (or neither).
3128

29+
See also {a concrete example here}[rdoc-ref:DateTime@When+should+you+use+DateTime+and+when+should+you+use+Time-3F].
30+
3231
=== Argument +start+
3332

3433
Certain methods in class \Date handle differences in the

0 commit comments

Comments
 (0)