# **SECONDS**

返回两个日期之间间隔的秒数。

如果起始日期大于结束日期，则返回负数。

## 语法{#grammar}

SECONDS(**dateStart**, **dateEnd**)

- **dateStart**：必需，为起始日期。可以是日期类型的字符串，也可以使用[TODATE](../transform/TODATE.md)转成日期对象
- **dateEnd**：必需，为结束日期。类型同上

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

## 示例{#example}

1. `SECONDS("20200717 10:23:45","20200717 10:23:59")` 日期格式为yyyymmdd，返回`14`
2. `SECONDS("20200717 10:23:59","20200717 10:23:45")` 结束日期小于起始日期，返回`-14`
3. `SECONDS("2020-07-17 10:23:45","2020-07-17 10:23:59")` 日期格式为yyyy-mm-dd，返回`14`
4. `SECONDS("2020.07.17 10:23:45","2020.07.17 10:23:59")` 日期格式为yyyy.mm.dd，返回`14`
5. `SECONDS("2020/07/17 10:23:45","2020/07/17 10:23:59")` 日期格式为yyyy/mm/dd，返回`14`
6. `SECONDS("2020 07 17 10:23:45","2020 07 17 10:23:59")` 日期格式为yyyy mm dd，返回`14`
7. `SECONDS("20210126000001","20210126000002")` 日期格式为yyyymmddhhmmss，返回`1`
8. `SECONDS(DATE(2021,1,26,0,1,1),DATE(2021,1,26,0,2,2))` 转换为日期对象后返回日期之间间隔的秒数，返回`61`
9. `SECONDS(TODATE("20210126000101","yyyymmddhhmmss"),TODATE("20210126000202","yyyymmddhhmmss")）` 返回日期对象后返回日期之间间隔的秒数，返回`61`
10. `SECONDS(A1,B1)` 引用单元格A1到B1的之间的秒数，返回`1,123,200`
11. `SECONDS([行政处罚信息].[决定日期],[行政处罚信息].[公示日期])` 参数值返回行政处罚公示日期到决定日期之间的秒数，返回`1,123,200`