Date: Tue, 21 Nov 2023 23:33:39 -0500
From: Bruce Momjian <bruce@momjian.us>
To: juha.mustonen@iki.fi
Cc: pgsql-docs@postgresql.org
Subject: Re: [DOCS] Add example about date ISO format
Message-ID: <ZV2Eo8P4q_2_F1Qe@momjian.us>
References: <20170217160154.6101.52806@wrigleys.postgresql.org>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="IRq7uP0QVUYYPTjo"
Content-Disposition: inline
In-Reply-To: <20170217160154.6101.52806@wrigleys.postgresql.org>
Archived-At: 
 <https://www.postgresql.org/message-id/ZV2Eo8P4q_2_F1Qe%40momjian.us>
Precedence: bulk


--IRq7uP0QVUYYPTjo
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

On Fri, Feb 17, 2017 at 04:01:54PM +0000, juha.mustonen@iki.fi wrote:
> The following documentation comment has been logged on the website:
> 
> Page: https://www.postgresql.org/docs/9.6/static/functions-formatting.html
> Description:
> 
> The documentation should include an example how to format datetime entry
> into most commonly known ISO format. This is a bit tricky as literal
> character needs to included with quotes:
> 
> to_char(NOW(), &#39;YYYY-MM-DD&quot;T&quot;HH24:MI:SSZ&#39;)

I know this is a six-year-old idea, but it is still a good one.  I have
developed the attached patch I would like to apply to master.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.

--IRq7uP0QVUYYPTjo
Content-Type: text/x-diff; charset=us-ascii
Content-Disposition: attachment; filename="iso.diff"

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 93f068edcf..297cafb341 100644
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -8489,6 +8489,14 @@ SELECT regexp_match('abc01234xyz', '(?:(.*?)(\d+)(.*)){1,1}');
       </para>
      </listitem>
 
+     <listitem>
+      <para>
+        <literal>to_char(current_timestamp AT TIME ZONE 'UTC',
+        'YYYY-MM-DD"T"HH24:MI:SSZ')</literal> outputs the current UTC
+        date/time in <acronym>ISO</acronym> 8601 date/time format.
+      </para>
+     </listitem>
+
     </itemizedlist>
    </para>
 

--IRq7uP0QVUYYPTjo--