forked from cockroachdb/cockroach
-
Notifications
You must be signed in to change notification settings - Fork 0
/
timestamp.go
104 lines (92 loc) · 2.75 KB
/
timestamp.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
// Copyright 2014 The Cockroach Authors.
//
// 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 hlc
import (
"fmt"
"math"
"time"
"github.com/cockroachdb/cockroach/pkg/util/timeutil"
)
// Timestamp constant values.
var (
// MaxTimestamp is the max value allowed for Timestamp.
MaxTimestamp = Timestamp{WallTime: math.MaxInt64, Logical: math.MaxInt32}
// MinTimestamp is the min value allowed for Timestamp.
MinTimestamp = Timestamp{WallTime: 0, Logical: 1}
)
// Less compares two timestamps.
func (t Timestamp) Less(s Timestamp) bool {
return t.WallTime < s.WallTime || (t.WallTime == s.WallTime && t.Logical < s.Logical)
}
func (t Timestamp) String() string {
return fmt.Sprintf("%d.%09d,%d", t.WallTime/1E9, t.WallTime%1E9, t.Logical)
}
// Add returns a timestamp with the WallTime and Logical components increased.
// wallTime is expressed in nanos.
func (t Timestamp) Add(wallTime int64, logical int32) Timestamp {
return Timestamp{
WallTime: t.WallTime + wallTime,
Logical: t.Logical + logical,
}
}
// Next returns the timestamp with the next later timestamp.
func (t Timestamp) Next() Timestamp {
if t.Logical == math.MaxInt32 {
if t.WallTime == math.MaxInt64 {
panic("cannot take the next value to a max timestamp")
}
return Timestamp{
WallTime: t.WallTime + 1,
}
}
return Timestamp{
WallTime: t.WallTime,
Logical: t.Logical + 1,
}
}
// Prev returns the next earliest timestamp.
func (t Timestamp) Prev() Timestamp {
if t.Logical > 0 {
return Timestamp{
WallTime: t.WallTime,
Logical: t.Logical - 1,
}
} else if t.WallTime > 0 {
return Timestamp{
WallTime: t.WallTime - 1,
Logical: math.MaxInt32,
}
}
panic("cannot take the previous value to a zero timestamp")
}
// Forward updates the timestamp from the one given, if that moves it forwards
// in time. Returns true if the timestamp was adjusted and false otherwise.
func (t *Timestamp) Forward(s Timestamp) bool {
if t.Less(s) {
*t = s
return true
}
return false
}
// Backward updates the timestamp from the one given, if that moves it
// backwards in time.
func (t *Timestamp) Backward(s Timestamp) {
if s.Less(*t) {
*t = s
}
}
// GoTime converts the timestamp to a time.Time.
func (t Timestamp) GoTime() time.Time {
return timeutil.Unix(0, t.WallTime)
}