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 1qlHPp-002552-Jo for pgsql-docs@arkaria.postgresql.org; Tue, 26 Sep 2023 23:24:29 +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 1qlHPo-00G7vN-6F for pgsql-docs@arkaria.postgresql.org; Tue, 26 Sep 2023 23:24:28 +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 1qlHPn-00G7vB-Tz for pgsql-docs@lists.postgresql.org; Tue, 26 Sep 2023 23:24:27 +0000 Received: from momjian.us ([72.94.173.45]) by magus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1qlHPk-007mCj-Nc for pgsql-docs@lists.postgresql.org; Tue, 26 Sep 2023 23:24:27 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=momjian.us; s=2023062407; h=In-Reply-To:Content-Type:MIME-Version:References:Message-ID: Subject:Cc:To:From:Date:Sender:Reply-To:Content-Transfer-Encoding:Content-ID: Content-Description; bh=MMjemGNN1/N2okHnnDqHaI32alo++Fzub+qw/5fOLyg=; b=dx9NI TeZjmI4AshZu7L2jbbbLayw59AslpYkhit3+kf1TQOLp1efpR1fPMKhoqWhiL8AOdCJkuyKoJuj+P qfxdqZSi5/M64yZnwQQCj84HSpV4gLLZfExx86wonJUlZeoFzbc+xS+3cMvLqqz58XKpJ2wZ+r3qS 2n9xuitKJzdPWCCStbjxkPYk826XE7040U8dvCNcqPMK0owghbc407Rf5g8rkl87pxSvqzdoVSINU wGU2rZHK4vcHHW6RnQd2xaSC/xAROqW0/gUcZDkhDaY+/5Cxxr6lnjm5Hc8oCm387PCFGWgAMXWa+ mbePvxg7G48+dfR2qTXwkjnKqNQGA==; Received: from bruce by momjian.us with local (Exim 4.96) (envelope-from ) id 1qlHPi-001zhe-1q; Tue, 26 Sep 2023 19:24:22 -0400 Date: Tue, 26 Sep 2023 19:24:22 -0400 From: Bruce Momjian To: Tom Lane Cc: davecramer@postgres.rocks, pgsql-docs@lists.postgresql.org Subject: Re: Incorrect/confusing information about timetz Message-ID: References: <168451942371.714.9173574930845904336@wrigleys.postgresql.org> <1757505.1694119308@sss.pgh.pa.us> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk 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 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 https://momjian.us EDB https://enterprisedb.com Only you can decide what is important to you.