BirtDateTime 类提供了一些函数,用于确定两个日期或时间之间的时间量,加上或减去时间范围以及获取一个日期的某些部分。因为日期范围全是数字,所以应用程序可对它们进行正常的数学运算:加减乘除等等。此类是静态类。应用程序无法创建此类的实例。
此函数将返回一个新日期,即,将某个日期加上给定天数之后所得到的新日期。要加上的天数可以为负数。在这种情况下,获得的结果相当于从该日期减去所给定的星期数。
语法
参数
date
Date 对象。用于表示起始日期的日期对象。
n
Number 对象。该日期要加上的天数。小数将视为整数,并向下舍入到最接近的整数。
返回
Date 对象。将起始日期加上所指定的天数而得到的新日期。
示例
以下示例将对特定日期加上所指定的天数:
以下示例将对 InvoiceDate 字段中的每个日期值加上 15 天:
此函数将返回一个新日期,即,将某个日期加上给定小时数之后所得到的新日期。要加上的小时数可以为负数。在这种情况下,获得的结果相当于从该日期减去所给定的星期数。
语法
参数
date
用于表示起始日期的日期对象。如果起始日期没有时间值,那么此函数将假定时间为午夜(00:00:00)。
n
Number 对象。该日期要加上的小时数。
返回
Date 对象。将起始日期加上所指定的小时数而得到的新日期。
示例
以下示例将对特定日期和时间加上所指定的小时数:
以下示例将对 StartTime 字段中的每个日期值加上 36 小时:
此函数将返回一个新日期,即,将某个日期加上给定分钟数之后所得到的新日期。要加上的分钟数可以为负数。在这种情况下,获得的结果相当于从该日期减去所给定的星期数。
语法
参数
date
用于表示起始日期的日期对象。如果起始日期没有时间值,那么此函数将假定时间为午夜(00:00:00)。
n
Number 对象。该日期要加上的分钟数。
返回
Date 对象。将起始日期加上所指定的分钟数而得到的新日期。
示例
以下示例将对特定日期和时间加上所指定的分钟数:
以下示例将对 StartTime 字段中的每个日期值加上 15 分钟:
此函数将返回一个新日期,即,将某个日期加上给定分钟数之后所得到的新日期。要加上的月数可以为负数。在这种情况下,获得的结果相当于从该日期减去所给定的星期数。
此函数始终将返回一个有效日期。必要时,可将获得日期的“日”部分向下调整为所获得年份、月份中的最后一天。例如,如果将 2008 年 1 月 31 日加上一个月,那么 addMonth( ) 将返回“2008 年 2 月 29 日”而不是“2008 年 2 月 31 日”(因为 2008 年是闰年)。
语法
参数
date
Date 对象。用于表示起始日期的日期对象。
n
Number 对象。该日期要加上的月数。小数将视为整数,并向下舍入。
返回
Date 对象。将起始日期加上所指定的月份数而得到的新日期。
示例
以下示例将对特定日期加上所指定的月数:
以下示例将对 InvoiceDate 字段中的每个日期值加上 10 个月:
此函数将返回一个新日期,即,将某个日期加上给定季度数之后所得到的新日期。一个季度就是三个月。例如,如果您对“Sep 10, 2008”加上两个季度,那么此函数将返回“Mar 10, 2009”。要加上的季度数可以为负数。在这种情况下,获得的结果相当于从该日期减去所给定的星期数。
语法
参数
date
用于表示起始日期的日期对象。
n
Number 对象。该日期要加上的季度数。
返回
Date 对象。将起始日期加上所指定的季度数而得到的新日期。
示例
以下示例将对特定日期加上所指定的季度数:
以下示例将对 ForecastClosing 字段中的每个日期值加上两个季度:
此函数将返回一个新日期,即,将某个日期加上给定秒数之后所得到的新日期。要加上的秒数可以为负数。在这种情况下,获得的结果相当于从该日期减去所给定的星期数。
语法
参数
date
用于表示起始日期的日期对象。如果起始日期没有时间值,那么此函数将假定时间为午夜(00:00:00)。
n
Number 对象。该日期要加上的秒数。
返回
Date 对象。将起始日期加上所指定的秒数而得到的结果。
示例
以下示例将对特定日期和时间加上所指定的秒数:
以下示例将对 StartTime 字段中的每个日期值加上 6000 秒:
此函数将返回一个新日期,即,将某个日期加上给定星期数之后所得到的新日期。要加上的星期数可以为负数。在这种情况下,获得的结果相当于从该日期减去所给定的星期数。
语法
参数
date
用于表示起始日期的日期对象。
n
Number 对象。该日期要加上的星期数。
返回
Date 对象。将起始日期加上所指定的星期数而得到的新日期。
示例
以下示例将对特定日期加上所指定的星期数:
以下示例将对 InvoiceDate 字段中的每个日期值加上两个星期:
此函数将返回一个新日期,即,将某个日期加上给定年数之后所得到的新日期。要加上的年数可以为负数。在这种情况下,获得的结果相当于从该日期减去所给定的星期数。
语法
参数
date
用于表示起始日期的日期对象。
n
Number 对象。该日期要加上的年数。小数将视为整数,并向下舍入。
返回
将起始日期加上所指定的年数而得到的新日期。
示例
以下示例将对特定日期加上所指定的年数:
以下示例将对 HireDate 字段中的每个日期值加上 5 年:
此函数将返回 1 到 31 之间的一个数,用来表示给定日期的“日”。例如,如果日期为 2009-01-19,那么此函数将返回 19。
语法
参数
date
Date 对象。要从其中获取特定日的日期对象。
返回
用来表示给定日期的“日”的整数。
示例
以下示例将返回 ShipDate 字段中每个值的“日”:
以下示例将返回当前日期的“日”:
此函数将返回两个日期之间相差的天数。通过用第二个日期的“日”值减去第一个日期的“日”值,就可以计算出相差的天数。例如,如果第一个日期为 2008-12-30 23:59:59,第二个日期为 2008-12-31 00:00:00,那么此函数将返回 1 天,尽管这两个日期之间只相差 1 秒钟。
语法
参数
date1
用于表示时间范围开始的日期对象。
date2
用于表示时间范围结束的日期对象。
返回
整数。两个日期之间相差的天数。
示例
以下示例将返回特定日期之间相差的天数:
以下示例将返回从当前日期到 2009 年年末将经过的天数:
以下示例将返回 InvoiceDate 和 PaymentDate 字段中的值之间相差的天数:
此函数将返回两个日期之间相差的小时数。通过用第二个日期的“小时”值减去第一个日期的“小时”值,就可以计算出相差的小时数。例如,如果第一个日期为 2009-01-31 1:30:00,第二个日期为 2009-01-31 2:00:00,那么此函数将返回 1 小时,尽管这两个日期之间只相差 30 分钟。如果某个日期没有时间值,那么此函数将假定时间为午夜(00:00:00)。
语法
参数
date1
用于表示时间范围开始的日期对象。
date2
用于表示时间范围结束的日期对象。
返回
整数。两个日期之间相差的小时数。
示例
以下示例将返回特定日期之间相差的小时数:
以下示例将返回从当前日期和时间到 2009 年年末将经过的小时数:
以下示例将返回 StartTime 和 FinishTime 字段中的值之间相差的小时数:
此函数将返回两个日期之间相差的分钟数。通过用第二个日期的“分钟”值减去第一个日期的“分钟”值,就可以计算出相差的分钟数。例如,如果第一个日期为 2009-01-31 1:30:59,第二个日期为 2009-01-31 1:31:00,那么此函数将返回 1 分钟,尽管这两个日期之间只相差 1 秒钟。如果某个日期没有时间值,那么此函数将假定时间为午夜(00:00:00)。
语法
参数
date1
用于表示时间范围开始的日期对象。
date2
用于表示时间范围结束的日期对象。
返回
整数。两个日期之间相差的分钟数。
示例
以下示例将返回特定日期之间相差的分钟数:
以下示例将返回从当前日期和时间到 2010 年开始将经过的分钟数:
以下示例将返回 StartTime 和 FinishTime 字段中的值之间相差的分钟数:
此函数将返回两个日期之间相差的月数。通过用第二个日期的“月份”值减去第一个日期的“月份”值,就可以计算出相差的月数。例如,如果第一个日期为 2009-01-31,第二个日期为 2009-02-01,那么此函数将返回 1 个月,尽管这两个日期之间只相差 1 天。
语法
参数
date1
用于表示时间范围开始的日期对象。
date2
用于表示时间范围结束的日期对象。
返回
整数。两个日期之间相差的月份数。
示例
以下示例将返回特定日期之间相差的月数:
以下示例将返回从当前日期到 2010 年开始将经过的月份数:
以下示例将返回 ProjectStart 和 ProjectComplete 字段中的值之间相差的月份数:
此函数将返回两个日期之间相差的季度数。通过用第二个日期的“月份”值减去第一个日期的“月份”值,就可以计算出相差的季度。相差 3 个月就是一个季度。例如,如果第一个日期为 2009-01-31,第二个日期为 2009-07-01,那么此函数将返回 2。如果第一个日期为 2009-01-01,第二个日期为 2009-09-30,那么此函数也将返回 2。
语法
参数
date1
用于表示时间范围开始的日期对象。
date2
用于表示时间范围结束的日期对象。
返回
整数。两个日期之间相差的季度数。
示例
以下示例将返回特定日期之间相差的季度数:
以下示例将返回从当前日期到 2010 年开始将经过的季度数:
以下示例将返回 ProjectStart 和 ProjectComplete 字段中的值之间相差的季度数:
此函数将返回两个日期之间相差的秒数。如果某个日期没有时间值,那么此函数将假定时间为午夜(00:00:00)。
语法
参数
date1
用于表示时间范围开始的日期对象。
date2
用于表示时间范围结束的日期对象。
返回
整数。两个日期之间相差的秒数。
示例
以下示例将返回特定日期之间相差的秒数:
以下示例将返回从当前日期和时间到 2010 年开始将经过的秒数:
以下示例将返回 StartTime 和 FinishTime 字段中的值之间相差的秒数:
此函数将返回两个日期之间相差的星期数。通过用第二个日期的星期数减去第一个日期的星期数,就可以计算出相差的星期数。例如,如果第一个日期为 2009-01-02(当年的第一个星期),第二个日期为 2009-01-05(当年的第二个星期),那么此函数将返回一个星期,尽管这两个日期之间只相差三天。
语法
参数
date1
用于表示时间范围开始的日期对象。
date2
用于表示时间范围结束的日期对象。
返回
整数。两个日期之间相差的星期数。
示例
以下示例将返回特定日期之间相差的星期数:
以下示例将返回从当前日期到 2010 年开始将经过的星期数:
以下示例将返回 ProjectStart 和 ProjectComplete 字段中的值之间相差的星期数:
此函数将返回两个日期之间相差的年数。通过用第二个日期的“年份”值减去第一个日期的“年份”值,就可以计算出相差的年数。例如,如果第一个日期为 2009-01-01,第二个日期为 2009-12-31,那么此函数将返回 0。如果第一个日期为 2008-11-15,第二个日期为 2009-01-15,那么此函数将返回 1。
语法
参数
date1
用于表示时间范围开始的日期对象。
date2
用于表示时间范围结束的日期对象。
返回
整数。两个日期之间相差的年数。
示例
以下示例将返回特定日期之间相差的年数:
以下示例将返回 HireDate 字段中的每个值与当前日期之间相差的年数:
此函数将返回两个日期之间相差的年数。通过用第二个日期的“年份”值减去第一个日期的“年份”值,就可以计算出相差的年数。例如,如果第一个日期为 2009-01-01,第二个日期为 2009-12-31,那么此函数将返回 0。如果第一个日期为 2008-11-15,第二个日期为 2009-01-15,那么此函数将返回 1。
语法
参数
date1
用于表示时间范围开始的日期对象。
date2
用于表示时间范围结束的日期对象。
返回
整数。两个日期之间相差的年数。
示例
以下示例将返回特定日期之间相差的年数:
以下示例将返回 HireDate 字段中的每个值与当前日期之间相差的年数:
此函数将返回输入日期所属月份的第一天的日期。
语法
参数
date
要从其中获取月份的日期对象。
返回
Date 对象。所给定的日期所属月份的第一天。
示例
以下示例将显示为特定日期返回的月份值:
此函数将返回输入日期所属季度的第一天的日期。
语法
参数
date
要从其中获取季度的日期对象。
返回
Date 对象。所给定的日期所属季度的第一天。
示例
以下示例将显示为特定日期返回的季度值:
此函数将返回输入日期所属星期的第一天的日期,始终为星期天。
语法
参数
date
要从其中获取星期的日期对象。
返回
Date 对象。所给定的日期所属星期的第一天。
示例
以下示例将显示为特定日期返回的星期值:
此函数将返回输入日期所属年份的第一天的日期。
语法
参数
date
要从其中获取年份的日期对象。
返回
Date 对象。所给定的日期所属年份的第一天。
示例
以下示例将显示为特定日期返回的年份值:
此函数将返回给定日期所属的月份。根据您指定的选项不同,此函数将返回用数字表示的月份、完整的月份名称或者缩写的月份名称。月份名称特定于语言环境。
语法
参数
date
要从其中获取月份的日期对象。
option
整数。可选。表示要返回的月份格式的一个数。请使用下列其中一个值:
如果省略此自变量,那么此函数将返回用数字表示的月份。
返回
字符串。所给定的日期所属的月份。
示例
以下示例将显示为特定日期返回的月份值:
以下示例将返回当前日期所属的月份:
此函数将返回当前日期和时间,例如,2009 年 2 月 2 日下午 2:05。
语法
返回
Date 对象。当前日期和时间。
示例
以下示例将返回从当前日期和时间到圣诞节将经过的小时数:
此函数将返回 1 到 4 之间的一个数,用来表示给定日期属于哪个季度。第一个季度从 1 月 1 日开始。
语法
参数
date
要从其中获取季度数的日期对象。
返回
整数。所给定的日期所属的季度数。
示例
以下示例将显示为特定日期返回的季度数:
以下示例将返回 CloseDate 字段中每个值的季度数:
以下示例将返回当前日期所属的季度数:
此函数将返回其中包括午夜的时间值的当前日期,例如,2009 年 2 月 2 日午夜 12:00。
语法
返回
Date 对象。时间值为“午夜”的当前日期。
示例
以下示例将返回从当前日期到圣诞节将经过的天数:
以下示例将计算 HireDate 数据字段中的每个值与当前日期之间相差的年数。
此函数将返回 1 到 52 之间的一个数,用来表示给定日期所属的星期数。
语法
参数
date
要从其中获取星期数的日期对象。
返回
整数。所给定的日期所属的星期数。
示例
以下示例将显示为特定日期返回的星期数:
以下示例将返回 CloseDate 字段中每个值的星期数:
以下示例将返回当前日期所属的星期数:
此函数将返回给定日期是星期几。根据您指定的选项不同,此函数将返回用数字表示的星期几、完整的工作日名称或者缩写的工作日名称。工作日名称特定于语言环境。
语法
参数
date
要从其中获取是星期几的日期对象。
option
整数。可选。表示要返回的格式的一个数。请使用下列其中一个值:
如果省略此自变量,那么此函数将假定使用选项 1。
返回
字符串。所给定日期所属星期的星期几。
示例
以下示例将显示为特定日期返回的工作日值:
以下示例将返回当前日期是星期几:
此函数将返回给定日期的年份值,用四位数表示。例如,如果日期为 2009-01-19,那么此函数将返回 2009。
语法
参数
date
要从其中获取年份的日期对象。
返回
整数。所给定日期的四位年份值。
示例
以下示例将返回 HireDate 字段中每个值所属的年份:
以下示例将返回当前日期所属的年份: