# **HOUR**

返回日期对象的小时数。

以整数的形式返回时间戳类型的日期对象的小时数，返回值是 0 （午夜） 到 23 （晚上 11 点）之间的一个整数。

## 语法{#grammar}

HOUR(**date**)

- **date**：可选，时间戳类型的字段或者表达式。省略时返回当前时间的小时数

**示例地址：** [HOUR](https://demo.succbi.com/v5/bi/hour)

## 示例{#example}

1. `HOUR()` 返回当前时间的小时数`14`
2. `HOUR("20200723 11:44:28")` 日期格式为yyyyddmm返回小时数`11`
3. `HOUR("2020-07-23 11:44:28")` 日期格式为yyyy-mm-dd返回小时数`11`
4. `HOUR("2020.07.23 11:44:28")` 日期格式为yyyy.mm.dd返回小时数`11`
5. `HOUR("2020/07/23 11:44:28")` 日期格式为yyyy/mm/dd返回小时数`11`
6. `HOUR("2020 07 23 11:44:28")` 日期格式为yyyy mm dd返回小时数`11`
7. `HOUR(DATE(2021,1,26,5,1,1))` 转换为日期对象后返回日期的小时数`5`
8. `HOUR(TODATE("20210126050101","yyyymmddhhmmss"))` 返回日期对象后返回日期的小时数`5`
9. `HOUR(A1)` 静态字段获取A1的值，返回日期对象中的小时数`1`
10. `HOUR([门店销售明细表].[销售日期])` 数据库字段获取销售日期，返回日期对象中的小时数`1`