# **DATE**

返回时间戳类型。

参数可以按顺序指定任意多个，如只指定了**year**参数，那么返回的日期对象将只包含年份，其他属性为0。省略时返回当前时间的天数，和[NOW()](./NOW.md)函数的返回值相同。

## 语法{#grammar}

DATE(**year**, **month**, **day**, **hour**, **minute**, **second**)

- **year**： 一个四位整数，表示日期的年份
- **month**：1-12的整数，表示一年中的月份
- **day**：1-31的整数，表示一个月中的天数
- **hour**：0-23的整数，表示一天中的小时数
- **minute**：0-59的整数，表示一个小时中的分钟
- **second**：0-59的整数，表示一分钟中的秒数

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

## 示例{#example}

1. `DATE(2020,7,15,16,20,3)` 返回表示日期时间的数字`2020-07-15 16:20:03`
2. `DATE(2020)` 输入值只有年，返回`2020`
3. `DATE(2020,7)` 输入值只有年月，返回`2020-07`
4. `DATE(2020,7,15)` 输入值只有年月日，返回`2020-07-15`
5. `DATE(2020,7,15,16)` 输入值省略分、秒，返回`2020-07-15 16`
6. `DATE(2020,7,15,16,20)` 输入值省略秒，返回`2020-07-15 16:20`
7. `DATE(A1,B1)` 引用单元格数值，返回销售日期`2018-12-01`