feat: add WhereBetween method

contracts/database/orm/orm.go

@@ -133,6 +133,8 @@ type Query interface {
 	WhereIn(column string, values []any) Query
 	// WhereNotIn adds a "where column not in" clause to the query.
 	WhereNotIn(column string, values []any) Query
+	// WhereBetween adds a "where column between x and y" clause to the query.
+	WhereBetween(column string, x, y any) Query
 	// WithoutEvents disables event firing for the query.
 	WithoutEvents() Query
 	// WithTrashed allows soft deleted models to be included in the results.

database/gorm/query.go

@@ -684,6 +684,10 @@ func (r *QueryImpl) OrWhereNotIn(column string, values []any) ormcontract.Query
 	return r.OrWhere(fmt.Sprintf("%s NOT IN ?", column), values)
 }
 
+func (r *QueryImpl) WhereBetween(column string, x, y any) ormcontract.Query {
+	return r.Where(fmt.Sprintf("%s BETWEEN %v AND %v", column, x, y))
+}
+
 func (r *QueryImpl) WithoutEvents() ormcontract.Query {
 	return NewQueryImplByInstance(r.instance, &QueryImpl{
 		config:        r.config,

database/gorm/query_test.go

@@ -2813,6 +2813,28 @@ func (s *QueryTestSuite) TestOrWhereNotIn() {
 	}
 }
 
+func (s *QueryTestSuite) TestWhereBetween() {
+	for driver, query := range s.queries {
+		s.Run(driver.String(), func() {
+			user := User{Name: "where_between_user", Avatar: "where_between_avatar"}
+			s.Nil(query.Create(&user))
+			s.True(user.ID > 0)
+
+			user1 := User{Name: "where_between_user_1", Avatar: "where_between_avatar_1"}
+			s.Nil(query.Create(&user1))
+			s.True(user1.ID > 0)
+
+			user2 := User{Name: "where_between_user_2", Avatar: "where_between_avatar_2"}
+			s.Nil(query.Create(&user2))
+			s.True(user2.ID > 0)
+
+			var users []User
+			s.Nil(query.WhereBetween("id", user.ID, user2.ID).Find(&users))
+			s.True(len(users) == 3)
+		})
+	}
+}
+
 func (s *QueryTestSuite) TestWithoutEvents() {
 	for _, query := range s.queries {
 		tests := []struct {