Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1qeLp4-006ZCp-Qn for pgsql-docs@arkaria.postgresql.org; Thu, 07 Sep 2023 20:41:54 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.94.2) (envelope-from ) id 1qeLp3-004fqm-Hb for pgsql-docs@arkaria.postgresql.org; Thu, 07 Sep 2023 20:41:53 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1qeLp3-004fqY-96 for pgsql-docs@lists.postgresql.org; Thu, 07 Sep 2023 20:41:53 +0000 Received: from sss.pgh.pa.us ([68.162.161.243]) by magus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1qeLoz-003kCz-OA for pgsql-docs@lists.postgresql.org; Thu, 07 Sep 2023 20:41:52 +0000 Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1]) by sss.pgh.pa.us (8.15.2/8.15.2) with ESMTP id 387Kfmoi1757506; Thu, 7 Sep 2023 16:41:48 -0400 From: Tom Lane To: Bruce Momjian cc: davecramer@postgres.rocks, pgsql-docs@lists.postgresql.org Subject: Re: Incorrect/confusing information about timetz In-reply-to: References: <168451942371.714.9173574930845904336@wrigleys.postgresql.org> Comments: In-reply-to Bruce Momjian message dated "Thu, 07 Sep 2023 16:33:37 -0400" MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <1757504.1694119308.1@sss.pgh.pa.us> Date: Thu, 07 Sep 2023 16:41:48 -0400 Message-ID: <1757505.1694119308@sss.pgh.pa.us> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk Bruce Momjian 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." regards, tom lane