1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
-
- This file is part of the OpenLink Software Virtuoso Open-Source (VOS)
- project.
-
- Copyright (C) 1998-2018 OpenLink Software
-
- This project is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by the
- Free Software Foundation; only version 2 of the License, dated June 1991.
-
- This program is distributed in the hope that it will be useful, but
- WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
-
- You should have received a copy of the GNU General Public License along
- with this program; if not, write to the Free Software Foundation, Inc.,
- 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
-
-
-->
<refentry id="fn_datestring">
<refmeta>
<refentrytitle>
<function>datestring</function>,
<function>datestring_gmt</function>,
</refentrytitle>
<refmiscinfo>time</refmiscinfo>
</refmeta>
<refnamediv>
<refname><function>datestring</function></refname>
<refname><function>datestring_gmt</function></refname>
<refpurpose>convert a datetime from internal to external
date-time representation</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis id="fsyn_datestring">
<funcprototype id="fproto_datestring">
<funcdef><function>datestring</function></funcdef>
<paramdef>in <parameter>date</parameter> datetime</paramdef>
</funcprototype>
</funcsynopsis>
<funcsynopsis id="fsyn_datestring_gmt">
<funcprototype id="fproto_datestring_gmt">
<funcdef><function>datestring_gmt</function></funcdef>
<paramdef>in <parameter>date</parameter> datetime</paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="desc_datestring"><title>Description</title>
<para><function>datestring</function> and datestring_gmt convert
<type>timestamps</type> or <type>datetimes</type>
from internal to external date-time representation.
The external representation is a human-readable ASCII string of
up to 30 characters. </para>
<para>The external format is:
<computeroutput>YYYY-MM-DD hh:mm:ss uuuuuu</computeroutput>
where <computeroutput>uuuuuu</computeroutput> represents
microseconds.</para>
<note><title>Note:</title>
<para>Using <computeroutput>cast (dt as varchar)</computeroutput>
is preferred over <function>datestring</function>.</para></note>
</refsect1>
<refsect1 id="params_datestring"><title>Parameters</title>
<refsect2><title>date</title>
<para>A <type>datetime</type> value.</para>
</refsect2>
</refsect1>
<refsect1 id="ret_datestring"><title>Return values</title>
<para><function>datestring</function> and <function>datestring_GMT</function>
return a <type>varchar</type>.</para>
</refsect1>
<!-- <refsect1 id="errors_datestring"><title>Errors</title>
<table><title>Errors signalled by <function>datestring</function> and
<function>stringdate</function></title>
<tgroup cols="4">
<tbody>
<row>
<entry>SQLState</entry>
<entry>Error Code</entry>
<entry>Error Text</entry>
<entry>Description</entry>
</row>
<row>
<entry><errorcode>22007</errorcode></entry>
<entry><errorcode>DT001</errorcode></entry>
<entry><errorname>Function %s needs a datetime, date or time as argument
%d, not an arg of type %s (%d)</errorname></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>
</refsect1> -->
<refsect1 id="examples_datestring"><title>Examples</title>
<example id="ex_datestring_1"><title>Simple Example</title>
<para>Get current date in human-readable form.</para>
<screen>
SQL> select datestring(now());
callret
VARCHAR
_______________________________________________________________________________
2001-03-01 12:49:59.000000
1 Rows. -- 585 msec.
</screen>
</example>
<example id="ex_datestring_2">
<title>A table query example</title>
<para>Get orders shipped later than July 3, 1996</para>
<screen>
SQL> select left (datestring(ShippedDate), 10) from Orders
where ShippedDate > stringdate ('1996.6.3');
callret
VARCHAR
_______________________________________________________________________________
1996-06-04
1996-06-04
1996-06-05
1996-06-05
1996-06-05
5 Rows. -- 3 msec.
</screen>
</example>
</refsect1>
<refsect1 id="seealso_datestring"><title>See Also</title>
<para><link linkend="fn_datestring_gmt"><function>datestring_gmt</function></link>,
<link linkend="fn_stringdate"><function>stringdate</function></link></para>
<para> The discussion of
<link linkend="DTTIMESTAMP"><type>TIMESTAMP</type></link>
datatype in section <link linkend="coredbengine">Database Concepts</link>
of the documentation.</para>
</refsect1>
</refentry>
|
