[dateutils] adding func BeforeOrEqual and AfterOrEqual (#23)

Co-authored-by: Vincent Hoen <vincent.hoen@ext.groupepvcp.com>

dateutils/dateutils.go

@@ -14,3 +14,11 @@ func Ceil(t time.Time) time.Time {
 	// Substract one second and we have today at 23:59:59
 	return Floor(t.Add(time.Hour * 24)).Add(time.Second * -1)
 }
+
+func BeforeOrEqual(milestone time.Time, date time.Time) bool {
+	return date.UTC().Before(milestone) || date.UTC().Equal(milestone)
+}
+
+func AfterOrEqual(milestone time.Time, date time.Time) bool {
+	return date.UTC().After(milestone) || date.UTC().Equal(milestone)
+}

dateutils/dateutils_test.go

@@ -17,3 +17,27 @@ func TestCeil(t *testing.T) {
 	now := time.Now()
 	assert.Equal(t, "23:59:59", dateutils.Ceil(now).Format("15:04:05"))
 }
+
+func TestBeforeOrEqual(t *testing.T) {
+	milestone, _ := time.Parse("2006-01-02", "2023-01-01")
+
+	dBefore, _ := time.Parse("2006-01-02", "2022-12-31")
+	dEqual, _ := time.Parse("2006-01-02", "2023-01-01")
+	dAfter, _ := time.Parse("2006-01-02", "2023-01-31")
+
+	assert.Equal(t, true, dateutils.BeforeOrEqual(milestone, dBefore))
+	assert.Equal(t, true, dateutils.BeforeOrEqual(milestone, dEqual))
+	assert.Equal(t, false, dateutils.BeforeOrEqual(milestone, dAfter))
+}
+
+func TestAfterOrEqual(t *testing.T) {
+	milestone, _ := time.Parse("2006-01-02", "2023-01-01")
+
+	dBefore, _ := time.Parse("2006-01-02", "2022-12-31")
+	dEqual, _ := time.Parse("2006-01-02", "2023-01-01")
+	dAfter, _ := time.Parse("2006-01-02", "2023-01-31")
+
+	assert.Equal(t, false, dateutils.AfterOrEqual(milestone, dBefore))
+	assert.Equal(t, true, dateutils.AfterOrEqual(milestone, dEqual))
+	assert.Equal(t, true, dateutils.AfterOrEqual(milestone, dAfter))
+}

docs/dateutils/afterorequal.md

@@ -0,0 +1,26 @@
+# Ceil
+
+`func AfterOrEqual(milestone time.Time, date time.Time) bool`
+
+AfterOrEqual - returns true if a date is equal or after to another date
+
+```go
+package main
+
+import (
+	"github.com/Goldziher/go-utils/dateutils"
+	"time"
+)
+
+func main() {
+	milestone, _ := time.Parse("2006-01-02", "2023-01-01")
+
+	dBefore, _ := time.Parse("2006-01-02", "2022-12-31")
+	dEqual, _ := time.Parse("2006-01-02", "2023-01-01")
+	dAfter, _ := time.Parse("2006-01-02", "2023-01-31")
+
+	dateutils.AfterOrEqual(milestone, dBefore) // false
+	dateutils.AfterOrEqual(milestone, dEqual) // true
+	dateutils.AfterOrEqual(milestone, dAfter) // true
+}
+```

docs/dateutils/beforeorequal.md

@@ -0,0 +1,26 @@
+# Ceil
+
+`func BeforeOrEqual(milestone time.Time, date time.Time) bool`
+
+BeforeOrEqual - returns true if a date is before or equal to another date
+
+```go
+package main
+
+import (
+	"github.com/Goldziher/go-utils/dateutils"
+	"time"
+)
+
+func main() {
+	milestone, _ := time.Parse("2006-01-02", "2023-01-01")
+
+	dBefore, _ := time.Parse("2006-01-02", "2022-12-31")
+	dEqual, _ := time.Parse("2006-01-02", "2023-01-01")
+	dAfter, _ := time.Parse("2006-01-02", "2023-01-31")
+
+	dateutils.BeforeOrEqual(milestone, dBefore) // true
+	dateutils.BeforeOrEqual(milestone, dEqual) // true
+	dateutils.BeforeOrEqual(milestone, dAfter) // false
+}
+```

mkdocs.yml

@@ -51,6 +51,8 @@ nav:
   - Date Utils:
       - dateutils/floor.md
       - dateutils/ceil.md
+      - dateutils/beforeorequal.md
+      - dateutils/afterorequal.md
   - contributing.md
   - license.md
 theme: