## =dateStr(date, format, offset) `version 1.3.79及以上版本` `date 20210813` 说明：返回格式化后的时间字符串 | 参数 | 描述| | --- | --- | | date | 时间字符串，格式必须如 `年-月-日 时:分:秒`例：`2021-08-11 12:00:01`，也可以不传，不传取当前时间 | |format | 格式化字符串，默认格式为`yyyy-MM-dd HH:mm:ss`，如果设置了date参数的值，该参数必须传 | |offset| 数值偏移量，可以为负数，如果format 为**单值**(`yyyy` 、`MM` 、`dd `、`HH`、`mm`、`ss`)，只对format(年/月/日/时/分/秒)的值计算，如果format 是混合格式，则按天计算。 如果设置了date参数的值，该参数必须传，可以传0。| **所有示例已列出，使用时参考文档传递相同类型的参数，其他形式的传参均不支持：** *假设当前时间为 2020-08-11 12:00:01* - 不传参数 #### `=dateStr() ` 获取的值为：2020-08-11 12:00:01 - 只传1个参数： #### `=dateStr('yyyy-MM-dd') ` 获取的值为： 2020-08-11 - 传2个参数 #### `=dateStr('MM', 2)` 获取的值为：10 #### `=dateStr('dd', -1) ` 获取的值为：10 - 传3个参数 #### `=dateStr('2020-08-15 12:00:01', 'yyyy-MM-dd', 1) ` 获取的值为：2020-08-16 #### ` =dateStr('2020-08-15 12:00:01', 'MM', 1) ` 获取的值为：9 --- 升级功能： - 传2个参数 `version 1.4.0` #### `=dateStr('yyyy-MM', -1)` 获取的值为：2020-07 ---- *注意：关于时间计算 数值偏移量offset设置，如果当前月是12月，offset设置为1，format为MM, 则最终获取的值是1，日期，小时，分钟，秒均适用此规则。*