# 基础函数 - 常用日期时间函数

文档类型：函数事实页
是否可直接用于生成代码：是；本页函数条目均包含参数表
遇到不确定时：回到 [../base.md](../base.md)、[../../index.md](../../index.md)

## 常用日期时间函数

### `time()`

用途：日期时间处理函数。

参数个数：0
返回值：日期或时间值

| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | ---- |

### `decodeTime(value, hour, minute, second, millisecond)`

用途：日期时间处理函数。

参数个数：5
返回值：日期或时间值

| 参数位置 | 参数名        | 必填 | 接收类型 | 说明                                            |
| -------- | ------------- | ---- | -------- | ----------------------------------------------- |
| 1        | `value`       | 是   | 任意值   | 按源文档示例顺序传入                            |
| 2        | `hour`        | 是   | 整数     | 按源文档示例顺序传入；源文档示例传入变量 `hour` |
| 3        | `minute`      | 是   | 整数     | 按源文档示例顺序传入；源文档示例传入变量 `min`  |
| 4        | `second`      | 是   | 整数     | 按源文档示例顺序传入；源文档示例传入变量 `sec`  |
| 5        | `millisecond` | 是   | 整数     | 按源文档示例顺序传入；源文档示例传入变量 `msec` |

### `dayOfWeek(value)`

用途：日期时间相关函数。

参数个数：1
返回值：处理后的结果值

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
| -------- | ------- | ---- | -------- | -------------------- |
| 1        | `value` | 是   | 任意值   | 按源文档示例顺序传入 |

### `encodeTime(hour, minute, second, millisecond)`

用途：日期时间处理函数。

参数个数：4
返回值：日期或时间值

| 参数位置 | 参数名        | 必填 | 接收类型 | 说明                 |
| -------- | ------------- | ---- | -------- | -------------------- |
| 1        | `hour`        | 是   | 整数     | 按源文档示例顺序传入 |
| 2        | `minute`      | 是   | 整数     | 按源文档示例顺序传入 |
| 3        | `second`      | 是   | 整数     | 按源文档示例顺序传入 |
| 4        | `millisecond` | 是   | 整数     | 按源文档示例顺序传入 |

### `now()`

用途：日期时间相关函数。

参数个数：0
返回值：处理后的结果值

| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | ---- |

### `decodeDate(value, year, month, day)`

用途：日期时间处理函数。

参数个数：4
返回值：日期或时间值

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                                             |
| -------- | ------- | ---- | -------- | ------------------------------------------------ |
| 1        | `value` | 是   | 任意值   | 按源文档示例顺序传入                             |
| 2        | `year`  | 是   | 整数     | 按源文档示例顺序传入；源文档示例传入变量 `year`  |
| 3        | `month` | 是   | 整数     | 按源文档示例顺序传入；源文档示例传入变量 `month` |
| 4        | `day`   | 是   | 整数     | 按源文档示例顺序传入；源文档示例传入变量 `day`   |

### `date()`

用途：日期时间处理函数。

参数个数：0
返回值：日期或时间值

| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | ---- |

### `tryEncodeDate(year, month, day, out_date)`

用途：日期时间处理函数。

参数个数：4
返回值：日期或时间值

| 参数位置 | 参数名     | 必填 | 接收类型 | 说明                                            |
| -------- | ---------- | ---- | -------- | ----------------------------------------------- |
| 1        | `year`     | 是   | 整数     | 按源文档示例顺序传入                            |
| 2        | `month`    | 是   | 整数     | 按源文档示例顺序传入                            |
| 3        | `day`      | 是   | 整数     | 按源文档示例顺序传入                            |
| 4        | `out_date` | 是   | 任意值   | 按源文档示例顺序传入；源文档示例传入变量 `date` |

### `tryEncodeTime(hour, minute, second, millisecond, out_time)`

用途：日期时间处理函数。

参数个数：5
返回值：日期或时间值

| 参数位置 | 参数名        | 必填 | 接收类型 | 说明                                            |
| -------- | ------------- | ---- | -------- | ----------------------------------------------- |
| 1        | `hour`        | 是   | 整数     | 按源文档示例顺序传入                            |
| 2        | `minute`      | 是   | 整数     | 按源文档示例顺序传入                            |
| 3        | `second`      | 是   | 整数     | 按源文档示例顺序传入                            |
| 4        | `millisecond` | 是   | 整数     | 按源文档示例顺序传入                            |
| 5        | `out_time`    | 是   | 任意值   | 按源文档示例顺序传入；源文档示例传入变量 `time` |

