---
order: 4
navTitle: 日期
---
# 仪表板组件-日期

日期组件用于过滤数据，筛选出指定时间范围内的数据。

![瀑布图](./images/2021-10-18-10-43-23.png)

示例地址：[日期](https://demo.succbi.com/v5/bi/waterfall)

## 使用日期组件{#use}

日期组件选择的数据类型只能是对应日期的**日期型**或者**字符型**，在字段下拉框里选择相应的日期字段，如【年月】。

**操作步骤**

![操作](./images/2021-10-18-11-57-33.gif)

1. **引入日期字段**：双击或拖入维度字段【FACT\_JHWCB.年月.年】到**数据**>**字段**
2. **设置默认值**：**输入**属性处设置**默认值**为`2017年`
3. **设置选择范围**：**可选项**属性处设置**类型**为`年`、**最早**为`2017`、**最晚**为`2018`

## 属性介绍{#attribute}

可以通过属性设置日期组件的默认值、日期类型等。

### 默认值{#value}

想要控制日期组件的默认值，在**输入**>**默认值**处进行设置。默认值的选择粒度受[可选项](#choose)>**类型**的影响，当日期类型为年时，默认值也只能根据年进行选择。默认值的设置类型有4类：**指定**、**范围**、**相对**、**表达式**，详细定义可见[日期](../../../../app/superpage/components/input/datecombobox.md#settings)。

![默认值](./images/2021-10-19-17-22-28.png)

### 可选项{#choose}

在**可选项**属性处可设置选择日期时的**类型**，如年、月、日等。也可以设置勾选项**只选择已有日期**、**允许选择范围**、**允许选择相对值**、**允许清空**。

![可选项](./images/2021-10-19-18-59-08.png)

- **类型**：类型处的选择用于控制时间组件的选择粒度。如类型选择`年`，则时间组件也只能根据年进行选择。日期类型包含**自动**、**年月日**、**年月**、**年**、**半年**、**年季**、**年月旬**、**年周**、**时分秒**、**时分**、**小时**、**日期+时间**。当类型选择为`自动`时，即默认为字段数据的类型。选择非自动的类型后，会出现**最早**、**最晚**两个属性
  - **最早**：控制日期组件可选择的最早时间，支持表达式书写
  - **最晚**：控制日期组件可选择的最晚时间，支持表达式书写
- **只选择已有日期**：勾选表示只能选择数据字段中已有的日期
- **允许选择相对值**：系统默认勾选，勾选表示日期组件中允许选择日期的相对值作为日期组件的值，如`一天前`，勾选后**输入**>**默认值**的设置会增加**相对**这一类型
- **允许选择范围**：系统默认勾选，勾选表示日期组件中允许选择日期范围作为值，勾选后**输入**>**默认值**的设置会增加**范围**这一类型
- **允许清空**：勾选表示允许清空日期组件的选中项

:::tip
当数据字段为字符型时，必须为该字段设置[日期角色](../../../../data-gov/model/field-role.md#date)，选择非自动的**类型**数据过滤才能生效。
:::

## 移动端展示效果{#mobile}

仪表板支持设置移动端布局，移动布局下日期组件的设置与PC端一致，更多移动设置可见[移动](../../design/mobile/README.md)文档。日期组件在移动布局中的展示效果如下：

![移动](./images/2021-10-19-19-04-54.png)