Skip to content

Commit cac01f8

Browse files
dwdwqfwedwdwqfwe
committed
fix_only_dev_hour
1 parent 46356c0 commit cac01f8

36 files changed

+2075
-562
lines changed

‎docs/sql-manual/sql-functions/scalar-functions/date-time-functions/hour-ceil.md‎

Lines changed: 98 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,45 +1,124 @@
11
---
22
{
3-
"title": "HOUR_CEIL",
4-
"language": "en"
3+
"title": "HOUR_CEIL",
4+
"language": "en"
55
}
66
---
77

88
## Description
99

10-
Converts the date to the nearest rounded-up timestamp of the specified time interval period.
10+
The HOUR_CEIL function rounds up the input datetime value to the nearest moment of the specified hour period. For example, if the period is specified as 5 hours, the function will adjust the input time to the next hour mark within that period (if the input time is already at the period origin, it remains unchanged).
11+
12+
Date calculation formula:
13+
HOUR_CEIL(`<date_or_time_expr>`, `<period>`, `<origin>`) = min{`<origin>` + k × `<period>` × hour | k ∈ ℤ ∧ `<origin>` + k × `<period>` × hour ≥ `<date_or_time_expr>`}
14+
15+
K represents the number of periods required from the baseline time to reach the target time.
1116

1217
## Syntax
1318

1419
```sql
15-
HOUR_CEIL(<datetime>)
16-
HOUR_CEIL(<datetime>, <origin>)
17-
HOUR_CEIL(<datetime>, <period>)
18-
HOUR_CEIL(<datetime>, <period>, <origin>)
20+
HOUR_CEIL(`<date_or_time_expr>`)
21+
HOUR_CEIL(`<date_or_time_expr>`, `<origin>`)
22+
HOUR_CEIL(`<date_or_time_expr>`, `<period>`)
23+
HOUR_CEIL(`<date_or_time_expr>`, `<period>`, `<origin>`)
1924
```
2025

2126
## Parameters
2227

