-
Notifications
You must be signed in to change notification settings - Fork 0
/
datetimetype.go
executable file
·332 lines (292 loc) · 8.76 KB
/
datetimetype.go
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
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
// Copyright 2020-2021 Dolthub, Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package sql
import (
"math"
"time"
"github.com/dolthub/vitess/go/sqltypes"
"github.com/dolthub/vitess/go/vt/proto/query"
"gopkg.in/src-d/go-errors.v1"
)
const (
// DateLayout is the layout of the MySQL date format in the representation
// Go understands.
DateLayout = "2006-01-02"
// TimestampDatetimeLayout is the formatting string with the layout of the timestamp
// using the format of Go "time" package.
TimestampDatetimeLayout = "2006-01-02 15:04:05.999999"
zeroDateStr = "0000-00-00"
zeroTimestampDatetimeStr = "0000-00-00 00:00:00"
)
var (
// ErrConvertingToTime is thrown when a value cannot be converted to a Time
ErrConvertingToTime = errors.NewKind("value %q can't be converted to time.Time")
ErrConvertingToTimeOutOfRange = errors.NewKind("value %q is outside of %v range")
// datetimeTypeMaxDatetime is the maximum representable Datetime/Date value.
datetimeTypeMaxDatetime = time.Date(9999, 12, 31, 23, 59, 59, 999999000, time.UTC)
// datetimeTypeMinDatetime is the minimum representable Datetime/Date value.
datetimeTypeMinDatetime = time.Date(1000, 1, 1, 0, 0, 0, 0, time.UTC)
// datetimeTypeMaxTimestamp is the maximum representable Timestamp value, which is the maximum 32-bit integer as a Unix time.
datetimeTypeMaxTimestamp = time.Unix(math.MaxInt32, 999999000)
// datetimeTypeMinTimestamp is the minimum representable Timestamp value, which is one second past the epoch.
datetimeTypeMinTimestamp = time.Unix(1, 0)
// TimestampDatetimeLayouts hold extra timestamps allowed for parsing. It does
// not have all the layouts supported by mysql. Missing are two digit year
// versions of common cases and dates that use non common separators.
//
// https://github.com/MariaDB/server/blob/mysql-5.5.36/sql-common/my_time.c#L124
TimestampDatetimeLayouts = []string{
"2006-01-02 15:04:05.999999",
"2006-01-02",
"2006-1-2",
"2006-1-2 15:4:5.999999",
time.RFC3339,
time.RFC3339Nano,
"2006-01-02T15:04:05",
"20060102150405",
"20060102",
"2006/01/02",
"2006-01-02 15:04:05.999999999 -0700 MST", // represents standard Time.time.UTC()
}
// zeroTime is 0000-01-01 00:00:00 UTC which is the closest Go can get to 0000-00-00 00:00:00
zeroTime = time.Unix(-62167219200, 0).UTC()
// Date is a date with day, month and year.
Date = MustCreateDatetimeType(sqltypes.Date)
// Datetime is a date and a time
Datetime = MustCreateDatetimeType(sqltypes.Datetime)
// Timestamp is an UNIX timestamp.
Timestamp = MustCreateDatetimeType(sqltypes.Timestamp)
)
// Represents DATE, DATETIME, and TIMESTAMP.
// https://dev.mysql.com/doc/refman/8.0/en/datetime.html
type DatetimeType interface {
Type
ConvertWithoutRangeCheck(v interface{}) (time.Time, error)
MaximumTime() time.Time
MinimumTime() time.Time
}
type datetimeType struct {
baseType query.Type
}
// CreateDatetimeType creates a Type dealing with all temporal types that are not TIME nor YEAR.
func CreateDatetimeType(baseType query.Type) (DatetimeType, error) {
switch baseType {
case sqltypes.Date, sqltypes.Datetime, sqltypes.Timestamp:
return datetimeType{
baseType: baseType,
}, nil
}
return nil, ErrInvalidBaseType.New(baseType.String(), "datetime")
}
// MustCreateDatetimeType is the same as CreateDatetimeType except it panics on errors.
func MustCreateDatetimeType(baseType query.Type) DatetimeType {
dt, err := CreateDatetimeType(baseType)
if err != nil {
panic(err)
}
return dt
}
// Compare implements Type interface.
func (t datetimeType) Compare(a interface{}, b interface{}) (int, error) {
if hasNulls, res := compareNulls(a, b); hasNulls {
return res, nil
}
var at time.Time
var bt time.Time
var ok bool
if at, ok = a.(time.Time); !ok {
ai, err := t.Convert(a)
if err != nil {
return 0, err
}
at = ai.(time.Time)
} else if t.baseType == sqltypes.Date {
at = at.Truncate(24 * time.Hour)
}
if bt, ok = b.(time.Time); !ok {
bi, err := t.Convert(b)
if err != nil {
return 0, err
}
bt = bi.(time.Time)
} else if t.baseType == sqltypes.Date {
bt = bt.Truncate(24 * time.Hour)
}
if at.Before(bt) {
return -1, nil
} else if at.After(bt) {
return 1, nil
}
return 0, nil
}
// Convert implements Type interface.
func (t datetimeType) Convert(v interface{}) (interface{}, error) {
if v == nil {
return nil, nil
}
res, err := t.ConvertWithoutRangeCheck(v)
if err != nil {
return nil, err
}
if res.Equal(zeroTime) {
return zeroTime, nil
}
switch t.baseType {
case sqltypes.Date:
if res.Year() < 1000 || res.Year() > 9999 {
return nil, ErrConvertingToTimeOutOfRange.New(res.Format(DateLayout), t.String())
}
case sqltypes.Datetime:
if res.Year() < 1000 || res.Year() > 9999 {
return nil, ErrConvertingToTimeOutOfRange.New(res.Format(TimestampDatetimeLayout), t.String())
}
case sqltypes.Timestamp:
if res.Before(datetimeTypeMinTimestamp) || res.After(datetimeTypeMaxTimestamp) {
return nil, ErrConvertingToTimeOutOfRange.New(res.Format(TimestampDatetimeLayout), t.String())
}
}
return res, nil
}
// ConvertWithoutRangeCheck converts the parameter to time.Time without checking the range.
func (t datetimeType) ConvertWithoutRangeCheck(v interface{}) (time.Time, error) {
var res time.Time
switch value := v.(type) {
case string:
if value == zeroDateStr || value == zeroTimestampDatetimeStr {
return zeroTime, nil
}
parsed := false
for _, fmt := range TimestampDatetimeLayouts {
if t, err := time.Parse(fmt, value); err == nil {
res = t.UTC()
parsed = true
break
}
}
if !parsed {
return zeroTime, ErrConvertingToTime.New(v)
}
case time.Time:
res = value.UTC()
default:
return zeroTime, ErrConvertToSQL.New(t)
}
if t.baseType == sqltypes.Date {
res = res.Truncate(24 * time.Hour)
}
return res, nil
}
func (t datetimeType) MustConvert(v interface{}) interface{} {
value, err := t.Convert(v)
if err != nil {
panic(err)
}
return value
}
// Promote implements the Type interface.
func (t datetimeType) Promote() Type {
if t.baseType == sqltypes.Timestamp {
return Datetime
}
return t
}
// SQL implements Type interface.
func (t datetimeType) SQL(v interface{}) (sqltypes.Value, error) {
if v == nil {
return sqltypes.NULL, nil
}
v, err := t.Convert(v)
if err != nil {
return sqltypes.Value{}, err
}
vt := v.(time.Time)
switch t.baseType {
case sqltypes.Date:
if vt.Equal(zeroTime) {
return sqltypes.MakeTrusted(
sqltypes.Date,
[]byte(vt.Format(zeroDateStr)),
), nil
}
return sqltypes.MakeTrusted(
sqltypes.Date,
[]byte(vt.Format(DateLayout)),
), nil
case sqltypes.Datetime:
if vt.Equal(zeroTime) {
return sqltypes.MakeTrusted(
sqltypes.Datetime,
[]byte(vt.Format(zeroTimestampDatetimeStr)),
), nil
}
return sqltypes.MakeTrusted(
sqltypes.Datetime,
[]byte(vt.Format(TimestampDatetimeLayout)),
), nil
case sqltypes.Timestamp:
if vt.Equal(zeroTime) {
return sqltypes.MakeTrusted(
sqltypes.Timestamp,
[]byte(vt.Format(zeroTimestampDatetimeStr)),
), nil
}
return sqltypes.MakeTrusted(
sqltypes.Timestamp,
[]byte(vt.Format(TimestampDatetimeLayout)),
), nil
default:
panic(ErrInvalidBaseType.New(t.baseType.String(), "datetime"))
}
}
func (t datetimeType) String() string {
switch t.baseType {
case sqltypes.Date:
return "DATE"
case sqltypes.Datetime:
return "DATETIME"
case sqltypes.Timestamp:
return "TIMESTAMP"
default:
panic(ErrInvalidBaseType.New(t.baseType.String(), "datetime"))
}
}
// Type implements Type interface.
func (t datetimeType) Type() query.Type {
return t.baseType
}
func (t datetimeType) Zero() interface{} {
return zeroTime
}
// MaximumTime is the latest accepted time for this type.
func (t datetimeType) MaximumTime() time.Time {
if t.baseType == sqltypes.Timestamp {
return datetimeTypeMaxTimestamp
}
return datetimeTypeMaxDatetime
}
// MinimumTime is the earliest accepted time for this type.
func (t datetimeType) MinimumTime() time.Time {
if t.baseType == sqltypes.Timestamp {
return datetimeTypeMinTimestamp
}
return datetimeTypeMinDatetime
}
// ValidateTime receives a time and returns either that time or nil if it's
// not a valid time.
func ValidateTime(t time.Time) interface{} {
if t.After(time.Date(9999, time.December, 31, 23, 59, 59, 999999999, time.UTC)) {
return nil
}
return t
}