Re: Incorrect/confusing information about timetz

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: davecramer(at)postgres(dot)rocks, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Incorrect/confusing information about timetz
Date: 2023-09-26 23:24:22
Message-ID: ZRNoJps0Zsd3KwsB@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Thu, Sep 7, 2023 at 05:00:59PM -0400, Bruce Momjian wrote:
> On Thu, Sep 7, 2023 at 04:41:48PM -0400, Tom Lane wrote:
> > Bruce Momjian <bruce(at)momjian(dot)us> writes:
> > > Uh, yes to the storage part, no to the output part. ;-) Postgres does
> > > store the timetz time zone offset, but it doesn't adust it once it is
> > > stored so doesn't adjust for the session time zone:
> >
> > Right, it just stores a numeric UTC offset.
> >
> > > Do we want to document this?
> >
> > Section 8.5.1.2. Times already says "The appropriate time zone offset
> > is recorded in the time with time zone value." Maybe that could be
> > made a little more precise, say "The resolved numeric offset from UTC
> > is recorded in the time with time zone value."
>
> Yeah, there is no mention of it odd output behavior. Here is a patch to
> add that.

Patch applied back to Postgres 11.

--
Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com

Only you can decide what is important to you.

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Daniel Gustafsson 2023-09-27 07:42:49 Re: pg_upgrade doc uses inconsistent versions within the doc.
Previous Message Bruce Momjian 2023-09-26 21:31:30 Re: group by can use alias from select list