aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJay Belanger2007-09-01 04:13:52 +0000
committerJay Belanger2007-09-01 04:13:52 +0000
commit7a5e3e973f65c392ef86be21272fda2f4a0d1c67 (patch)
tree731be0812d79283a3bfbff0a200c454eb8c98b4f
parentecaf73343a56a8e46c88db245778e122a0696eb7 (diff)
downloademacs-7a5e3e973f65c392ef86be21272fda2f4a0d1c67.tar.gz
emacs-7a5e3e973f65c392ef86be21272fda2f4a0d1c67.zip
(Date Conversions): Clarify definition of Julian day.
(Date Forms): Clarify definition of Julian date; add some history.
-rw-r--r--man/ChangeLog7
-rw-r--r--man/calc.texi55
2 files changed, 48 insertions, 14 deletions
diff --git a/man/ChangeLog b/man/ChangeLog
index 245b4c7e96f..8e58d905937 100644
--- a/man/ChangeLog
+++ b/man/ChangeLog
@@ -1,3 +1,10 @@
12007-09-01 Jay Belanger <jay.p.belanger@gmail.com>
2
3 * calc.texi (Date Conversions): Clarify definition of
4 Julian day numbering.
5 (Date Forms): Clarify definition of Julian day numbering;
6 add some history.
7
12007-08-30 Carsten Dominik <dominik@science.uva.nl> 82007-08-30 Carsten Dominik <dominik@science.uva.nl>
2 9
3 * org.texi: Version 5.07 10 * org.texi: Version 5.07
diff --git a/man/calc.texi b/man/calc.texi
index 194d36d8f5f..93c7123d6a4 100644
--- a/man/calc.texi
+++ b/man/calc.texi
@@ -11053,17 +11053,44 @@ Please note that there is no ``year 0''; the day before
11053days 0 and @mathit{-1} respectively in Calc's internal numbering scheme. 11053days 0 and @mathit{-1} respectively in Calc's internal numbering scheme.
11054 11054
11055@cindex Julian day counting 11055@cindex Julian day counting
11056Another day counting system in common use is, confusingly, also 11056Another day counting system in common use is, confusingly, also called
11057called ``Julian.'' It was invented in 1583 by Joseph Justus 11057``Julian.'' The Julian day number is the numbers of days since
11058Scaliger, who named it in honor of his father Julius Caesar 1105812:00 noon (GMT) on Jan 1, 4713 BC, which in Calc's scheme (in GMT)
11059Scaliger. For obscure reasons he chose to start his day 11059is @mathit{-1721423.5} (recall that Calc starts at midnight instead
11060numbering on Jan 1, 4713 BC at noon, which in Calc's scheme 11060of noon). Thus to convert a Calc date code obtained by unpacking a
11061is @mathit{-1721423.5} (recall that Calc starts at midnight instead 11061date form into a Julian day number, simply add 1721423.5 after
11062of noon). Thus to convert a Calc date code obtained by 11062compensating for the time zone difference. The built-in @kbd{t J}
11063unpacking a date form into a Julian day number, simply add 11063command performs this conversion for you.
110641721423.5. The Julian code for @samp{6:00am Jan 9, 1991} 11064
11065is 2448265.75. The built-in @kbd{t J} command performs 11065The Julian day number is based on the Julian cycle, which was invented
11066this conversion for you. 11066in 1583 by Joseph Justus Scaliger. Scaliger named it the Julian cycle
11067since it is involves the Julian calendar, but some have suggested that
11068Scaliger named it in honor of his father, Julius Caesar Scaliger. The
11069Julian cycle is based it on three other cycles: the indiction cycle,
11070the Metonic cycle, and the solar cycle. The indiction cycle is a 15
11071year cycle originally used by the Romans for tax purposes but later
11072used to date medieval documents. The Metonic cycle is a 19 year
11073cycle; 19 years is close to being a common multiple of a solar year
11074and a lunar month, and so every 19 years the phases of the moon will
11075occur on the same days of the year. The solar cycle is a 28 year
11076cycle; the Julian calendar repeats itself every 28 years. The
11077smallest time period which contains multiples of all three cycles is
11078the least common multiple of 15 years, 19 years and 28 years, which
11079(since they're pairwise relatively prime) is
11080@texline @math{15\times 19\times 28 = 7980} years.
11081@infoline 15*19*28 = 7980 years.
11082This is the length of a Julian cycle. Working backwards, the previous
11083year in which all three cycles began was 4713 BC, and so Scalinger
11084chose that year as the beginning of a Julian cycle. Since at the time
11085there were no historical records from before 4713 BC, using this year
11086as a starting point had the advantage of avoiding negative year
11087numbers. In 1849, the astronomer John Herschel (son of William
11088Herschel) suggested using the number of days since the beginning of
11089the Julian cycle as an astronomical dating system; this idea was taken
11090up by other astronomers. (At the time, noon was the start of the
11091astronomical day. Herschel originally suggested counting the days
11092since Jan 1, 4713 BC at noon Alexandria time; this was later amended to
11093noon GMT.) Julian day numbering is largely used in astronomy.
11067 11094
11068@cindex Unix time format 11095@cindex Unix time format
11069The Unix operating system measures time as an integer number of 11096The Unix operating system measures time as an integer number of
@@ -16656,9 +16683,9 @@ The last two arguments default to zero if omitted.
16656@cindex Julian day counts, conversions 16683@cindex Julian day counts, conversions
16657The @kbd{t J} (@code{calc-julian}) [@code{julian}] command converts 16684The @kbd{t J} (@code{calc-julian}) [@code{julian}] command converts
16658a date form into a Julian day count, which is the number of days 16685a date form into a Julian day count, which is the number of days
16659since noon on Jan 1, 4713 BC. A pure date is converted to an integer 16686since noon (GMT) on Jan 1, 4713 BC. A pure date is converted to an
16660Julian count representing noon of that day. A date/time form is 16687integer Julian count representing noon of that day. A date/time form
16661converted to an exact floating-point Julian count, adjusted to 16688is converted to an exact floating-point Julian count, adjusted to
16662interpret the date form in the current time zone but the Julian 16689interpret the date form in the current time zone but the Julian
16663day count in Greenwich Mean Time. A numeric prefix argument allows 16690day count in Greenwich Mean Time. A numeric prefix argument allows
16664you to specify the time zone; @pxref{Time Zones}. Use a prefix of 16691you to specify the time zone; @pxref{Time Zones}. Use a prefix of