1. 日期函数简介
- DATE
- TIME
- TIMESTAMP
- TODAY
- NOW
- SYSTIME
- DAY
- MONTH
- YEAR
- HOUR
- MINUTE
- SECOND
- DAYS
- DAYS360
- DATEDIF
- DATEDELTA
- WEEKNUM
- ISOWEEKNUM
日期组件的返回值为时间戳（timestamp），单位是毫秒；以下日期函数的参数可以直接使用日期组件。例如：YEAR (日期组件)
下面介绍关于日期函数的两个基本概念：
时间戳（TIMESTAMP）：时间戳是计算机记录时间的一种格式。通常是一个字符序列，唯一地标识某一刻的时间。在宜搭表单中，「日期」组件便是由这样的序列来存储的
日期对象：可以理解为年月日时分秒；日期对象的格式为 Sat Aug 01 2021 00:00:00 GMT+0800（中国标准时间），即北京时间 2021 年 8 月 1 日 00:00:00，日期对象可以进行各种运算，比如日期加减法等
2. 公式示例
2.1 DATE函数
表达式：DATE(timestamp)
入参：
- timestamp: 必需，时间戳
返回值：
- 类型：日期对象
- 返回值规则：将时间戳转换为日期对象（用来将日期组件的时间戳转为日期对象进行日期公式运算）
示例
注释：把「申请日期」这个时间组件中的存储的“时间戳”值，转化为文本值填入「申请日期-文本」（单行文本）中。
支持的占位符(注意大小写)：
2.2 TIME函数
表达式：TIME(hour, minute, second)
入参：
- hour：小时
- minute：分钟
- second：秒数
返回值：
- 类型：数值
- 返回值规则：返回特定时间的十进制数字。时间值为日期值的一部分，并用十进制数表示
示例
复合函数案例：
输出的数值：
2.3 TIMESTAMP函数
表达式：TIMESTAMP(date)
入参：
- 赋值给日期组件
返回值：
- 类型：日期
- 返回值规则：将日期对象转换成时间戳,主要用来将日期公式计算出的日期对象转为时间戳，给日期组件赋值
示例
实现效果：
2.4 TODAY函数
表达式：TODAY()
返回值：
- 类型：日期
- 返回值规则：得出今天的日期
示例
2.5 NOW函数
表达式：NOW()
返回值：
- 类型：日期
- 返回值规则：将当前日期赋值给日期组件
2.6 SYSTIME函数
表达式：SYSTIME()
返回值：
- 类型：日期
- 返回值规则：自动获取当前服务器时间
注：即使客户端的时间被人为调整了，SYSTIME 函数不受影响，获取的仍然是服务器时间。例如签到、打卡等场景下，可避免调整时间作弊的情况。
示例
2.7 DAY函数
表达式：DAY(date)
入参：
- 指定日期
返回值：
- 类型：数值
- 返回值规则：返回日期天数（天数是介于 1 到 31 之间的整数）
示例
实现效果：
2.8 MONTH函数
表达式：MONTH(date)
入参：
- 指定日期
返回值：
- 类型：数值
- 返回值规则：返回日期月份（月份是介于 1 到 12 之间的整数）
示例
实现效果：
2.9 YEAR函数
表达式：YEAR(date)
入参：
- 指定日期
返回值：
- 类型：数值
- 返回值规则：返回日期年份
示例
实现效果：
2.10 HOUR函数
表达式：HOUR(date)
入参：
- 日期组件
返回值：
- 类型：数值
- 返回值规则：返回日期小时数
示例
实现效果：
2.11 MINUTE函数
表达式：MINUTE(date)
入参：
- 指定日期
返回值：
- 类型：数值
- 返回值规则：返回日期分钟数
示例
实现效果：
2.12 SECOND函数
表达式：SECOND(date)
入参：
- 指定日期
返回值：
- 类型：数值
- 返回值规则：返回日期秒数
示例
实现效果：
2.13 DAYS函数
表达式：DAYS(end_date, start_date)
入参：
- end_date: 必需。结束日期。
- start_date: 必需。起始日期。
返回值：
- 类型：数值
- 返回值规则：得出日期之间天数
示例
实现效果：
2.14 DAYS360函数
表达式：DAYS360(end_date, start_date, method)
入参：
- end_date: 必需。结束日期。
- start_date: 必需。起始日期。
- method: 可选。用于指定在计算中是采用美国方法还是欧洲方法。不填或 false 表示是美国方法，true 表示是欧洲方法。
返回值：
- 类型：数值
- 返回值规则：返回 2 个日期相差天数
公式目的：按照一年 360 天的算法（每个月以 30 天计，一年共计 12 个月），DAYS360 函数返回两个日期间相差的天数，这在一些会计计算中将会用到。 如果财会系统是基于一年 12 个月，每月 30 天，可使用此函数帮助计算支付款项。
示例：
2.15 DATEDELTA函数
表达式：DATEDELTA(date, delta_days)
入参：
- date: 必需。初始日期。
- delta_days: 必需。需要加减的天数。正数为增加，负数为减少。
返回值：
- 类型：日期
- 返回值规则：自动返回指定加/减天数后的日期时间
示例：
注解：在「开始时间」基础上，添加12天作为「结束时间」
2.16 WEEKNUM函数
表达式：WEEKNUM(date, return_type)
入参：
- data: 必需。指定日期。代表一周中的日期。应使用 DATE 函数输入日期，或者将日期作为其他公式或函数的结果输入
- return_type: 可选。一数字，确定星期从哪一天开始，默认值为 1。 数字1为周日开始，数字2为周一开始，当前只支持数字1和2。
返回值：
- 类型：数值
- 返回值规则：返回日期周数
公式目的：返回特定日期的周数。例如，包含 1 月 1 里的周为该年的第 1 周，其编号为第 1 周。
示例：
2.17 IOSWEEKNUM函数
表达式：ISOWEEKNUM(date)
入参：
- data: 必需。日期是 Ecxel 用于日期和时间计算的日期-时间代码
返回值：
- 类型：数值
- 返回值规则：返回日期周数
示例
主题授权提示：请在后台主题设置-主题授权-激活主题的正版授权，授权购买：RiTheme官网
