From: Tom Lane <tgl@sss.pgh.pa.us>
To: David Kubecka <davidkubecka366@gmail.com>
Cc: pgsql-bugs@postgresql.org
Subject: Re: Possibly misleading documentation of Template Patterns for Date/Time Formatting
Date: Fri, 17 Apr 2020 11:52:08 -0400
Message-ID: <4089.1587138728@sss.pgh.pa.us> (raw)
In-Reply-To: <CAKtMQEcOQtf6=7s6FO1Sq4bo-GQVWJVujkoL2oiK25v34oUTrQ@mail.gmail.com>
References: <CAKtMQEcOQtf6=7s6FO1Sq4bo-GQVWJVujkoL2oiK25v34oUTrQ@mail.gmail.com>
David Kubecka <davidkubecka366@gmail.com> writes:
> on the official docs
> https://www.postgresql.org/docs/9.6/functions-formatting.html see the table
> 9-24 and Pattern "Q". The doc (for version 9.6) says:
> quarter (ignored by to_date and to_timestamp)
> All the later versions of the doc (10, 11, 12) miss the "ignored" note
It's still there, just further down:
* In to_timestamp and to_date, weekday names or numbers (DAY, D, and
related field types) are accepted but are ignored for purposes of
computing the result. The same is true for quarter (Q) fields.
I think this was changed because we noticed that the docs failed to point
out the issue for weekday fields, and cramming similar annotations into
their already-long table entries didn't make sense. So the info got moved
to the commentary below.
regards, tom lane
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-bugs@postgresql.org
Cc: tgl@sss.pgh.pa.us, davidkubecka366@gmail.com
Subject: Re: Possibly misleading documentation of Template Patterns for Date/Time Formatting
In-Reply-To: <4089.1587138728@sss.pgh.pa.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox