# **YEAR**

返回日期对象的年份值，返回值为 1900 到 9999 之间的整数。

## 语法{#grammar}

YEAR(**date**)

- **date**：可选，日期类型或日期类型字符串。省略时返回当前时间的年份

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

## 示例{#example}

1. `YEAR()` 返回当前时间的年份`2022`
2. `YEAR("20200716")` 日期格式为yyyyddmm返回年份`2020`
3. `YEAR("2020-07-16")`日期格式为yyyy-dd-mm返回年份`2020`
4. `YEAR("2020/07/16")` 日期格式为yyyy/dd/mm返回年份`2020`
5. `YEAR("2020.07.16")` 日期格式为yyyy.dd.mm返回年份`2020`
6. `YEAR(A1)` 静态字段获取A1的值，返回日期中的年份`2017`
7. `YEAR([门店销售明细表].[销售日期])` 数据库字段获取销售日期，返回日期中的年份`2017`