1. 概述
注：一些常用的日期函数写法详情参见：常见日期函数
1.1 应用场景
日期函数允许对数据源中的日期进行操作。
例如，可能有一个各个值为年、月、日的日期字段 (2004-04-15)。可以使用日期函数（例如 DATEINMONTH 函数）依据这些现有值创建新的日期值。
例如，可以查找任何现有日期值的「当月第一天」。
在单元格中输入：=DATEINMONTH("2004-04-15",1)，如下图所示：
如果原始日期为「2004-04-15」，则使用上面的计算会返回「2004-04-01」，即当前时间对应月份的第一天，如下图所示：
1.2 注意事项
函数中以日期作为参数因子的，其中日期的形式都必须是 yyyy/mm/dd，而且必须用英文环境下双引号(" ")引用。
若日期函数不合法，则会用当前时间进行计算。
若在文本控件中使用日期函数显示 yyyy/mm/dd 格式，需使用 Format 函数 进行转换。
2. DATE-某一特定日期
DATE(year,month,day)：返回一个表示某一特定日期的系列数。
Year：代表年，可为一到四位数。
Month：代表月份。
若 1<=month<= 12，则函数把参数值作为月。
若 month>12，则函数从年的一月份开始往上累加。例如：DATE(2000,25,2) 等于 2002 年 1 月 2 日的系列数。
Day：代表日。
若日期小于等于某指定月的天数，则函数将此参数值作为日。
若日期大于某指定月的天数，则函数从指定月份的第一天开始往上累加。若日期大于两个或多个月的总天数，则函数把减去两个月或多个月的余数加到第三或第四个月上，依此类推。
如：DATE(2000,3,35)等于 2000 年 4 月 4 日的系列数。
示例：
DATE(1978, 9, 19)等于 1978 年 9 月 19 日。
DATE(1211, 12, 1)等于 1211 年 12 月 1 日。
其中月和日为 1 到 9 之间的数字时，不需要在前面加上 0 而直接写数字如 DATE(2011, 2, 1)即可。
3. DATEDELTA-某日期后几天
DATEDELTA(date, deltadays)：返回一个日期——date 后 deltadays 的日期。deltaDays 可以为正值，负值，零。
示例：
DATEDELTA("2008-08-08", -10)等于 2008-07-29。
DATEDELTA("2008-08-08", 10)等于 2008-08-18。
4. DATEDIF-时间差天数
DATEDIF(start_date,end_date,unit)：返回两个指定日期间的天数、月数或年数。
Start_date：代表所指定时间段的初始日期。
End_date：代表所指定时间段的终止日期。
Unit：函数返回信息的类型。
若 unit=“Y”，则 DATEDIF 返回指定时间段的年差数。
若 unit=“M”，则 DATEDIF 返回指定时间段的月差数。
若 unit=“D”，则 DATEDIF 返回指定时间段的日差数。
若 unit=“MD”，则 DATEDIF 忽略年和月，返回指定时间段的日差数。
若 unit=“YM”，则 DATEDIF 忽略年和日，返回指定时间段的月差数。
若 unit=“YD”，则 DATEDIF 忽略年，返回指定时间段的日差数。
示例：
DATEDIF("2001/2/28","2004/3/20","Y") 等于 3，即在 2001 年 2 月 28 日与 2004 年 3 月 20 日之间有 3 个整年。
DATEDIF("2001/2/28","2004/3/20","M") 等于 36，即在 2001 年 2 月 28 日与 2004 年 3 月 20 日之间有 36 个整月。
DATEDIF("2001/2/28","2004/3/20","D") 等于 1116，即在 2001 年 2 月 28 日与 2004 年 3 月 20 日之间有 1116 个整天。
DATEDIF("2001/2/28","2004/3/20","MD") 等于 8，即忽略月和年后，2001 年 2 月 28 日与 2004 年 3 月 20 日的差为 8 天。
DATEDIF("2001/1/28","2004/3/20","YM") 等于 2，即忽略日和年后，2001 年 1 月 28 日与 2004 年 3 月 20 日的差为 2 个月。
DATEDIF("2001/2/28","2004/3/20","YD") 等于 21，即忽略年后，2001 年 2 月 28 日与 2004 年 3 月 20 日的差为 21 天。
4. DATEINMONTH
DATEINMONTH(date, number)：函数返回在某一个月当中第几天的日期。
示例：
DATEINMONTH("2008-08-08", 20) 等于 2008-08-20。
5. DATEINQUARTER-某一个季度当中第几天的日期
DATEINQUARTER(date, number)：函数返回在某一个季度当中第几天的日期。
示例：
DATEINQUARTER("2009-05-05", 20) 等于 2009-04-20。
6. DATEINWEEK
DATEINWEEK(date, number)：函数返回在某一个星期当中第几天的日期。
示例：
dateInWeek("2008-08-28", 2)等于 2008-08-26。
7. DATEINYEAR
DATEINYEAR(date, number)：函数返回在某一年当中第几天的日期。
示例：
DATEINYEAR("2008/12/03", 300)等于 2008-10-26。
8. DATESUBDATE——时间差
DATESUBDATE(date1, date2, op)：返回两个日期之间的时间差。
op 表示返回的时间单位：
"s"，以秒为单位。
"m"，以分钟为单位。
"h"，以小时为单位。
"d"，以天为单位。
"w"，以周为单位。
示例：
DATESUBDATE("2008-08-08", "2008-06-06","h") 等于 1512。
9. DATETONUMBER
DATETONUMBER(date)：返回自 1970 年 1月 1日 00:00:00 GMT 经过的毫秒数。
示例：
DATETONUMBER("2008-08-08") 等于 1218124800000。
10. DAY
DAY(serial_number)：返回日期中的日。DAY 是介于 1 和 31 之间的一个数。
Serial_number：含有所求的年的日期，参数为空时默认为当天日期。
注： FineReport 将日期保存为系列数，一个系列数代表一个与之匹配的日期，以方便用户对日期进行数值式计算。
在 1900 年日期系统中，FineReport 电子表格将 1900 年 1 月 1 日保存为系列数 2，将 1900 年 1 月 2 日保存为系列数 3，将 1900 年 1 月 3 日保存为系列数 4……依此类推。如在1900 年日期系统，1998 年 1 月 1 日存为系列数 35796。
示例：
DAY("2000/1/1") 等于 1。
DAY("2006/05/05") 等于 5。
DAY("1997/04/20") 等于 20。
DAY(35796) 等于1。
11. DAYS360
DAYS360(start_date,end_date,method)：按照一年 360 天的算法（每个月以 30 天计，一年共计 12 个月），返回两日期间相差的天数，这在会计计算中将会用到的。如果财务系统是基于一年 12 个月，每月 30 天，可用此函数帮助计算支付款项。
Start_date 和 end_date ：是用于计算期间天数的起止日期。
Method：它指定了在计算中是采用欧洲方法还是美国方法。
Method 定义：FALSE 或忽略 美国方法 (NASD)。如果起始日期是一个月的 31 号，则等于同月的 30 号。如果终止日期是一个月的 31 号，并且起始日期早于 30 号，则终止日期等于下一个月的 1 号，否则，终止日期等于本月的 30 号。
TRUE 欧洲方法。无论是起始日期还是终止日期为一个月的 31号，都将等于本月的 30号。
注： FineReport 将日期保存为系列数，一个系列数代表一个与之匹配的日期，以方便用户对日期进行数值式计算。
在 1900 年日期系统中，FineReport 电子表格将 1900 年 1 月 1 日保存为系列数 2，将 1900 年 1 月 2 日保存为系列数 3，将 1900 年 1 月 3 日保存为系列数 4……依此类推。如在1900 年日期系统，1998 年 1 月 1 日存为系列数 35796。
示例：
DAYS360("1998/1/30", "1998/2/1") 等于 1
12. DAYSOFMONTH——月份天数
DAYSOFMONTH(date)：返回从 1900 年 1 月后某年某月包含的天数。
示例：
DAYSOFMONTH("1900-02-01") 等于 28
DAYSOFMONTH("2008/04/04") 等于 30
13. DAYSOFQUARTER——季度天数
DAYSOFQUARTER(date)：返回从 1900 年 1 月后某年某季度的天数。
示例：
DAYSOFQUARTER("2009-02-01") 等于 90
DAYSOFQUARTER("2009/05/05") 等于 91
14. DAYSOFYEAR——年份天数
DAYSOFYEAR(year)：返回 1900 年以后某年包含的天数。
示例：
DAYSOFYEAR(2008) 等于 366
15. DAYVALUE
DAYVALUE(date)：此函数可用来把一个日期转化为一个系列数，返回值为一个数字。
转化原理：1900 年 1 月 1 日至 date 日期所经历的天数，一个日期匹配一个系列数，方便用户对日期进行数值式计算。
| 参数 | 含义 | 参数格式 |
|---|---|---|
| date | 需要转化的日期 | 日期格式或代表日期的文本格式，例如“2000/2/28” 数字格式：整数，例如 1000001 |
date 为整数时，date 大于1000000，认为是 unix 时间；date 小于或等于1000000，认为是距 1900 年 1 月 1 日的天数。unix 时间是指从 1970 年 1 月 1 日 开始所经过的秒数，不考虑闰秒。
示例：
DAYVALUE("2000/1/1") 等于 36525。
DAYVALUE( 1000001) 等于 25568 。
注：如果 date 参数格式不规范，则返回1900年 1 月 1 日至当前日期所经历的天数。
例如：若今天为 2020/09/01，DAYVALUE("2008/02/") 等于 44074，DAYVALUE("0.877766")等于 44074
16. HOUR
HOUR(serial_number)：返回某一指定时间的小时数。函数指定 HOUR 为 0（0:00）到 23（23:00)之间的一个整数。
Serial_number：包含所求小时的时间。
示例：
HOUR("11:32:40") 等于 11。
17. MINUTE
MINUTE(serial_number)：返回某一指定时间的分钟数，其值是介于 0 与 59 之间的一个整数。
Serial_number：包含所求分钟数的时间。
示例：
MINUTE("15:36:25") 等于 36。
18. MONTH
MONTH(serial_number)：返回日期中的月，月是介于 1 和 12 之间的一个数。
Serial_number：含有所求的月的日期，参数为空时默认为当天日期。
注： FineReport 将日期保存为系列数，一个系列数代表一个与之匹配的日期，以方便用户对日期进行数值式计算。
在 1900 年日期系统中，FineReport 电子表格将 1900 年 1 月 1 日保存为系列数 2，将 1900 年 1 月 2 日保存为系列数 3， 将 1900 年 1 月 3 日保存为系列数 4……依此类推。
如：在 1900 年日期系统，1998 年 1 月 1 日存为系列数 35796。
示例：
MONTH("2004/5/5") 等于 5。
MONTH(35796) 等于 1。
19. MONTHDELTA——日期后几个月日期
MONTHDELTA(date,delta)：返回指定日期 date 后 delta 个月的日期。
示例：
MONTHDELTA("2008-08-08", 4) 等于 2008-12-08。
20. NOW——当前时间
NOW()：获取当前时间。
示例：
如果系统时间是 2017-06-27 14:58:06， 则：
NOW()等于 2017-06-27 14:58:06。
21. SECOND
SECOND(s erial_number)：返回某一指定时间的秒数，其值是介于 0 与 59 之间的一个整数。
Serial_number：包含所求秒数的时间。
示例：
SECOND("15:36:25") 等于 25。
SECOND("15:36:25", "HH:mm:ss") 等于 25。
22. TIME
TIME(hour,minute,second)：返回代表指定时间的小数。介于 0:00:00（12:00:00 A.M.）与 23:59:59（11:59:59 P.M.）之间的时间可返回 0 到 0.99999999 之间的对应数值。
TIME(19,43,24)等于 7:43 PM
Hour：介于 0 到 23 之间的数。
Minute：介于 0 到 59 之间的数。
Second：介于 0 到 59 之间的数。
示例：
TIME(14,40,0) 等于 2:40 PM。
23. TODATE——日期类型转换
TODATE()：函数可以将各种日期形式的参数转换为日期类型。
它有三种参数的形式：
1）参数是一个日期型的参数，那么直接将这个参数返回。
示例：
TODATE(DATE(2007,12,12))返回 2007-12-12 组成的日期。
2）参数是以从1970 年 1 月 1 日 0 时 0 分0 秒开始的毫秒数，返回对应的时间。
示例：
TODATE("1023542354746")返回 2002-6-8 21:19:14。
3）参数是日期格式的文本，那么返回这个文本对应的日期。
示例：
TODATE("2007/10/15") 返回 2007-10-15 组成的日期。
TODATE("2007-6-8")返回 2007-6-8 组成的日期。
4）有两个参数，第一个参数是一个日期格式的文本，第二个参数是用来解析日期的格式。
示例：
TODATE("1/15/07","MM/dd/yy")返回 2007-01-15 组成的日期.
注：此处的格式中月份必须大写 MM，年份小写：yy(不可以为yyyy)。天份小写：dd
24. TODAY——当前日期
TODAY()：是获取当前的日期。
示例：
如果系统日期是 2011-06-20，则：
TODAY()等于 2011-06-20。
25. WEEKDAY——返回星期数
WEEKDAY(Serial_number)：获取日期并返回星期数。返回值为介于0到6之间的某一整数，分别代表星期中的某一天（从星期日到星期六）。
Serial_number：输入的日期。
注： FineReport 将日期保存为系列数，一个系列数代表一个与之匹配的日期，以方便用户对日期进行数值式计算。
在 1900 年日期系统中，FineReport 电子表格将 1900 年 1 月 1 日保存为系列数 2，将 1900 年 1 月 2 日保存为系列数 3，将 1900 年 1 月 3 日保存为系列数4……依此类推。如在1900 年日期系统，1998 年 1 月 1 日存为系列数 35796。
示例：
WEEKDAY("2005/9/10")等于 6（星期六）。
WEEKDAY("2005/9/11")等于 0（星期日）。
WEEKDAY(35796)等于 4（星期四）。
26. WEEK——返回周数
1）函数介绍
WEEK(serial_num)：返回一个代表一年中的第几周的数字。其中 Serial_num 为输入的日期。
2）函数逻辑
年内第一周开始于第一个星期日所对应的日期，此外周的范围为星期日到星期六。
FineReport 将日期保存为系列数，一个系列数代表一个与之匹配的日期，以方便用户对日期进行数值式计算。
在 1900 年日期系统中，FineReport 将 1900/1/1 保存为系列数2，将 1900/1/2 保存为系列数 3，……依此类推。如 1998/1/1 存为系列数 35796。
3）示例：
WEEK("2005/1/1") 等于 52（本年第一个星期日前的日期，都算作上一年最后一周的日期）
WEEK("2005/1/6") 等于 1（本年第一个星期日后的日期，从本年开始算起）
WEEK(35796) 等于 52（系列数对应到具体日期，然后转化为第几周）
4）参数修改逻辑
WEEK(serial_num,"F1")：采用 Excel 的逻辑，把年内第一个星期日前的日期算作第一周
WEEK(serial_num,"F7") 或 WEEK(serial_num)：采用 FineReport 默认逻辑，年内第一个星期日前的日期算作上一年最后一周的日期，本年第一周开始于第一个星期日
例如：
WEEK("2019/1/5","F1") 等于 1
WEEK("2019/1/5","F7") 等于 52
WEEK("2019/1/6","F1") 等于 2
WEEK("2019/1/6","F7") 等于 1
27. WEEKDATE
WEEKDATE(year,month,weekOfMonth,dayOfWeek)：返回指定年月的指定周的周几的具体日期。
1）默认周开始于星期日时，此时系统中周的范围为星期日到星期六。
示例：
WEEKDATE(2009,10,2,1) 返回的是 2009 年的 10 月的第二个周的第一天即星期天的日期，返回的是 2009-10-04；
最后一个参数 dayOfWeek为-1 时，表示这个周的最后一天。
示例：
WEEKDATE(2009,12,1,-1) 返回的是 2009 年的 12 月的第一个周的最后一天即星期六的日期，返回的是 2009-12-05。
2）当设置 周开始于星期一 时，此时系统中周的范围为星期一到星期日。
28. YEAR——年
YEAR(serial_number)：返回日期中的年。Year是介于1900和9999之间的一个数。
Serial_number：含有所求的年的日期，参数为空时默认为当天日期。
注： FineReport 将日期保存为系列数，一个系列数代表一个与之匹配的日期，以方便用户对日期进行数值式计算。
在 1900 年日期系统中，FineReport 电子表格将 1900 年 1 月 1 日保存为系列数 2，将 1900 年 1 月 2日保存为系列数 3，将 1900 年 1 月 3 日保存为系列数 4……依此类推。
如：在 1900 年日期系统，1998 年 1 月 1 日存为系列数 35796。
示例：
YEAR("2000/1/1") 等于 2000。
YEAR("2006/05/05") 等于 2006。
YEAR("1997/04/20") 等于 1997。
YEAR(35796) 等于 1998。
29. YEARDELTA
YEARDELTA(date, delta)：返回指定日期后delta年的日期。
示例：
YEARDELTA("2008-10-10",10) 等于 2018-10-10。
30. LUNAR
LUNAR(year,day,month)：返回当前日期对应的农历时间。year,month,day：分别对应年月日。
示例：
如果需要查询 2011 年 7 月 21 日对应的农历时间，则：
LUNAR(2011,7,21) 结果将显示为：辛卯年六月廿一。
LUNAR(2001,7,21) 结果显示：辛巳年六月初一 。
注：本公式支持的时间段为 1900-2049 年。