← Back to branch summary

~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/functions/extract_date_functions.rst

  • Committer: Lee Bieber
  • Date: 2011-02-24 03:20:47 UTC
  • mfrom: (2196.1.4 build)
  • Revision ID: kalebral@gmail.com-20110224032047-avmw06iwww3m73cw
Merge Andrew - 723653: Docs day first pass fixes 
Merge Brian - Puts back in support for COM_KILL, Also adds back in the INTERACTIVE flag, and creates a DD to track sessions/check on usage
Merge Olaf - Use List::size()

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/functions/extract_date_functions.rst
1
1
EXTRACT DATE FUNCTION
2
2
======================
3
3
 
4
 
**Syntax** ::
 
4
Syntax
 
5
------
 
6
 
 
7
.. code-block:: mysql
5
8
 
6
9
        EXTRACT(field FROM source)
7
10
 
9
12
 
10
13
*Field* is an identifier or string that identifies the field to extract from the source value. The extract function returns values of type *double precision*. 
11
14
 
12
 
**Examples:**
 
15
Examples
 
16
--------
13
17
 
14
18
The following field names are available:
15
19
 
16
 
**day**
 
20
day
 
21
^^^
17
22
 
18
23
.. code-block:: mysql
19
24
        
23
28
 
24
29
*Result: 16*
25
30
 
26
 
**decade**
 
31
decade
 
32
^^^^^^
27
33
 
28
34
.. code-block:: mysql
29
35
        
33
39
 
34
40
*Result: 200*
35
41
 
36
 
**dow**
 
42
dow
 
43
^^^
37
44
 
38
45
.. code-block:: mysql
39
46
        
43
50
 
44
51
*Result: 5*
45
52
 
46
 
**doy**
 
53
doy
 
54
^^^
47
55
 
48
56
.. code-block:: mysql
49
57
 
53
61
 
54
62
*Result: 47*
55
63
 
56
 
**hour**
 
64
hour
 
65
^^^^
57
66
 
58
67
.. code-block:: mysql
59
68
 
63
72
 
64
73
*Result: 20*
65
74
 
66
 
**microseconds**
 
75
microseconds
 
76
^^^^^^^^^^^^
67
77
 
68
78
.. code-block:: mysql
69
79
 
73
83
 
74
84
*Result: 28500000*
75
85
 
76
 
**minute**
 
86
minute
 
87
^^^^^^
77
88
 
78
89
.. code-block:: mysql
79
90
 
83
94
 
84
95
*Result: 38*
85
96
 
86
 
**month**
 
97
month
 
98
^^^^^
87
99
 
88
100
For timestamp values, the number of the month within the year (1 - 12). 
89
101
For interval values, the number of months (0 - 11).
106
118
 
107
119
*Result: 1*
108
120
 
109
 
**quarter**
 
121
quarter
 
122
^^^^^^^
110
123
 
111
124
.. code-block:: mysql
112
125
 
116
129
        
117
130
*Result: 4*
118
131
 
119
 
**second**
 
132
second
 
133
^^^^^^
120
134
 
121
135
.. code-block:: mysql
122
136
 
132
146
 
133
147
*Result: 22.5*
134
148
 
135
 
**timezone**
 
149
timezone
 
150
^^^^^^^^
136
151
 
137
152
The time zone offset from UTC, measured in seconds.
138
153
 
139
 
**week**
 
154
week
 
155
^^^^
140
156
 
141
157
Returns the week number that a day is in. Weeks are numbered according to ISO 8601:1988.
142
158
 
150
166
 
151
167
*Result: 4*
152
168
 
153
 
**year**
 
169
year
 
170
^^^^
154
171
 
155
172
.. code-block:: mysql
156
173
 
158
175
 
159
176
*Result: 2009*
160
177
 
 
178
date_part
 
179
^^^^^^^^^
 
180
 
161
181
The valid field names for date_part are the same as for extract.
162
182
 
163
183
.. code-block:: mysql