From: | "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> |
---|---|
To: | Bruce Momjian <bruce(at)momjian(dot)us> |
Cc: | "jindrich(at)vavruska(dot)cz" <jindrich(at)vavruska(dot)cz>, "pgsql-docs(at)lists(dot)postgresql(dot)org" <pgsql-docs(at)lists(dot)postgresql(dot)org> |
Subject: | Re: Confusing information in sections 8.5 and 9.9 (date and time types, functions and operators) |
Date: | 2019-04-13 07:30:53 |
Message-ID: | CAKFQuwY81OuNa=Rf91rsSfATjjOLrksWVys5YcLZGjdWP9+0ZQ@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
On Friday, April 12, 2019, Bruce Momjian <bruce(at)momjian(dot)us> wrote:
> On Tue, Apr 9, 2019 at 02:50:14PM +0000, PG Doc comments form wrote:
> > The following documentation comment has been logged on the website:
> >
> I think
> > this is a serious issue, especially because the alternative possibility
> of
> > using ::timestamp is not even mentioned in chapters 8.5 or 9.9. If
> someone
> > (like me) looks for specific information how to handle date & time
> literals,
> > they will inevitably fall into the same trap.
> > Since the experienced Syntax error is contrary to what one would expect
> > after reading the SQL language manual, could you please at least add some
> > hyperlink in both sections 8.5 and 9.9 to attract reader's attention to
> this
> > specific behavior of the database server? Thank you.
>
> We don't get this question very often. I wonder if you didn't look at
> the error message we generated, or if you could share the exact error
> you saw.
>
>
See also:
The docs maybe aren’t great at covering this but they do, and correctly.
Though maybe a note saying “this works but you probably should use actual
casts” would be warranted. I personally have not found a need to use the
“type” ‘literal’ syntax.
David J.
From | Date | Subject | |
---|---|---|---|
Next Message | Jindřich Vavruška | 2019-04-15 04:16:15 | RE: Confusing information in sections 8.5 and 9.9 (date and time types, functions and operators) |
Previous Message | Bruce Momjian | 2019-04-13 02:49:06 | Re: Confusing information in sections 8.5 and 9.9 (date and time types, functions and operators) |