## =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，日期，小時，分鐘，秒均適用此規則。*