From a6ca8a9f9ee00f599879800ae3d5ce259605848d Mon Sep 17 00:00:00 2001
From: kercylan98 <kercylan@gmail.com>
Date: Wed, 28 Jun 2023 10:25:40 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E5=A2=9E=E5=8A=A0=E6=97=B6=E9=97=B4?=
 =?UTF-8?q?=E6=AE=B5=20times.Period=20=E6=95=B0=E6=8D=AE=E7=BB=93=E6=9E=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

时间段 times.Period 数据结构提供了大量用于时间段计算的辅助函数
---
 utils/times/period.go | 110 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 110 insertions(+)
 create mode 100644 utils/times/period.go

diff --git a/utils/times/period.go b/utils/times/period.go
new file mode 100644
index 0000000..5c86e89
--- /dev/null
+++ b/utils/times/period.go
@@ -0,0 +1,110 @@
+package times
+
+import "time"
+
+// NewPeriod 创建一个时间段
+//   - 如果 start 比 end 晚，则会自动交换两个时间
+func NewPeriod(start, end time.Time) Period {
+	if start.After(end) {
+		start, end = end, start
+	}
+	return Period{start, end}
+}
+
+// NewPeriodWithTimeArray 创建一个时间段
+func NewPeriodWithTimeArray(times [2]time.Time) Period {
+	return NewPeriod(times[0], times[1])
+}
+
+// Period 表示一个时间段
+type Period [2]time.Time
+
+// Start 返回时间段的开始时间
+func (slf Period) Start() time.Time {
+	return slf[0]
+}
+
+// End 返回时间段的结束时间
+func (slf Period) End() time.Time {
+	return slf[1]
+}
+
+// Duration 返回时间段的持续时间
+func (slf Period) Duration() time.Duration {
+	return slf[1].Sub(slf[0])
+}
+
+// Day 返回时间段的持续天数
+func (slf Period) Day() int {
+	return int(slf.Duration().Hours() / 24)
+}
+
+// Hour 返回时间段的持续小时数
+func (slf Period) Hour() int {
+	return int(slf.Duration().Hours())
+}
+
+// Minute 返回时间段的持续分钟数
+func (slf Period) Minute() int {
+	return int(slf.Duration().Minutes())
+}
+
+// Seconds 返回时间段的持续秒数
+func (slf Period) Seconds() int {
+	return int(slf.Duration().Seconds())
+}
+
+// Milliseconds 返回时间段的持续毫秒数
+func (slf Period) Milliseconds() int {
+	return int(slf.Duration().Milliseconds())
+}
+
+// Microseconds 返回时间段的持续微秒数
+func (slf Period) Microseconds() int {
+	return int(slf.Duration().Microseconds())
+}
+
+// Nanoseconds 返回时间段的持续纳秒数
+func (slf Period) Nanoseconds() int {
+	return int(slf.Duration().Nanoseconds())
+}
+
+// IsZero 判断时间段是否为零值
+func (slf Period) IsZero() bool {
+	return slf[0].IsZero() && slf[1].IsZero()
+}
+
+// IsInvalid 判断时间段是否无效
+func (slf Period) IsInvalid() bool {
+	return slf[0].IsZero() || slf[1].IsZero()
+}
+
+// IsBefore 判断时间段是否在指定时间之前
+func (slf Period) IsBefore(t time.Time) bool {
+	return slf[1].Before(t)
+}
+
+// IsAfter 判断时间段是否在指定时间之后
+func (slf Period) IsAfter(t time.Time) bool {
+	return slf[0].After(t)
+}
+
+// IsBetween 判断指定时间是否在时间段之间
+func (slf Period) IsBetween(t time.Time) bool {
+	return slf[0].Before(t) && slf[1].After(t)
+}
+
+// IsBetweenOrEqual 判断指定时间是否在时间段之间或者等于时间段的开始或结束时间
+func (slf Period) IsBetweenOrEqual(t time.Time) bool {
+	return slf.IsBetween(t) || slf[0].Equal(t) || slf[1].Equal(t)
+}
+
+// IsBetweenOrEqualPeriod 判断指定时间是否在时间段之间或者等于时间段的开始或结束时间
+func (slf Period) IsBetweenOrEqualPeriod(t Period) bool {
+	return slf.IsBetween(t[0]) || slf.IsBetween(t[1]) || slf[0].Equal(t[0]) || slf[1].Equal(t[1])
+}
+
+// IsOverlap 判断时间段是否与指定时间段重叠
+func (slf Period) IsOverlap(t Period) bool {
+	return slf.IsBetweenOrEqualPeriod(t) || t.IsBetweenOrEqualPeriod(slf)
+}