From: Thomas G. Lockhart Date: Fri, 21 Dec 2001 03:54:02 +0000 (+0000) Subject: Spiff up discussion of precision on date/time data types. X-Git-Tag: REL7_2_BETA5~197 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=9640666c6f9501aa8efcc1e7161833455f35f8c2;p=postgresql Spiff up discussion of precision on date/time data types. Add a NetBSD/alpha and update info on a few other platforms. --- diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml index badfea023f..26eeb60c27 100644 --- a/doc/src/sgml/datatype.sgml +++ b/doc/src/sgml/datatype.sgml @@ -1,5 +1,5 @@ @@ -1328,21 +1328,20 @@ SELECT b, char_length(b) FROM test2; time and timestamp both accept an - option precision field p which + optional precision field p which determines the number of digits retained beyond the seconds decimal point. By default, there is no explicit bound on precision and the actual precision is determined by the underlying double precision floating point number used to store values in seconds for interval and - since 2000-01-01 in the case of timestamp. + in seconds since 2000-01-01 for timestamp. Time zones, and time-zone conventions, are influenced by - political decisions, not just physical effects. Time zones have - become somewhat standardized around the world during the 1900's, - but continue to - be prone to arbitrary changes. + political decisions, not just geometry. Time zones around the + world became somewhat standardized during the 1900's, + but continue to be prone to arbitrary changes. PostgreSQL uses your operating system's underlying features to provide time-zone support, and these systems usually contain information for only @@ -1354,13 +1353,15 @@ SELECT b, char_length(b) FROM test2; - To ensure compatibility to earlier versions of PostgreSQL + To ensure compatibility to earlier versions of + PostgreSQL we continue to provide datetime (equivalent to timestamp) and timespan (equivalent to interval), however support for these is now restricted to having an implicit translation to timestamp and - interval. + interval, and these name mappings will be removed in + the next version. The types abstime and reltime are lower precision types which are used internally. You are discouraged from using any of these types in new @@ -1376,9 +1377,12 @@ SELECT b, char_length(b) FROM test2; Date and time input is accepted in almost any reasonable format, including ISO 8601, SQL-compatible, traditional PostgreSQL, and others. - The ordering of month and day in date input can be ambiguous, therefore a setting - exists to specify how it should be interpreted in ambiguous cases. The command - SET DateStyle TO 'US' or SET DateStyle TO 'NonEuropean' + For some formats, ordering of month and day in date input can be + ambiguous and there is support for specifying the expected + ordering of these fields. + The command + SET DateStyle TO 'US' + or SET DateStyle TO 'NonEuropean' specifies the variant month before day, the command SET DateStyle TO 'European' sets the variant day before month. The ISO style @@ -1386,24 +1390,29 @@ SELECT b, char_length(b) FROM test2; + PostgreSQL is more flexible in + handling date/time than the + SQL standard requires. See - for the exact parsing rules of date/time input and for the recognized time zones. + for the exact parsing rules of date/time input and for the + recognized time zones. - Remember that any date or time input needs to be enclosed into - single quotes, like text strings. Refer to for more information. + Remember that any date or time literal input needs to be enclosed + in single quotes, like text strings. Refer to + for more + information. SQL9x requires the following syntax type [ (p) ] 'value' - where p is an integer specifying the - number of fractional digits in the seconds field, and is allowed - for time, timestamp, and interval types. - PostgreSQL is more flexible in - handling date/time than the - SQL standard requires. + where p in the optional precision + specification is an integer corresponding to the + number of fractional digits in the seconds field. Precision can + be specified + for time, timestamp, and + interval types. diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml index 74d5e4ba29..9466d394b6 100644 --- a/doc/src/sgml/installation.sgml +++ b/doc/src/sgml/installation.sgml @@ -1,4 +1,4 @@ - + <![%standalone-include[<productname>PostgreSQL</>]]> @@ -1372,9 +1372,10 @@ gunzip -c user.ps.gz \ <entry><systemitem class="osname">AIX</></entry> <entry><systemitem>RS6000</></entry> <entry>7.2</entry> - <entry>2001-11-28, - Andreas Zeugswetter (<email>ZeugswetterA@spardat.at</email>)</entry> - <entry>4.3; see also <filename>doc/FAQ_AIX</filename></entry> + <entry>2001-12-19, + Andreas Zeugswetter (<email>ZeugswetterA@spardat.at</email>), + Tatsuo Ishii (<email>t-ishii@sra.co.jp</email>)</entry> + <entry>see also <filename>doc/FAQ_AIX</filename></entry> </row> <row> <entry><systemitem class="osname">BeOS</></entry> @@ -1392,6 +1393,14 @@ gunzip -c user.ps.gz \ Bruce Momjian (<email>pgman@candle.pha.pa.us</email>)</entry> <entry>4.2</entry> </row> + <row> + <entry><systemitem class="osname">FreeBSD</></entry> + <entry><systemitem>Alpha</></entry> + <entry>7.2</entry> + <entry>2001-12-18, + Chris Kings-Lynne (<email>chriskl@familyhealth.com.au</email>)</entry> + <entry></entry> + </row> <row> <entry><systemitem class="osname">FreeBSD</></entry> <entry><systemitem>x86</></entry> @@ -1428,9 +1437,9 @@ gunzip -c user.ps.gz \ <row> <entry><systemitem class="osname">Linux</></entry> <entry><systemitem>armv4l</></entry> - <entry>7.1</entry> - <entry>2001-02-22, - Mark Knox (<email>markk@pixin.net</email>)</entry> + <entry>7.2</entry> + <entry>2001-12-10, + Mark Knox (<email>segfault@hardline.org</email>)</entry> <entry>2.2.x</entry> </row> <row> @@ -1441,6 +1450,14 @@ gunzip -c user.ps.gz \ Hisao Shibuya (<email>shibuya@alpha.or.jp</>)</entry> <entry>2.0.x; <productname>Cobalt Qube2</></entry> </row> + <row> + <entry><systemitem class="osname">Linux</></entry> + <entry><systemitem>PlayStation2</></entry> + <entry>7.2</entry> + <entry>2001-12-12, + Permaine Cheung <email>pcheung@redhat.com</email>)</entry> + <entry>#undef HAS_TEST_AND_SET, slock_t</entry> + </row> <row> <entry><systemitem class="osname">Linux</></entry> <entry><systemitem>PPC74xx</></entry> @@ -1452,9 +1469,9 @@ gunzip -c user.ps.gz \ <row> <entry><systemitem class="osname">Linux</></entry> <entry><systemitem>S/390</></entry> - <entry>7.1</entry> - <entry>2000-11-17, - Neale Ferguson (<email>Neale.Ferguson@softwareAG-usa.com</email>)</entry> + <entry>7.2</entry> + <entry>2001-12-12, + Permaine Cheung <email>pcheung@redhat.com</email>)</entry> <entry></entry> </row> <row> @@ -1565,11 +1582,20 @@ gunzip -c user.ps.gz \ <row> <entry><systemitem class="osname">QNX 4.25</></entry> <entry><systemitem>x86</></entry> - <entry>7.1</entry> - <entry>2001-05-24, + <entry>7.2</entry> + <entry>2001-12-10, Bernd Tegge (<email>tegge@repas-aeg.de</email>) </entry> <entry>see also <filename>doc/FAQ_QNX4</filename></entry> + </row> + <row> + <entry><systemitem class="osname">QNX 6</></entry> + <entry><systemitem>x86</></entry> + <entry>7.2</entry> + <entry>2001-12-10, + Igor Kovalenko (<email>Igor.Kovalenko@motorola.com</email>) + </entry> + <entry>Requires patches for Posix semaphores; see archives</entry> </row> <row> <entry><systemitem class="osname">Solaris</></entry> @@ -1587,22 +1613,43 @@ gunzip -c user.ps.gz \ Martin Renters (<email>martin@datafax.com</email>)</entry> <entry>2.8; see also <filename>doc/FAQ_Solaris</filename></entry> </row> + <row> + <entry><systemitem class="osname">SunOS</></entry> + <entry><systemitem>Sparc</></entry> + <entry>7.2</entry> + <entry>2001-12-04, Tatsuo Ishii (<email>t-ishii@sra.co.jp</email>)</entry> + <entry></entry> + </row> <row> <entry><systemitem class="osname">Tru64 UNIX</></entry> <entry><systemitem>Alpha</></entry> <entry>7.2</entry> <entry>2001-11-26, - Alessio Bragadini (<email>alessio@albourne.com</email>)</entry> - <entry>4.0g, with cc and gcc</entry> + Alessio Bragadini (<email>alessio@albourne.com</email>), + Bernd Tegge (<email>tegge@repas-aeg.de</email>)</entry> + <entry>5.0; 4.0g with cc and gcc</entry> </row> <row> - <entry><systemitem class="osname">Windows NT/2000</></entry> + <entry><systemitem class="osname">Windows</></entry> <entry><systemitem>x86</></entry> - <entry>7.1</entry> - <entry>2001-03-16, + <entry>7.2</entry> + <entry>2001-12-13, + Dave Page (<email>dpage@vale-housing.co.uk</email>), Jason Tishler (<email>jason@tishler.net</email>)</entry> - <entry>with <application>Cygwin</application> tool set, see <filename>doc/FAQ_MSWIN</filename></entry> + <entry>with <application>Cygwin</application>; see <filename>doc/FAQ_MSWIN</filename></entry> </row> + <row> + <entry><systemitem class="osname">Windows</></entry> + <entry><systemitem>x86</></entry> + <entry>7.2</entry> + <entry>2001-12-10, + Dave Page (<email>dpage@vale-housing.co.uk</email>)</entry> + <entry> + native is client-side only; +<![%standalone-include[see Administrator's Guide]]> +<![%standalone-ignore[see <xref linkend="install-win32">]]> + </entry> + </row> </tbody> </tgroup> </informaltable> @@ -1668,14 +1715,7 @@ Obsolete platform? This distro was merged into PPC afaik. - thomas 2001-12-07 <entry><systemitem>x86</></entry> <entry>6.5</entry> <entry>1999-05-25, Andrew Merrill (<email>andrew@compclass.com</>)</entry> - <entry>7.2 should work, but no reports; see also <filename>doc/FAQ_SCO</filename></entry> - </row> - <row> - <entry><systemitem class="osname">SunOS</></entry> - <entry><systemitem>Sparc</></entry> - <entry>7.2</entry> - <entry>2001-12-04, Tatsuo Ishii (<email>t-ishii@sra.co.jp</email>)</entry> - <entry><function>memcmp()</> does not work correctly, so probably not reliable</entry> + <entry>&version; should work, but no reports; see also <filename>doc/FAQ_SCO</filename></entry> </row> <row> <entry><systemitem class="osname">System V R4</></entry> @@ -1703,24 +1743,11 @@ Obsolete platform? This distro was merged into PPC afaik. - thomas 2001-12-07 <entry><systemitem>VAX</></entry> <entry>6.x</entry> <entry>1998-03-01</entry> - <entry>no recent reports</entry> - </row> - <row> - <entry><systemitem class="osname">Windows 9x, ME, NT, 2000</> (native)</entry> - <entry><systemitem>x86</></entry> - <entry>7.1</entry> - <entry>2001-03-26, Magnus Hagander (<email>mha@sollentuna.net</email>)</entry> - <entry> - client-side libraries (<application>libpq</> and <application>psql</>) or ODBC or JDBC, no server-side; -<![%standalone-include[see <citetitle>Administrator's Guide</>]]> -<![%standalone-ignore[see <xref linkend="install-win32">]]> - for instructions - </entry> + <entry></entry> </row> </tbody> </tgroup> </informaltable> - </sect1> </chapter>