日期函数

使用日期函数把内部数据类型转换为相关的日期型或日期/时间型的数据。
对日期的操作可以使用数值函数下的加法函数和减法函数。

涵义

利用[年月日时分秒]所表示的数值合成日期型数据。

返回值

数据类型	注释
日期型	合成的日期型数据。

详细参数

参数名	数据类型	注释
年	数值型	指定年数(1900～9999之间的整数)。不指定则默认为1900年。
月	数值型	指定月数(1～12之间的整数)。不指定则默认为1月。
日	数值型	指定日数(1～31之间的整数)。不指定则默认为1日。
时	数值型	指定时数(0～23之间的整数)。不指定则默认为0时。
分	数值型	指定分数(0～59之间的整数)。不指定则默认为0分。
秒	数值型	指定秒数(0～59之间的整数)。不指定则默认为0秒。

补充说明

• 当上述任何一个参数超出指定范围，函数将异常结束。 (当函数异常结束，通常情况下视表过滤器将完成且视表过滤器执行状态为"异常结束&。 但是您可以使用函数异常结束捕捉函数来继续该处理)
• 当"天数"参数不符合该年度或月度，函数将异常结束。
• 当任何一个参数不为整数(小数部分不为零)，函数将异常结束。
• 当任何一个参数为NULL，该参数被视为未指定。

涵义

从开始日期算起,计算指定年数/月数/日数前(后)的日期。
若使用加法函数向日期型数据中追加数值，通过日期型数据和数值的小数位计算可以得到一个包含时间值的日期型数据。 若日期经过计算函数用于一个日期和天数的加法运算，通过不含时间值的日期与天数的整数计算可以得到一个不含时间值的日期型数据。
虽然每月的天数不同，但日期经过计算函数所指定的经过月数必须为"日历已过月"
同样，指定的经过年数也必须为"日历已过年" 举个例子，若将您的生日指定为开始日期并将年指定为20，那么将得到您20年以后的生日。

返回值

数据类型	注释
日期型	从开始日期算起,几年(月,天)前(后)的日期。 时间值将四舍五入，其格式为00:00:00。

详细参数

参数名	数据类型	注释
开始日期	日期型	指定开始的日期。
种类	数值型	指定以下三个中的任意一个种类(比如年数，月数，日数)。 1: 年数 2: 月数 3: 日数 若此参数未指定，默认将被指定为1: 年。
经过年数/月数/日数	数值型	指定开始日期算起,经过的年数/月数/日数。 正数:开始日期以后。 负数:开始日期以前。

补充说明 1

• the "种类"参数中指定"1: 年数"或"2: 月数"时，获得的日期有可能是日历上不存在的日期。 举个例子，以下日期在日历中不存在：
  2/29/2004下1年的日期为2/29/2005。
  1/31下1月的日期为2/31。
  在这种情况下，将返回该年当月的最后一天或是该月的最后一天。
  举个例子，以下日期将被返回： 2/29/2004下1年的日期将返回2/28/2005。
  1/31/2004下1月的日期将返回2/29/2004。
  

补充说明 2

• 当日期计算超出日期型范围，函数将异常结束。
• 当"种类"参数不在1～3之间，函数将异常结束。
• 当"种类"参数不是一个整数值(小数部分不为零)，函数将异常结束。
• 当"年数/月数/天数"参数不是一个整数值(小数部分不为零),函数将异常结束。
• 当"开始日期"参数为NULL，返回值也将为NULL。
• 当"种类"参数为NULL，函数将异常结束。
• 当"经过年数/月数/日数"参数为NULL，函数将异常结束。

涵义

计算开始日期与结束日期之间的年数/月数/日数。
若使用减法函数对两个日期进行减法运算，将得到这两个日期的差值。此差值包含时间值。然后，才得到一个十进制的经过天数。 若使用日期间隔计算函数来获取经过天数，通过两个日期之间的差值计算得到一个整数的经过天数，其时间值将被四舍五入。
虽然每月的天数不同，但日期间隔计算函数所获得的月一定为"日历已过月"
同样，日期间隔计算函数所获得的年一定为"日历已过年"

返回值

数据类型	注释
数值型	计算开始日期与结束日期之间的年数/月数/日数。 内部数据类型的返回值为数值型。 即使把"种类"参数指定为十进制数类型，数据类型的返回值也不变。

详细参数

参数名	数据类型	注释
开始日期	日期型	指定间隔计算的开始日期。
结束日期	日期型	指定间隔计算的结束日期。
种类	数值型	指定返回值的种类。 1: 年 2: 月 3: 日 当此参数未指定时，将默认指定为1: 年。

补充说明 1

• 若将"种类"参数指定为"3: 日"，返回值将由"结束日期"参数中指定日期减去"开始日期"参数中指定日期的差值来决定。
  举个例子，若"开始日期"为"8/1/2006"，返回结果如下：
  若"结束日期"为"8/2/2006"，则返回值为"1"。
  若"结束日期"为"8/1/2006"，则返回值为"0"。
  若"结束日期"为"7/31/2006"，则返回值为"-1"。
  
• 若将"种类"参数指定为"2: 月"，"结束日期"为"开始日期"之后的第N个月，那么将返回"N"。
  若"结束日期"为"开始日期"之前的第N个月，那么将返回"-(N+1)"或(not "-N")。 举个例子，若"开始日期"为"8/1/2006"，返回结果如下：
  若"结束日期"在"9/1/2006"至"9/30/2006"之间，则返回值为"1"。
  若"结束日期"在"8/1/2006"至"8/31/2006"之间，则返回值为"0"。
  若"结束日期"在"7/1/2006"至"7/31/2006"之间，则返回值为"-1"。
  
• 若将"种类"参数指定为"1: 年"，其返回值的概念与指定为"2: 月"时相同 举个例子，若"开始日期"为"8/1/2006"，返回结果如下：
  若"结束日期"在"8/1/2007"至"7/31/2008"之间，则返回值为"1"。
  若"结束日期"在"8/1/2006"至"7/31/2007"之间，则返回值为"0"。
  若"结束日期"在"8/1/2005"至"7/31/2006"之间，则返回值为"-1"。
  
• 要注意在减法函数中第一个参数和第二个参数的位置是相反的。 在减法函数中把第一个参数值减去第二个参数值。 而在日期间隔计算函数中第一个参数表示开始时间，第二个参数表示结束时间，例:DataDiff(20100410, 20100413,3),返回值为-3.是从第一个参数减去第二个参数。

补充说明 2

• 当"开始日期"参数或"结束日期"参数中含有时间值(时间值的对应格式不为00:00:00)，时间值将被忽略。
• 当"种类"参数不在1～3之间，函数将异常结束。
• 当"种类"参数不是一个整数值(小数部分不为零)，函数将异常结束。
• 当"开始日期"参数或"结束日期"参数为NULL，返回值也将为NULL。
• 当"种类"参数为NULL，函数将异常结束。

涵义

指定的开始日期起,几年(月)前(后)相应月的最终日期。

返回值

数据类型	注释
日期型	返回相应月的最终日期。 时间值将被四舍五入且格式为00:00:00。

详细参数

参数名	数据类型	注释
开始日期	日期型	指定月的最终日取得函数的开始日期。
年(月)种类	数值型	指定"年(月)数"参数的种类。 1 : 年 2 : 月 若"年(月)种类"未被指定，则默认被指定为"1 : Year"。
年(月)数	数值型	从开始日期起,要计算的年(月)数。 正数:开始日期以后。 负数:开始日期以前。

补充说明

• 当日期计算超出日期型范围，函数将异常结束。(日期型范围的有关详情请参照内部数据类型)
• 当"年(月)种类"参数不为1或2，函数将异常结束。
• 当"年(月)种类"参数不是一个整数值(小数部分不为零)，函数将异常结束。
• 当"年(月)数"参数不是一个整数值(小数部分不为零)，函数将异常结束。
• 当"开始日期"参数为NULL，返回值也将为NULL。
• 当"年(月)种类"参数为NULL，函数将异常结束。
• 当"年(月)数"参数为NULL，函数将异常结束。

举例 1 : 获取19930101123456后1个月的最后1天(1/1/1993 12:34:56对应的日期常量)。

开始日期	年(月)种类	年(月)数	结果
19930101123456	2	1	19930228000000(2/28/1993对应的日期的值)。

举例 2 : 获取19930101123456前1年该月的最后1天(1/1/1993 12:34:56对应的日期常量)。

开始日期	年(月)种类	年(月)数	结果
19930101123456	1	-1	19920131000000 (1/31/1992对应的日期的值)

涵义

指定的开始日期起,几年(月)前(后)相应月的第一天。

返回值

数据类型	注释
日期型	返回相应月的第一天。 时间值将被四舍五入且格式为00:00:00。

详细参数

参数名	数据类型	注释
开始日期	日期型	指定月的第一天取得函数的开始日期。
种类	数值型	指定"年(月)数"参数的种类。 1 : 年 2 : 月 若"种类"未被指定，则默认被指定为"1 : Year"。
年(月)数	数值型	从开始日期起,要计算的年(月)数。 正数:开始日期以后。 负数:开始日期以前。

补充说明

• 当日期计算超出日期型范围，函数将异常结束。(日期型范围的有关详情请参照内部数据类型)
• 当"种类"参数不为1或2，函数将异常结束。
• 当"种类"参数不是一个整数值(小数部分不为零)，函数将异常结束。
• 当"年(月)数"参数不是一个整数值(小数部分不为零)，函数将异常结束。
• 当"开始日期"参数为NULL，返回值也将为NULL。
• 当"种类"参数为NULL，函数将异常结束。
• 当"年(月)数"参数为NULL，函数将异常结束。

举例 1 : 获取19930131123456后1个月的第1天(1/31/1993 12:34:56对应的日期常量)。

开始日期	种类	年(月)数	结果
19930131123456	2	1	19930201000000(2/1/1993对应的日期的值)。

举例 2 : 获取19930131123456后1年该月的第1天(1/31/1993 12:34:56对应的日期常量)。

开始日期	种类	年(月)数	结果
19930131123456	1	-1	19920101000000(1/1/1992对应的日期的值)。