Re: Please clarify that Timestamp with Timezone doesn't preserve the timezone.

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Dave Cramer <davecramer(at)postgres(dot)rocks>
Cc: Robert Treat <rob(at)xzilla(dot)net>, Kirk Parker <khp(at)equatoria(dot)us>, Richard Neill <rjn(at)richardneill(dot)org>, github(at)richardneill(dot)org, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Please clarify that Timestamp with Timezone doesn't preserve the timezone.
Date: 2026-05-14 16:39:48
Message-ID: agX61I5SYlFJ8pFE@momjian.us
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Thu, May 14, 2026 at 08:17:36AM -0400, Dave Cramer wrote:
>
>
> On Thu, 14 May 2026 at 08:05, Bruce Momjian <bruce(at)momjian(dot)us> wrote:
>
> On Thu, May 14, 2026 at 07:57:21AM -0400, Robert Treat wrote:
> > > I see your point.  I went with adding the wording "no time zone
> > > adjustment" and "with time zone adjustment" in the table.  Patch
> > > attached.  You can see the output at:
> >
> > The quibble I have with the term "time zone adjustment" is that it
> > implies there will be some adjustment, but while you can change your
> > timezone preferences to display a timestamptz value in whatever time
> > zone you want, the value itself is never adjusted; it is stored as a
> > universal moment in time that doesn't change, regardless of the window
> > dressing around it. For this reason I have taken to describing that
> > difference between the two as that timestamptz stores the date and
> > time with timezone awareness, and timestamp is date and time with no
> > timezone awareness. Perhaps that might work better here as well?
>
> I used "adjustment" because the value is adjusted on input, and adjusted
> on output.  I would say the value is not "aware" of the time zone
> because once it is internally stored as UTC it is no longer aware of the
> original time zone.
>
>
> Adjusted seems like the wrong word. I think the correct word is converted.

Okay, here is the patch with "conversion".

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

Do not let urgent matters crowd out time for investment in the future.

Attachment Content-Type Size
time_zone.diff text/x-diff 3.3 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2026-05-14 18:02:15 Re: Please clarify that Timestamp with Timezone doesn't preserve the timezone.
Previous Message David G. Johnston 2026-05-14 16:35:19 Re: Please clarify that Timestamp with Timezone doesn't preserve the timezone.