Add missing HOUR TO SECOND option to list of possible INTERVAL field sets,

as noted by Sebastien Flaesch.  Also update the claim that we simply throw
away fields outside this set --- that got changed later to only discard
less-significant fields.
This commit is contained in:
Tom Lane 2009-07-08 17:21:55 +00:00
parent df20667112
commit 53e7229258

View file

@ -1,4 +1,4 @@
<!-- $PostgreSQL: pgsql/doc/src/sgml/datatype.sgml,v 1.239 2009/06/17 21:58:49 tgl Exp $ --> <!-- $PostgreSQL: pgsql/doc/src/sgml/datatype.sgml,v 1.240 2009/07/08 17:21:55 tgl Exp $ -->
<chapter id="datatype"> <chapter id="datatype">
<title id="datatype-title">Data Types</title> <title id="datatype-title">Data Types</title>
@ -1524,11 +1524,11 @@ SELECT b, char_length(b) FROM test2;
DAY TO MINUTE DAY TO MINUTE
DAY TO SECOND DAY TO SECOND
HOUR TO MINUTE HOUR TO MINUTE
HOUR TO SECOND
MINUTE TO SECOND MINUTE TO SECOND
</programlisting> </programlisting>
Input falling outside the specified set of fields is silently discarded.
Note that if both <replaceable>fields</replaceable> and Note that if both <replaceable>fields</replaceable> and
<replaceable>precision</replaceable> are specified, the <replaceable>p</replaceable> are specified, the
<replaceable>fields</replaceable> must include <literal>SECOND</>, <replaceable>fields</replaceable> must include <literal>SECOND</>,
since the precision applies only to the seconds. since the precision applies only to the seconds.
</para> </para>
@ -2468,11 +2468,15 @@ P <optional> <replaceable>years</>-<replaceable>months</>-<replaceable>days</> <
<para> <para>
When writing an interval constant with a <replaceable>fields</> When writing an interval constant with a <replaceable>fields</>
specification, or when assigning to an interval column that was defined specification, or when assigning a string to an interval column that was
with a <replaceable>fields</> specification, the interpretation of defined with a <replaceable>fields</> specification, the interpretation of
unmarked quantities depends on the <replaceable>fields</>. For unmarked quantities depends on the <replaceable>fields</>. For
example <literal>INTERVAL '1' YEAR</> is read as 1 year, whereas example <literal>INTERVAL '1' YEAR</> is read as 1 year, whereas
<literal>INTERVAL '1'</> means 1 second. <literal>INTERVAL '1'</> means 1 second. Also, field values
<quote>to the right</> of the least significant field allowed by the
<replaceable>fields</> specification are silently discarded. For
example, writing <literal>INTERVAL '1 day 2:03:04' HOUR TO MINUTE</>
results in dropping the seconds field, but not the day field.
</para> </para>
<para> <para>