Doc: document EXTRACT(JULIAN ...), improve Julian Date explanation.
authorTom Lane <tgl@sss.pgh.pa.us>
Mon, 26 Apr 2021 15:50:35 +0000 (11:50 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Mon, 26 Apr 2021 15:50:35 +0000 (11:50 -0400)
commit64d617de3c595226804e850b8c8a45517f794932
treebd1bdf7e49b093801aa1f7a30a9098f836e58be0
parentd59964999d15be29fcd97544e66780fc5c9f17a9
Doc: document EXTRACT(JULIAN ...), improve Julian Date explanation.

For some reason, the "julian" option for extract()/date_part() has
never gotten listed in the manual.  Also, while Appendix B mentioned
in passing that we don't conform to the usual astronomical definition
that a Julian date starts at noon UTC, it was kind of vague about what
we do instead.  Clarify that, and add an example showing how to get
the astronomical definition if you want it.

It's been like this for ages, so back-patch to all supported branches.

Discussion: https://postgr.es/m/1197050.1619123213@sss.pgh.pa.us
doc/src/sgml/datetime.sgml
doc/src/sgml/func.sgml