diff --git a/docs/api/packages/datetime.md b/docs/api/packages/datetime.md index e41f818..6085f6c 100644 --- a/docs/api/packages/datetime.md +++ b/docs/api/packages/datetime.md @@ -67,6 +67,9 @@ import ( - [TrackFuncTime](#TrackFuncTime) - [DaysBetween](#DaysBetween) - [GenerateDatetimesBetween](#GenerateDatetimesBetween) +- [Min](#Min) +- [Max](#Max) +- [MaxMin](#MaxMin)
@@ -1570,4 +1573,96 @@ func main() { // [2024-09-01 00:00:00 2024-09-01 01:00:00 2024-09-01 02:00:00] // } +``` + +### Min + +

返回最早时间。

+ +函数签名: + +```go +func Min(t1 time.Time, times ...time.Time) time.Time +``` + +示例:[运行](todo) + +```go +package main + +import ( + "fmt" + "github.com/duke-git/lancet/v2/datetime" +) + +func main() { + minTime := datetime.Min(time.Date(2024, time.September, 1, 0, 0, 0, 0, time.UTC), time.Date(2024, time.September, 2, 0, 0, 0, 0, time.UTC)) + + fmt.Println(minTime) + + // Output: + // 2024-09-01 00:00:00 +0000 UTC +} +``` + +### Max + +

返回最晚时间。

+ +函数签名: + +```go +func Max(t1 time.Time, times ...time.Time) time.Time +``` + +示例:[运行](todo) + +```go +package main + +import ( + "fmt" + "github.com/duke-git/lancet/v2/datetime" +) + +func main() { + maxTime := datetime.Min(time.Date(2024, time.September, 1, 0, 0, 0, 0, time.UTC), time.Date(2024, time.September, 2, 0, 0, 0, 0, time.UTC)) + + fmt.Println(maxTime) + + // Output: + // 2024-09-02 00:00:00 +0000 UTC +} +``` + +### MaxMin + +

返回最早和最晚时间。

+ +函数签名: + +```go +func MaxMin(t1 time.Time, times ...time.Time) (maxTime time.Time, minTime time.Time) +``` + +示例:[运行](todo) + +```go +package main + +import ( + "fmt" + "github.com/duke-git/lancet/v2/datetime" +) + +func main() { + max, min := datetime.MaxMin(time.Date(2024, time.September, 1, 0, 0, 0, 0, time.UTC), time.Date(2024, time.September, 2, 0, 0, 0, 0, time.UTC), time.Date(2024, time.September, 3, 0, 0, 0, 0, time.UTC)) + + fmt.Println(max) + fmt.Println(min) + + // Output: + // 2024-09-03 00:00:00 +0000 UTC + // 2024-09-01 00:00:00 +0000 UTC +} ``` \ No newline at end of file diff --git a/docs/en/api/packages/datetime.md b/docs/en/api/packages/datetime.md index 762cef8..c87a844 100644 --- a/docs/en/api/packages/datetime.md +++ b/docs/en/api/packages/datetime.md @@ -68,6 +68,9 @@ import ( - [TrackFuncTime](#TrackFuncTime) - [DaysBetween](#DaysBetween) - [GenerateDatetimesBetween](#GenerateDatetimesBetween) +- [Min](#Min) +- [Max](#Max) +- [MaxMin](#MaxMin)
@@ -1571,4 +1574,96 @@ func main() { // [2024-09-01 00:00:00 2024-09-01 01:00:00 2024-09-01 02:00:00] // } +``` + +### Min + +

Returns the earliest time among the given times.

+ +Signature: + +```go +func Min(t1 time.Time, times ...time.Time) time.Time +``` + +Example:[Run](todo) + +```go +package main + +import ( + "fmt" + "github.com/duke-git/lancet/v2/datetime" +) + +func main() { + minTime := datetime.Min(time.Date(2024, time.September, 1, 0, 0, 0, 0, time.UTC), time.Date(2024, time.September, 2, 0, 0, 0, 0, time.UTC)) + + fmt.Println(minTime) + + // Output: + // 2024-09-01 00:00:00 +0000 UTC +} +``` + +### Max + +

Returns the latest time among the given times.

+ +Signature: + +```go +func Max(t1 time.Time, times ...time.Time) time.Time +``` + +Example:[Run](todo) + +```go +package main + +import ( + "fmt" + "github.com/duke-git/lancet/v2/datetime" +) + +func main() { + maxTime := datetime.Min(time.Date(2024, time.September, 1, 0, 0, 0, 0, time.UTC), time.Date(2024, time.September, 2, 0, 0, 0, 0, time.UTC)) + + fmt.Println(maxTime) + + // Output: + // 2024-09-02 00:00:00 +0000 UTC +} +``` + +### MaxMin + +

Returns the latest and earliest time among the given times.

+ +Signature: + +```go +func MaxMin(t1 time.Time, times ...time.Time) (maxTime time.Time, minTime time.Time) +``` + +Example:[Run](todo) + +```go +package main + +import ( + "fmt" + "github.com/duke-git/lancet/v2/datetime" +) + +func main() { + max, min := datetime.MaxMin(time.Date(2024, time.September, 1, 0, 0, 0, 0, time.UTC), time.Date(2024, time.September, 2, 0, 0, 0, 0, time.UTC), time.Date(2024, time.September, 3, 0, 0, 0, 0, time.UTC)) + + fmt.Println(max) + fmt.Println(min) + + // Output: + // 2024-09-03 00:00:00 +0000 UTC + // 2024-09-01 00:00:00 +0000 UTC +} ``` \ No newline at end of file