Diff of /incubator/derby/docs/trunk/src/ref/rrefsqlj27620.dita

Parent Directory | Revision Log | Patch

--- incubator/derby/docs/trunk/src/ref/rrefsqlj27620.dita	2005/05/05 03:40:02	168251
+++ incubator/derby/docs/trunk/src/ref/rrefsqlj27620.dita	2005/05/05 03:40:33	168252
@@ -1,4 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
+ "../dtd/reference.dtd">
 <!-- 
 Copyright 1997, 2004 The Apache Software Foundation or its licensors, as applicable.  
 
@@ -14,9 +16,6 @@ WITHOUT WARRANTIES OR CONDITIONS OF ANY
 See the License for the specific language governing permissions and  
 limitations under the License.
 -->
-
-<!DOCTYPE reference PUBLIC "-//IBM//DTD DITA Reference//EN"
- "../dtd/reference.dtd">
 <reference id="rrefsqlj27620" xml:lang="en-us">
 <title>TIMESTAMP</title>
 <prolog><metadata>
@@ -24,19 +23,24 @@ limitations under the License.
 </metadata></prolog>
 <refbody>
 <section> <p>TIMESTAMP stores a combined DATE and TIME value to be stored.
-It permits a fractional-seconds value of up to nine digits. <ph conref="refconrefs.dita#prod/productshortname"></ph> also
-supports the ISO format of 23 characters (17 digits, 3 dashes, and 3 decimal
-points).</p></section>
-<refsyn><title>Syntax</title> <codeblock><b>TIMESTAMP</b></codeblock> </refsyn>
-<section><title>Corresponding compile-time Java type</title> <p><i>java.sql.Timestamp</i></p> </section>
-<section><title>JDBC metadata type (java.sql.Types)</title> <p>TIMESTAMP</p> <p>Dates,
-times, and timestamps cannot be mixed with one another in expressions.</p> <p>Timestamp
-only accepts formats accepted by Timestamp.valueOf. Any value that is recognized
-by the <i>java.sql.Timestamp valueOf(String)</i> method is permitted in a
-column of the corresponding SQL date/time data type.</p> </section>
-<example> <codeblock><b>VALUES '1960-01-01 23:03:20'
+It permits a fractional-seconds value of up to nine digits.</p></section>
+<refsyn><title>Syntax</title><codeblock><b>TIMESTAMP</b></codeblock> </refsyn>
+<section><title>Corresponding compile-time Java type</title><p><i>java.sql.Timestamp</i></p> </section>
+<section><title>JDBC metadata type (java.sql.Types)</title><p>TIMESTAMP</p><p>Dates,
+times, and timestamps cannot be mixed with one another in expressions.</p><p><ph
+conref="refconrefs.dita#prod/productshortname"></ph> supports the following
+formats for TIMESTAMP:<codeblock>yyyy-mm-dd hh[:mm[:ss[.nnnnnn]]]
+yyyy-mm-dd-hh[.mm[.ss[.nnnnnn]]]</codeblock>The first of the two formats above
+is the <i>java.sql.Timestamp</i> format.</p><p>The year must always have four
+digits. Months, days, and hours may have one or two digits. Minutes and seconds,
+if present, must have two digits. Nanoseconds, if present may have between
+one and six digits.</p><p><ph conref="refconrefs.dita#prod/productshortname"></ph> also
+accepts strings in the locale specific datetime format, using the locale of
+the database server. If there is an ambiguity, the built-in formats above
+take precedence.</p> </section>
+<example> <title>Examples</title><codeblock><b>VALUES '1960-01-01 23:03:20'
 VALUES TIMESTAMP('1962-09-23 03:23:34.234')
 VALUES TIMESTAMP('1960-01-01 23:03:20')</b></codeblock> </example>
 </refbody>
 </reference>
-<?Pub *0000001473?>
+<?Pub *0000002458?>