### `decodeDateFully(value, year, month, day, day_of_week)`

用途：日期时间处理函数。

参数个数：5
返回值：日期或时间值

| 参数位置 | 参数名        | 必填 | 接收类型 | 说明                                             |
| -------- | ------------- | ---- | -------- | ------------------------------------------------ |
| 1        | `value`       | 是   | 任意值   | 按源文档示例顺序传入                             |
| 2        | `year`        | 是   | 整数     | 按源文档示例顺序传入；源文档示例传入变量 `year`  |
| 3        | `month`       | 是   | 整数     | 按源文档示例顺序传入；源文档示例传入变量 `month` |
| 4        | `day`         | 是   | 整数     | 按源文档示例顺序传入；源文档示例传入变量 `day`   |
| 5        | `day_of_week` | 是   | 整数     | 按源文档示例顺序传入；源文档示例传入变量 `dow`   |

### `encodeDate(year, month, day)`

用途：日期时间处理函数。

参数个数：3
返回值：日期或时间值

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
| -------- | ------- | ---- | -------- | -------------------- |
| 1        | `year`  | 是   | 整数     | 按源文档示例顺序传入 |
| 2        | `month` | 是   | 整数     | 按源文档示例顺序传入 |
| 3        | `day`   | 是   | 整数     | 按源文档示例顺序传入 |

### `tryStrToDate(value, out_date)`

用途：日期时间处理函数。

参数个数：2
返回值：日期或时间值

| 参数位置 | 参数名     | 必填 | 接收类型 | 说明                                            |
| -------- | ---------- | ---- | -------- | ----------------------------------------------- |
| 1        | `value`    | 是   | 字符串   | 按源文档示例顺序传入                            |
| 2        | `out_date` | 是   | 任意值   | 按源文档示例顺序传入；源文档示例传入变量 `date` |

### `strToDateTimeDef(value, default_value)`

用途：将字符串转换为对应类型。

参数个数：2
返回值：转换后的数值或日期

| 参数位置 | 参数名          | 必填 | 接收类型 | 说明                 |
| -------- | --------------- | ---- | -------- | -------------------- |
| 1        | `value`         | 是   | 字符串   | 按源文档示例顺序传入 |
| 2        | `default_value` | 是   | 任意值   | 按源文档示例顺序传入 |

### `dateTimeToInternetStr(end_t, arg2)`

用途：日期时间处理函数。

参数个数：2
返回值：日期或时间值

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
| -------- | ------- | ---- | -------- | -------------------- |
| 1        | `end_t` | 是   | 任意值   | 按源文档示例顺序传入 |
| 2        | `arg2`  | 是   | 整数     | 按源文档示例顺序传入 |

### `incAMonth(year, month, day, arg4)`

用途：常用日期时间函数相关函数。

参数个数：4
返回值：日期或时间值

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
| -------- | ------- | ---- | -------- | -------------------- |
| 1        | `year`  | 是   | 整数     | 按源文档示例顺序传入 |
| 2        | `month` | 是   | 整数     | 按源文档示例顺序传入 |
| 3        | `day`   | 是   | 整数     | 按源文档示例顺序传入 |
| 4        | `arg4`  | 是   | 整数     | 按源文档示例顺序传入 |

### `strToTime(value)`

用途：将字符串转换为对应类型。

参数个数：1
返回值：转换后的数值或日期

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
| -------- | ------- | ---- | -------- | -------------------- |
| 1        | `value` | 是   | 字符串   | 按源文档示例顺序传入 |

### `currentYear()`

用途：日期时间相关函数。

参数个数：0
返回值：处理后的结果值

| 参数位置 | 参数名 | 必填 | 接收类型 | 说明 |
| -------- | ------ | ---- | -------- | ---- |

### `tryStrToTime(value, out_time)`

用途：日期时间处理函数。

参数个数：2
返回值：日期或时间值

| 参数位置 | 参数名     | 必填 | 接收类型 | 说明                                            |
| -------- | ---------- | ---- | -------- | ----------------------------------------------- |
| 1        | `value`    | 是   | 字符串   | 按源文档示例顺序传入                            |
| 2        | `out_time` | 是   | 任意值   | 按源文档示例顺序传入；源文档示例传入变量 `time` |

### `strToDate(value)`

用途：将字符串转换为对应类型。

参数个数：1
返回值：转换后的数值或日期

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
| -------- | ------- | ---- | -------- | -------------------- |
| 1        | `value` | 是   | 字符串   | 按源文档示例顺序传入 |

### `dateTimeGMTToHttpStr(end_t)`

用途：日期时间处理函数。

