Minor: change doc for range (#9455)

* change doc for range

* fix format

* adding examples

* fmt

* more explicit

docs/source/user-guide/sql/scalar_functions.md

@@ -3144,12 +3144,39 @@ trim_array(array, n)
 
 ### `range`
 
-Returns an Arrow array between start and stop with step. `SELECT range(2, 10, 3) -> [2, 5, 8]`
+Returns an Arrow array between start and stop with step. `SELECT range(2, 10, 3) -> [2, 5, 8]` or `SELECT range(DATE '1992-09-01', DATE '1993-03-01', INTERVAL '1' MONTH);`
 
 The range start..end contains all values with start <= x < end. It is empty if start >= end.
 
 Step can not be 0 (then the range will be nonsense.).
 
+Note that when the required range is a number, it accepts (stop), (start, stop), and (start, stop, step) as parameters, but when the required range is a date, it must be 3 non-NULL parameters.
+For example,
+
+```
+SELECT range(3);
+SELECT range(1,5);
+SELECT range(1,5,1);
+```
+
+are allowed in number ranges
+
+but in date ranges, only
+
+```
+SELECT range(DATE '1992-09-01', DATE '1993-03-01', INTERVAL '1' MONTH);
+```
+
+is allowed, and
+
+```
+SELECT range(DATE '1992-09-01', DATE '1993-03-01', NULL);
+SELECT range(NULL, DATE '1993-03-01', INTERVAL '1' MONTH);
+SELECT range(DATE '1992-09-01', NULL, INTERVAL '1' MONTH);
+```
+
+are not allowed
+
 #### Arguments
 
 - **start**: start of the range