- 公式使用说明，以及注意事项">注：请先阅读公式使用说明，以及注意事项
- 日期对象（DATE）
- 日期对象转时间戳（TIMESTAMP）
- 时间占一天的比例（TIME）
- 今天（TODAY）
- 当前时间（NOW）
- 服务器时间（SYSTEM）
- 日期的天数（DAY）
- 日期的月份（MONTH）
- 日期的年份（YEAR）
- 时间的小时数（HOUR）
- 时间的分钟数（MINUTE）
- 时间的秒数（SECOND）
- 日期之间的天数（DAYS）
- 日期之间的天数（DAYS360）
- 日期加减天数（DATEDELTA）
- 周数（WEEKNUM）
- 周数（ISOWEEKNUM）
- 日期时分秒置零（DAYBEGIN）
- 日期时分秒最大（DAYEND）
- 日期年初日（YEARBEGIN）
- 日期年终日（YEAREND）
- ">
- 日期区间组件计算相隔天数（CASCADEDATEINTERVAL）
- 日期区间组件计算相隔天数（第二版）（CASCADEDATEINTERVALV2）（即将上线）
- 时间比较（TIMECOMPARE）
注：请先阅读公式使用说明，以及注意事项
日期对象（DATE）
- DATE(timestamp)
将时间戳转换为日期对象。 用来将日期组件的时间戳转为日期对象进行日期公式运算
• timestamp: 必需。时间戳。
示例：
下面介绍一下支持的占位符：
- G 年代标志符
- y 年
- M 月
- d 日
- h 时 在上午或下午 (1~12)
- H 时 在一天中 (0~23)
- m 分
- s 秒
- S 毫秒
- E 星期
- D 一年中的第几天
- F 一月中第几个星期几
- w 一年中第几个星期
- W 一月中第几个星期
- a 上午 / 下午 标记符
- k 时 在一天中 (1~24)
- K 时 在上午或下午 (0~11)
- z 时区
示例1：
使用模式串“yyyy年MM月dd日 HH:mm:ss:S E D F w W z ”来格式化当前时间作为文本框孔家“格式化日期”的默认值，公式内容定义如下：
页面展示如下：
- DATE(year,month,day,hour,minute,second)
将年月日时分秒转换为日期对象。
• year: 必需。年份。
• month: 必需。月份。
• day: 必需。天数。
• hour: 可选。小时。
• minute: 可选。分钟。
• second: 可选。秒
示例：
日期对象转时间戳（TIMESTAMP）
TIMESTAMP(date)
将日期对象转换成时间戳,主要用来将日期公式计算出的日期对象转为时间戳，给日期组件赋值
示例：
时间占一天的比例（TIME）
TIME(hour, minute, second)
返回特定时间的十进制数字。时间值为日期值的一部分，并用十进制数表示
示例：
今天（TODAY）
TODAY()
返回今天。
示例：
当前时间（NOW）
NOW()
返回当前时间。与TODAY函数相同。
示例：
服务器时间（SYSTEM）
SYSTIME()
返回当前服务器时间。
即使客户端的时间被人为调整了，SYSTIME函数不受影响，获取的仍然是服务器时间。例如签到、打卡等场景下，可避免调整时间作弊的情况。
示例：
日期的天数（DAY）
DAY(date)
返回某日期的天数。 天数是介于 1 到 31 之间的整数
示例：
日期的月份（MONTH）
MONTH(date)
返回某日期的月份。 月份是介于 1 到 12 之间的整数
示例：
日期的年份（YEAR）
YEAR(date)
返回某日期的年份。
示例：
时间的小时数（HOUR）
HOUR(date)
返回某日期的小时数
示例：
时间的分钟数（MINUTE）
MINUTE(date)
返回某日期的分钟数。
示例：
时间的秒数（SECOND）
SECOND(date)
返回某日期的秒数
示例：
日期之间的天数（DAYS）
DAYS(enddate, startdate)
返回两个日期之间的天数。
• end_date: 必需。结束日期。
• start_date: 必需。起始日期。
示例：
日期之间的天数（DAYS360）
DAYS360(enddate, startdate, method)
按照一年 360 天的算法（每个月以 30 天计，一年共计 12 个月），DAYS360 函数返回两个日期间相差的天数，这在一些会计计算中将会用到。 如果财会系统是基于一年 12 个月，每月 30 天，可使用此函数帮助计算支付款项。
• end_date: 必需。结束日期。
• start_date: 必需。起始日期。
• method: 可选。用于指定在计算中是采用美国方法还是欧洲方法。不填或false表示是美国方法，true表示是欧洲方法。
示例：
日期加减天数（DATEDELTA）
DATEDELTA(date, deltadays)
将指定日期加/减指定天数。
• date: 必需。初始日期。
• deltadays: 必需。需要加减的天数。正数为增加，负数为减少。
示例：
周数（WEEKNUM）
WEEKNUM(date, return_type)
返回特定日期的周数。例如，包含1月1里的周为该年的第1周，其编号为第1周。
• data: 必需。指定日期。代表一周中的日期。应使用DATE函数输入日期，或者将日期作为其他公式或函数的结果输入
• return_type: 可选。一数字，确定星期从哪一天开始。默认值为1。 1周日开始，2周一开始
示例：
周数（ISOWEEKNUM）
ISOWEEKNUM(date)
返回给定日期在全年中的ISO周数。
• data: 必需。日期是Ecxel用于日期和时间计算的日期-时间代码。
示例：
日期时分秒置零（DAYBEGIN）
DAYBEGIN(日期选择框))
将指定日期组件的时间戳的时分秒置零。
示例：
日期时分秒最大（DAYEND）
DAYEND(日期选择框))
将指定日期组件的时间戳的时分秒设置成最大。
示例：
日期年初日（YEARBEGIN）
格式：YEARBEGIN(日期选择框)
含义：获取日期所在年份的首个日期。
示例1：
将【单行文本框】控件的默认值使用公式编辑编写为：
TEXT(DATE(YEARBEGIN(日期))，”yyyy-MM-dd HH:mm:ss”)
当【日期】控件的时间选择为【2020-07-08】时，单行输入框中的内容将联动展示为【2020-01-01 00:00:00】
日期年终日（YEAREND）
格式：YEAREND(日期选择框)
含义：获取日期所在年份的最后一个日期。
示例1：
将【单行文本框】控件的默认值使用公式编辑编写为：
TEXT(DATE(YEAREND(日期))，”yyyy-MM-dd HH:mm:ss”)
当【日期】控件的时间选择为【2020-07-08】时，单行输入框中的内容将联动展示为【2020-12-31 00:00:00】
日期区间组件计算相隔天数（CASCADEDATEINTERVAL）
格式：CASCADEDATEINTERVAL(日期区间选择框)
含义：计算日期区间选择框组件开始和结束日期的相隔天数。
示例2：
日期区间组件计算相隔天数（第二版）（CASCADEDATEINTERVALV2）（即将上线）
函数名：
CASCADEDATEINTERVALV2
入参
| 参数名 | 是否必填 | 备注 |
|---|---|---|
| 组件id | 是 | 日期区间组件的id |
| 单位 | 是 | 可选值：d表示天，h表示小时，s表示秒。 |
| 偏移量 | 是 | 以单位长度作为偏移量，可以为正数或者负数。 |
返回值：
最多保留2位有效数字，返回值的单位含义与用户在入参中指定的单位含义保持一致。
示例1：
日期区间，选择了日期格式为年月日，开始时间选择为2020年7月9日，结束时间选择为2020年7月9日，
编写公式CascadeDateIntervalV2FunEvaluator(组件id,”d”,1)
则公式返回的结果为1
示例2：
日期区间，选择了日期格式为年月日小时分钟，开始时间选择为2020年7月9日上午8:00，结束时间选择为2020年7月9日下午17:30，
编写公式CascadeDateIntervalV2FunEvaluator(组件id,”h”,0)
则公式返回的结果为9.5
时间比较（TIMECOMPARE）
TIMECOMPARE(日期选择框,日期选择框)
比较两个时间的大小。
示例：
若有收获，就点个赞吧
0 人点赞