参数个数：1
返回值：日期或时间值

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
| -------- | ------- | ---- | -------- | -------------------- |
| 1        | `end_t` | 是   | 任意值   | 按源文档示例顺序传入 |

### `dateToStr(value)`

用途：将输入值转换为字符串。

参数个数：1
返回值：字符串

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
| -------- | ------- | ---- | -------- | -------------------- |
| 1        | `value` | 是   | 任意值   | 按源文档示例顺序传入 |

### `strToTimeDef(value, default_value)`

用途：将字符串转换为对应类型。

参数个数：2
返回值：转换后的数值或日期

| 参数位置 | 参数名          | 必填 | 接收类型 | 说明                 |
| -------- | --------------- | ---- | -------- | -------------------- |
| 1        | `value`         | 是   | 字符串   | 按源文档示例顺序传入 |
| 2        | `default_value` | 是   | 任意值   | 按源文档示例顺序传入 |

### `dateTimeToStr(value)`

用途：将输入值转换为字符串。

参数个数：1
返回值：字符串

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
| -------- | ------- | ---- | -------- | -------------------- |
| 1        | `value` | 是   | 任意值   | 按源文档示例顺序传入 |

### `dateTimeToString(out_text, format_text, value)`

用途：将输入值转换为字符串。

参数个数：3
返回值：字符串

| 参数位置 | 参数名        | 必填 | 接收类型 | 说明                 |
| -------- | ------------- | ---- | -------- | -------------------- |
| 1        | `out_text`    | 是   | 字符串   | 按源文档示例顺序传入 |
| 2        | `format_text` | 是   | 字符串   | 按源文档示例顺序传入 |
| 3        | `value`       | 是   | 任意值   | 按源文档示例顺序传入 |

### `formatDateTime(format_text, value)`

用途：按指定格式输出结果。

参数个数：2
返回值：日期或时间值

| 参数位置 | 参数名        | 必填 | 接收类型 | 说明                 |
| -------- | ------------- | ---- | -------- | -------------------- |
| 1        | `format_text` | 是   | 字符串   | 按源文档示例顺序传入 |
| 2        | `value`       | 是   | 任意值   | 按源文档示例顺序传入 |

### `dateTimeGMTToCookieStr(end_t)`

用途：日期时间处理函数。

参数个数：1
返回值：日期或时间值

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
| -------- | ------- | ---- | -------- | -------------------- |
| 1        | `end_t` | 是   | 任意值   | 按源文档示例顺序传入 |

### `strToDateTime(value)`

用途：将字符串转换为对应类型。

参数个数：1
返回值：转换后的数值或日期

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
| -------- | ------- | ---- | -------- | -------------------- |
| 1        | `value` | 是   | 字符串   | 按源文档示例顺序传入 |

### `isLeapYear(year)`

用途：判断条件是否成立。

参数个数：1
返回值：布尔值

| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1        | `year` | 是   | 整数     | 按源文档示例顺序传入 |

### `gmtToLocalDateTime(gmt)`

用途：日期时间处理函数。

参数个数：1
返回值：日期或时间值

| 参数位置 | 参数名 | 必填 | 接收类型 | 说明                 |
| -------- | ------ | ---- | -------- | -------------------- |
| 1        | `gmt`  | 是   | 字符串   | 按源文档示例顺序传入 |

### `timeToStr(value)`

用途：常用日期时间函数相关函数。

参数个数：1
返回值：日期或时间值

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                 |
| -------- | ------- | ---- | -------- | -------------------- |
| 1        | `value` | 是   | 实数     | 按源文档示例顺序传入 |

### `strToDateDef(value, default_value)`

用途：将字符串转换为对应类型。

参数个数：2
返回值：转换后的数值或日期

| 参数位置 | 参数名          | 必填 | 接收类型 | 说明                 |
| -------- | --------------- | ---- | -------- | -------------------- |
| 1        | `value`         | 是   | 字符串   | 按源文档示例顺序传入 |
| 2        | `default_value` | 是   | 任意值   | 按源文档示例顺序传入 |

### `tryStrToDateTime(value, out_datetime)`

用途：日期时间处理函数。

参数个数：2
返回值：日期或时间值

| 参数位置 | 参数名         | 必填 | 接收类型 | 说明                                                |
| -------- | -------------- | ---- | -------- | --------------------------------------------------- |
| 1        | `value`        | 是   | 字符串   | 按源文档示例顺序传入                                |
| 2        | `out_datetime` | 是   | 任意值   | 按源文档示例顺序传入；源文档示例传入变量 `datetime` |