2328
| Parameter | Description |
2429
| -- | -- |
25-
| `<datetime>` | A valid date expression |
26-
| `<period>`| Specifies how many hours make up each period|
27-
| `<origin>` | The starting point of time. If not provided, the default is 0001-01-01T00:00:00 |
30+
| `<date_or_time_expr>` | A valid date expression that supports datetime and date types. Date type will be converted to the start of the day at 00:00:00. For specific datetime/date formats, please refer to [datetime conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
31+
| `<period>` | Optional parameter that specifies the period length (unit: hours), must be a positive integer (such as 1, 3, 5). Default value is 1, representing one period every 1 hour |
32+
| `<origin>` | The starting time origin, supports datetime and date types. If not provided, the default is 0001-01-01T00:00:00 |
2833

2934
## Return Value
3035

31-
Returns the nearest rounded-up timestamp of the specified time interval period.
36+
Returns a DATETIME type value representing the nearest period moment after rounding up.
37+
38+
- If the input period is a non-positive integer, returns an error.
39+
- If any parameter is NULL, the result returns NULL.
40+
- If origin or datetime has scale, the returned result has scale.
41+
- If the calculation result exceeds the maximum datetime range 9999-12-31 23:59:59, returns an error.
42+
3243

3344
## Examples
3445

3546
```sql
36-
select hour_ceil("2023-07-13 22:28:18", 5);
37-
```
3847

39-
```text
40-
+------------------------------------------------------------+
41-
| hour_ceil(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
42-
+------------------------------------------------------------+
43-
| 2023-07-14 02:00:00 |
44-
+------------------------------------------------------------+
48+
-- Round up with a 5-hour period
49+
mysql> select hour_ceil("2023-07-13 22:28:18", 5);
50+
+-------------------------------------+
51+
| hour_ceil("2023-07-13 22:28:18", 5) |
52+
+-------------------------------------+
53+
| 2023-07-13 23:00:00 |
54+
+-------------------------------------+
55+
56+
-- Using 2023-07-13 08:00 as the origin, divide by 4-hour periods
57+
mysql> select hour_ceil('2023-07-13 19:30:00', 4, '2023-07-13 08:00:00') as custom_origin;
58+
+----------------------------+
59+
| custom_origin |
60+
+----------------------------+
61+
| 2023-07-13 20:00:00 |
62+
+----------------------------+
63+
64+
-- Input date type will be converted to the start time 00:00:00 of the corresponding date
65+
mysql> select hour_ceil('2023-07-13 00:30:00', 6, '2023-07-13');
66+
+---------------------------------------------------+
67+
| hour_ceil('2023-07-13 00:30:00', 6, '2023-07-13') |
68+
+---------------------------------------------------+
69+
| 2023-07-13 06:00:00 |
70+
+---------------------------------------------------+
71+
72+
-- If exactly at the edge of a period, return the input datetime
73+
select hour_ceil('2023-07-13 01:00:00');
74+
+----------------------------------+
75+
| hour_ceil('2023-07-13 01:00:00') |
76+
+----------------------------------+
77+
| 2023-07-13 01:00:00 |
78+
+----------------------------------+
79+
80+
-- If origin or datetime has scale, the returned result has scale
81+
mysql> select hour_ceil('2023-07-13 19:30:00', 4, '2023-07-13 08:00:00.123') ;
82+
+----------------------------------------------------------------+
83+
| hour_ceil('2023-07-13 19:30:00', 4, '2023-07-13 08:00:00.123') |
84+
+----------------------------------------------------------------+
85+
| 2023-07-13 20:00:00.123 |
86+
+----------------------------------------------------------------+
87+
88+
mysql> select hour_ceil('2023-07-13 19:30:00.123', 4, '2023-07-13 08:00:00') ;
89+
+----------------------------------------------------------------+
90+
| hour_ceil('2023-07-13 19:30:00.123', 4, '2023-07-13 08:00:00') |
91+
+----------------------------------------------------------------+
92+
| 2023-07-13 20:00:00.000 |
93+
+----------------------------------------------------------------+
94+
95+
-- If calculation result exceeds maximum datetime range 9999-12-31 23:59:59, return NULL
96+
select hour_ceil("9999-12-31 22:28:18", 6);
97+
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation hour_ceil of 9999-12-31 22:28:18, 6 out of range
98+
99+
-- If period is less than or equal to 0, return error
100+
mysql> select hour_ceil("2023-07-13 22:28:18", 0);
101+
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[INVALID_ARGUMENT]Operation hour_ceil of 2023-07-13 22:28:18, 0 input wrong parameters, period can not be negative or zero
102+
103+
-- If any input parameter is NULL, return NULL
104+
mysql> select hour_ceil(null, 3) as null_input;
105+
+------------+
106+
| null_input |
107+
+------------+
108+
| NULL |
109+
+------------+
110+
111+
mysql> select hour_ceil("2023-07-13 22:28:18", NULL);
112+
+----------------------------------------+
113+
| hour_ceil("2023-07-13 22:28:18", NULL) |
114+
+----------------------------------------+
115+
| NULL |
116+
+----------------------------------------+
117+
118+
mysql> select hour_ceil("2023-07-13 22:28:18", 5,NULL);
119+
+------------------------------------------+
120+
| hour_ceil("2023-07-13 22:28:18", 5,NULL) |
121+
+------------------------------------------+
122+
| NULL |
123+
+------------------------------------------+
45124
```

‎docs/sql-manual/sql-functions/scalar-functions/date-time-functions/hour-floor.md‎

Lines changed: 81 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -7,40 +7,103 @@
77

88
## Description
99

10-
Converts the date to the nearest rounded-down timestamp of the specified time interval period.
10+
The HOUR_FLOOR function rounds down the input datetime value to the nearest moment of the specified hour period. For example, if the period is specified as 5 hours, the function will adjust the input time to the starting hour mark within that period.
11+
12+
Datetime calculation formula:
13+
HOUR_FLOOR(`<date_or_time_expr>`, `<period>`, `<origin>`) = max{`<origin>` + k × `<period>` × hour | k ∈ ℤ ∧ `<origin>` + k × `<period>` × hour ≤ `<date_or_time_expr>`}
14+
15+
K represents the number of periods from the baseline time to the target time.
1116

1217
## Syntax
1318

1419
```sql
15-
HOUR_FLOOR(<datetime>)
16-
HOUR_FLOOR(<datetime>, <origin>)
17-
HOUR_FLOOR(<datetime>, <period>)
18-
HOUR_FLOOR(<datetime>, <period>, <origin>)
20+
HOUR_FLOOR(`<date_or_time_expr>`)
21+
HOUR_FLOOR(`<date_or_time_expr>`, `<origin>`)
22+
HOUR_FLOOR(`<date_or_time_expr>`, `<period>`)
23+
HOUR_FLOOR(`<date_or_time_expr>`, `<period>`, `<origin>`)
1924
```
2025

2126
## Parameters
2227

2328
| Parameter | Description |
2429
| -- | -- |
25-
| `<datetime>` | A valid date expression |
26-
| `<period>` | Specifies how many hours make up each period|
27-
| `<origin>` | The starting point of time. If not provided, the default is 0001-01-01T00:00:00 |
30+
| `<date_or_time_expr>` | A valid date expression that supports datetime/date types. Date type will be converted to the start time 00:00:00 of the corresponding date. For specific datetime/date formats, please refer to [datetime conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion) and [date conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion) |
31+
| `<period>` | Optional parameter that specifies the period length (unit: hours), must be a positive integer (such as 2, 6, 12). Default value is 1, representing one period every 1 hour |
32+
| `<origin>` | The starting time origin, supports datetime/date types. If not provided, the default is 0001-01-01T00:00:00 |
2833

2934
## Return Value
3035

31-
Returns the nearest rounded-down timestamp of the specified time interval period.
36+
Returns a DATETIME type value representing the nearest period moment after rounding down.
37+
38+
- If the input period is a non-positive integer, returns NULL.
39+
- If any parameter is NULL, the result returns NULL.
40+
- If origin or datetime has scale, the returned result has scale.
3241

3342
## Examples
3443

3544
```sql
36-
select hour_floor("2023-07-13 22:28:18", 5);
37-
```
3845

39-
```text
40-
+-------------------------------------------------------------+
41-
| hour_floor(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
42-
+-------------------------------------------------------------+
43-
| 2023-07-13 21:00:00 |
44-
+-------------------------------------------------------------+
45-
```
46+
-- Round down by 5-hour period, default origin is 0001-01-01 00:00:00
47+
mysql> select hour_floor("2023-07-13 22:28:18", 5);
48+
+--------------------------------------+
49+
| hour_floor("2023-07-13 22:28:18", 5) |
50+
+--------------------------------------+
51+
| 2023-07-13 18:00:00 |
52+
+--------------------------------------+
53+
54+
-- Using 2023-07-13 08:00 as origin, divide by 4-hour periods
55+
mysql> select hour_floor('2023-07-13 19:30:00', 4, '2023-07-13 08:00:00') as custom_origin;
56+
+---------------------+
57+
| custom_origin |
58+
+---------------------+
59+
| 2023-07-13 16:00:00 |
60+
+---------------------+
61+
62+
-- Input datetime exactly at period edge, return input datetime value
63+
select hour_floor("2023-07-13 18:00:00", 5);
64+
+--------------------------------------+
65+
| hour_floor("2023-07-13 18:00:00", 5) |
66+
+--------------------------------------+
67+
| 2023-07-13 18:00:00 |
68+
+--------------------------------------+
69+
70+
-- Input date type will be converted to start time 2023-07-13 00:00:00 of the day
71+
mysql> select hour_floor('2023-07-13 20:30:00', 4, '2023-07-13');
72+
+----------------------------------------------------+
73+
| hour_floor('2023-07-13 20:30:00', 4, '2023-07-13') |
74+
+----------------------------------------------------+
75+
| 2023-07-13 20:00:00 |
76+
+----------------------------------------------------+
77+
78+
-- If origin or datetime has scale, the returned result has scale
79+
mysql> select hour_floor('2023-07-13 19:30:00.123', 4, '2023-07-03 08:00:00') as custom_origin;
80+
+-------------------------+
81+
| custom_origin |
82+
+-------------------------+
83+
| 2023-07-13 16:00:00.000 |
84+
+-------------------------+
85+
86+
mysql> select hour_floor('2023-07-13 19:30:00', 4, '2023-07-03 08:00:00.123') as custom_origin;
87+
+-------------------------+
88+
| custom_origin |
89+
+-------------------------+
90+
| 2023-07-13 16:00:00.123 |
91+
+-------------------------+
92+
93+
-- Input any parameter as NULL (returns NULL)
94+
mysql> select hour_floor(null, 6) as null_input;
95+
+------------+
96+
| null_input |
97+
+------------+
98+
| NULL |
99+
+------------+
100+
101+
-- Period is negative, returns NULL
102+
mysql> select hour_floor('2023-12-31 23:59:59', -3);
103+
+---------------------------------------+
104+
| hour_floor('2023-12-31 23:59:59', -3) |
105+
+---------------------------------------+
106+
| NULL |
107+
+---------------------------------------+
46108

109+
```

‎docs/sql-manual/sql-functions/scalar-functions/date-time-functions/hour.md‎

Lines changed: 61 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -7,46 +7,85 @@
77

88
## Description
99

10-
Obtains the hour information from the given datetime.
10+
The HOUR function extracts the hour part from a datetime or time expression. This function supports multiple time type inputs, including DATE/DATETIME and TIME, and returns the corresponding hour value.
11+
12+
For DATETIME (such as '2023-10-01 14:30:00'), the return value ranges from 0-23 (24-hour format).
13+
For TIME type (such as '456:26:32'), the return value can exceed 24, ranging from [0,838].
14+
15+
This function behaves consistently with the [hour function](https://dev.mysql.com/doc/refman/8.4/en/date-and-time-functions.html#function_hour) in MySQL.
1116

1217
## Syntax
1318

1419
```sql
15-
HOUR(<dt>)
20+
HOUR(`<date_or_time_expr>`)
1621
```
1722

1823
## Parameters
1924

2025
| Parameter | Description |
2126
| -- | -- |
22-
| `<dt>` | The date to be calculated. |
27+
| `<date_or_time_expr>` | A valid date expression that supports datetime/date/time types. Date type will be converted to the start time 00:00:00 of the corresponding date. For specific datetime/date/time formats, please refer to [datetime conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/datetime-conversion), [date conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/date-conversion), and [time conversion](../../../../../current/sql-manual/basic-element/sql-data-types/conversion/time-conversion) |
2328

2429
## Return Value
2530

26-
Returns the hour information from the given date. The return value ranges from 0 to 23. When the parameter is of type TIME, the return value can be greater than 24.
31+
Returns an integer type (INT) representing the hour part of the input expression.
32+
- For DATETIME, returns an integer from 0-23.
33+
- For DATE type, returns 0.
34+
- For TIME type, returns an integer from 0 to 838 (consistent with the TIME type range).
35+
- If the input parameter is NULL, returns NULL.
2736

2837
## Examples
2938

3039
```sql
31-
select hour('2018-12-31 23:59:59');
32-
```
40+
-- Extract hour from datetime (24-hour format)
41+
select
42+
hour('2018-12-31 23:59:59') as last_hour,
43+
hour('2023-01-01 00:00:00') as midnight,
44+
hour('2023-10-01 12:30:45') as noon;
3345

34-
```text
35-
+-----------------------------+
36-
| hour('2018-12-31 23:59:59') |
37-
+-----------------------------+
38-
| 23 |
39-
+-----------------------------+
40-
```
46+
+-----------+----------+------+
47+
| last_hour | midnight | noon |
48+
+-----------+----------+------+
49+
| 23 | 0 | 12 |
50+
+-----------+----------+------+
4151

42-
```sql
43-
select cast(4562632 as time),hour(cast(4562632 as time)), minute(cast(4562632 as time)),second(cast(4562632 as time));
44-
```
52+
-- Extract hour from TIME type (supports over 24 or negative values)
53+
select
54+
hour(cast('14:30:00' as time)) as normal_hour,
55+
hour(cast('25:00:00' as time)) as over_24,
56+
hour(cast('456:26:32' as time)) as large_hour,
57+
hour(cast('-12:30:00' as time)) as negative_hour,
58+
hour(cast('838:59:59' as time)) as max_hour,
59+
hour(cast('-838:59:59' as time)) as min_hour;
60+
61+
+-------------+---------+------------+---------------+----------+----------+
62+
| normal_hour | over_24 | large_hour | negative_hour | max_hour | min_hour |
63+
+-------------+---------+------------+---------------+----------+----------+
64+
| 14 | 25 | 456 | 12 | 838 | 838 |
65+
+-------------+---------+------------+---------------+----------+----------+
66+
67+
-- Extract hour from date type, returns 0
68+
select hour("2022-12-12");
69+
+--------------------+
70+
| hour("2022-12-12") |
71+
+--------------------+
72+
| 0 |
73+
+--------------------+
4574

46-
```text
47-
+-----------------------+-----------------------------+-------------------------------+-------------------------------+
48-
| cast(4562632 as TIME) | hour(cast(4562632 as TIME)) | minute(cast(4562632 as TIME)) | second(cast(4562632 as TIME)) |
49-
+-----------------------+-----------------------------+-------------------------------+-------------------------------+
50-
| 456:26:32 | 456 | 26 | 32 |
51-
+-----------------------+-----------------------------+-------------------------------+-------------------------------+
75+
-- Will not automatically convert input time string to time, returns NULL
76+
select hour('14:30:00') as normal_hour;
77+
+-------------+
78+
| normal_hour |
79+
+-------------+
80+
| NULL |
81+
+-------------+
82+
83+
-- Input parameter is NULL, returns NULL
84+
mysql> select hour(NULL);
85+
+------------+
86+
| hour(NULL) |
87+
+------------+
88+
| NULL |
89+
+------------+
5290
```
91+

0 commit comments

Comments
 (0)