Clarify documentation of age() functions.

4828445d · Tom Lane · 5374d097 · 4828445d
Commit 4828445d authored Dec 01, 2004 by Tom Lane
Hide whitespace changes
Inline Side-by-side

Showing with 10 additions and 9 deletions

doc/src/sgml/func.sgml doc/src/sgml/func.sgml +10 -9

No files found.
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.224 2004/11/27 21:27:06 petere Exp $
+$PostgreSQL: pgsql/doc/src/sgml/func.sgml,v 1.225 2004/12/01 19:32:12 tgl Exp $
 PostgreSQL documentation
 -->
@@ -4877,19 +4877,20 @@ substring('foobar' from 'o(.)b')   <lineannotation>o</lineannotation>
      <tbody>
       <row>
-	<entry><literal><function>age</function>(<type>timestamp</type>)</literal></entry>
+	<entry><literal><function>age</function>(<type>timestamp</type>, <type>timestamp</type>)</literal></entry>
 	<entry><type>interval</type></entry>
-	<entry>Subtract from today</entry>
+	<entry>Subtract arguments, producing a <quote>symbolic</> result that
-	<entry><literal>age(timestamp '1957-06-13')</literal></entry>
+	uses years and months</entry>
-	<entry><literal>43 years 8 mons 3 days</literal></entry>
+	<entry><literal>age(timestamp '2001-04-10', timestamp '1957-06-13')</literal></entry>
+	<entry><literal>43 years 9 mons 27 days</literal></entry>
       </row>
       <row>
-	<entry><literal><function>age</function>(<type>timestamp</type>, <type>timestamp</type>)</literal></entry>
+	<entry><literal><function>age</function>(<type>timestamp</type>)</literal></entry>
 	<entry><type>interval</type></entry>
-	<entry>Subtract arguments</entry>
+	<entry>Subtract from <function>current_date</function></entry>
-	<entry><literal>age('2001-04-10', timestamp '1957-06-13')</literal></entry>
+	<entry><literal>age(timestamp '1957-06-13')</literal></entry>
-	<entry><literal>43 years 9 mons 27 days</literal></entry>
+	<entry><literal>43 years 8 mons 3 days</literal></entry>
       </row>
       <row>