From a29d815a7a4a583bda02c2743d92feabd34886d8 Mon Sep 17 00:00:00 2001 From: Bruce Momjian <bruce@momjian.us> Date: Wed, 29 Jun 2005 01:52:56 +0000 Subject: [PATCH] Improve gettimeofday() documentation. Karl O. Pinc --- doc/src/sgml/func.sgml | 26 ++++++++++++++------------ 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml index 734686bf4a4..d837219421e 100644 --- a/doc/src/sgml/func.sgml +++ b/doc/src/sgml/func.sgml @@ -1,5 +1,5 @@ <!-- -$PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.261 2005/06/28 05:08:50 tgl Exp $ +$PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.262 2005/06/29 01:52:56 momjian Exp $ PostgreSQL documentation --> @@ -5786,15 +5786,6 @@ SELECT LOCALTIMESTAMP; <function>CURRENT_TIMESTAMP</function>. </para> - <para> - There is also the function <function>timeofday()</function>, which for historical - reasons returns a <type>text</type> string rather than a <type>timestamp</type> value: -<screen> -SELECT timeofday(); -<lineannotation>Result: </lineannotation><computeroutput>Sat Feb 17 19:07:32.000126 2001 EST</computeroutput> -</screen> - </para> - <para> It is important to know that <function>CURRENT_TIMESTAMP</function> and related functions return @@ -5803,8 +5794,7 @@ SELECT timeofday(); the intent is to allow a single transaction to have a consistent notion of the <quote>current</quote> time, so that multiple modifications within the same transaction bear the same - time stamp. <function>timeofday()</function> - returns the wall-clock time and does advance during transactions. + time stamp. </para> <note> @@ -5814,6 +5804,18 @@ SELECT timeofday(); </para> </note> + <para> + There is also the function <function>timeofday()</function> which + returns the wall-clock time and advances during transactions. For + historical reasons <function>timeofday()</function> returns a + <type>text</type> string rather than a <type>timestamp</type> + value: +<screen> +SELECT timeofday(); +<lineannotation>Result: </lineannotation><computeroutput>Sat Feb 17 19:07:32.000126 2001 EST</computeroutput> +</screen> + </para> + <para> All the date/time data types also accept the special literal value <literal>now</literal> to specify the current date and time. Thus, -- GitLab