上一页 下一页

BirtDateTime

BirtDateTime 类提供了一些函数,用于确定两个日期或时间之间的时间量,加上或减去时间范围以及获取一个日期的某些部分。因为日期范围全是数字,所以应用程序可对它们进行正常的数学运算:加减乘除等等。此类是静态类。应用程序无法创建此类的实例。

BirtDateTime.addDay

此函数将返回一个新日期,即,将某个日期加上给定天数之后所得到的新日期。要加上的天数可以为负数。在这种情况下,获得的结果相当于从该日期减去所给定的星期数。

语法

Date BirtDateTime.addDay( Date date, Number n )

参数

date

Date 对象。用于表示起始日期的日期对象。

n

Number 对象。该日期要加上的天数。小数将视为整数,并向下舍入到最接近的整数。

返回

Date 对象。将起始日期加上所指定的天数而得到的新日期。

示例

以下示例将对特定日期加上所指定的天数:

var startDate = "2008-12-31";
var endDate;
endDate = BirtDateTime.addDay( startDate, 1 ); // 将返回 Jan 01, 2009
endDate = BirtDateTime.addDay( startDate, -1 ); // 将返回 Dec 30, 2008

以下示例将对 InvoiceDate 字段中的每个日期值加上 15 天:

BirtDateTime.addDay( row["InvoiceDate"], 15 )

BirtDateTime.addHour

此函数将返回一个新日期,即,将某个日期加上给定小时数之后所得到的新日期。要加上的小时数可以为负数。在这种情况下,获得的结果相当于从该日期减去所给定的星期数。

语法

Date BirtDateTime.addHour( Date date, Number n )

参数

date

用于表示起始日期的日期对象。如果起始日期没有时间值,那么此函数将假定时间为午夜(00:00:00)。

n

Number 对象。该日期要加上的小时数。

返回

Date 对象。将起始日期加上所指定的小时数而得到的新日期。

示例

以下示例将对特定日期和时间加上所指定的小时数:

var startDate = "2008-12-31 15:00:00";
var endDate;
endDate = BirtDateTime.addHour( startDate, 8 ); // 将返回 2008 年 12 月 31 日下午 11:00。
endDate = BirtDateTime.addHour( startDate, -8 ); // 将返回 2008 年 12 月 31 日上午 7:00。

以下示例将对 StartTime 字段中的每个日期值加上 36 小时:

BirtDateTime.addHour( row["StartTime"], 36 )

BirtDateTime.addMinute

此函数将返回一个新日期,即,将某个日期加上给定分钟数之后所得到的新日期。要加上的分钟数可以为负数。在这种情况下,获得的结果相当于从该日期减去所给定的星期数。

语法

Date BirtDateTime.addMinute( Date date, Number n )

参数

date

用于表示起始日期的日期对象。如果起始日期没有时间值,那么此函数将假定时间为午夜(00:00:00)。

n

Number 对象。该日期要加上的分钟数。

返回

Date 对象。将起始日期加上所指定的分钟数而得到的新日期。

示例

以下示例将对特定日期和时间加上所指定的分钟数:

var startDate = "2008-12-31 10:30:00";
var endDate;
endDate = BirtDateTime.addMinute( startDate, 45 );
// 将返回 2008 年 12 月 31 日上午 11:15
endDate = BirtDateTime.addMinute( startDate, -30 );
// 将返回 2008 年 12 月 31 日上午 10:00

以下示例将对 StartTime 字段中的每个日期值加上 15 分钟:

BirtDateTime.addMinute( row["StartTime"], 15 )

BirtDateTime.addMonth

此函数将返回一个新日期,即,将某个日期加上给定分钟数之后所得到的新日期。要加上的月数可以为负数。在这种情况下,获得的结果相当于从该日期减去所给定的星期数。

此函数始终将返回一个有效日期。必要时,可将获得日期的“日”部分向下调整为所获得年份、月份中的最后一天。例如,如果将 2008 年 1 月 31 日加上一个月,那么 addMonth( ) 将返回“2008 年 2 月 29 日”而不是“2008 年 2 月 31 日”(因为 2008 年是闰年)。

语法

Date BirtDateTime.addMonth( Date date, Number n )

参数

date

Date 对象。用于表示起始日期的日期对象。

n

Number 对象。该日期要加上的月数。小数将视为整数,并向下舍入。

返回

Date 对象。将起始日期加上所指定的月份数而得到的新日期。

示例

以下示例将对特定日期加上所指定的月数:

var startDate = "2008-12-31";
var endDate;
endDate = BirtDateTime.addMonth( startDate, 1 ); // 将返回 Jan 31, 2009
endDate = BirtDateTime.addMonth( startDate, -1 ); // 将返回 Nov 30, 2008
endDate = BirtDateTime.addMonth( startDate, 2 ); // 将返回 Feb 28, 2009

以下示例将对 InvoiceDate 字段中的每个日期值加上 10 个月:

BirtDateTime.addMonth( row["InvoiceDate"], 10 )

BirtDateTime.addQuarter

此函数将返回一个新日期,即,将某个日期加上给定季度数之后所得到的新日期。一个季度就是三个月。例如,如果您对“Sep 10, 2008”加上两个季度,那么此函数将返回“Mar 10, 2009”。要加上的季度数可以为负数。在这种情况下,获得的结果相当于从该日期减去所给定的星期数。

语法

Date BirtDateTime.addQuarter( Date date, Number n )

参数

date

用于表示起始日期的日期对象。

n

Number 对象。该日期要加上的季度数。

返回

Date 对象。将起始日期加上所指定的季度数而得到的新日期。

示例

以下示例将对特定日期加上所指定的季度数:

var startDate = "2008-12-15";
var endDate;
endDate = BirtDateTime.addQuarter( startDate, 1 ); //将返回 Mar 15, 2009
endDate = BirtDateTime.addQuarter( startDate, -2 ); //将返回 Jun 15, 2008

以下示例将对 ForecastClosing 字段中的每个日期值加上两个季度:

BirtDateTime.addQuarter( row["ForecastClosing"], 2 )

BirtDateTime.addSecond

此函数将返回一个新日期,即,将某个日期加上给定秒数之后所得到的新日期。要加上的秒数可以为负数。在这种情况下,获得的结果相当于从该日期减去所给定的星期数。

语法

Date BirtDateTime.addSecond( Date date, Number n )

参数

date

用于表示起始日期的日期对象。如果起始日期没有时间值,那么此函数将假定时间为午夜(00:00:00)。

n

Number 对象。该日期要加上的秒数。

返回

Date 对象。将起始日期加上所指定的秒数而得到的结果。

示例

以下示例将对特定日期和时间加上所指定的秒数:

var startDate = "2008-12-31 10:30:00";
var endDate;
endDate = BirtDateTime.addSecond( startDate, 10000 );
// 将返回 2008 年 12 月 31 日下午 1:16:40
endDate = BirtDateTime.addSecond( startDate, -10000 );
// 将返回 2008 年 12 月 31 日上午 7:43:20

以下示例将对 StartTime 字段中的每个日期值加上 6000 秒:

BirtDateTime.addSecond( row["StartTime"], 6000 )

BirtDateTime.addWeek

此函数将返回一个新日期,即,将某个日期加上给定星期数之后所得到的新日期。要加上的星期数可以为负数。在这种情况下,获得的结果相当于从该日期减去所给定的星期数。

语法

Date BirtDateTime.addWeek( Date date, Number n )

参数

date

用于表示起始日期的日期对象。

n

Number 对象。该日期要加上的星期数。

返回

Date 对象。将起始日期加上所指定的星期数而得到的新日期。

示例

以下示例将对特定日期加上所指定的星期数:

var startDate = "2008-12-31";
var endDate;
endDate = BirtDateTime.addWeek( startDate, 1 ); // returns Jan 07, 2009
endDate = BirtDateTime.addWeek( startDate, -1 ); // returns Dec 24, 2008

以下示例将对 InvoiceDate 字段中的每个日期值加上两个星期:

BirtDateTime.addWeek( row["InvoiceDate"], 2 )

BirtDateTime.addYear

此函数将返回一个新日期,即,将某个日期加上给定年数之后所得到的新日期。要加上的年数可以为负数。在这种情况下,获得的结果相当于从该日期减去所给定的星期数。

语法

Date BirtDateTime.addYear( Date date, Number n )

参数

date

用于表示起始日期的日期对象。

n

Number 对象。该日期要加上的年数。小数将视为整数,并向下舍入。

返回

将起始日期加上所指定的年数而得到的新日期。

示例

以下示例将对特定日期加上所指定的年数:

var startDate = "2008-12-31";
var endDate;
endDate = BirtDateTime.addYear( startDate, 1 ); // 将返回 Dec 31, 2009
endDate = BirtDateTime.addYear( startDate, -1 ); // 将返回 Dec 31, 2007

以下示例将对 HireDate 字段中的每个日期值加上 5 年:

BirtDateTime.addYear( row["HireDate"], 5 )

BirtDateTime.day

此函数将返回 1 到 31 之间的一个数,用来表示给定日期的“日”。例如,如果日期为 2009-01-19,那么此函数将返回 19。

语法

integer BirtDateTime.day( Date date )

参数

date

Date 对象。要从其中获取特定日的日期对象。

返回

用来表示给定日期的“日”的整数。

示例

以下示例将返回 ShipDate 字段中每个值的“日”:

BirtDateTime.day( row["ShipDate"] )

以下示例将返回当前日期的“日”:

BirtDateTime.day( (BirtDateTime.today())

BirtDateTime.diffDay

此函数将返回两个日期之间相差的天数。通过用第二个日期的“日”值减去第一个日期的“日”值,就可以计算出相差的天数。例如,如果第一个日期为 2008-12-30 23:59:59,第二个日期为 2008-12-31 00:00:00,那么此函数将返回 1 天,尽管这两个日期之间只相差 1 秒钟。

语法

integer BirtDateTime.diffDay( Date date1, Date date2 )

参数

date1

用于表示时间范围开始的日期对象。

date2

用于表示时间范围结束的日期对象。

返回

整数。两个日期之间相差的天数。

示例

以下示例将返回特定日期之间相差的天数:

BirtDateTime.diffDay( "2009-01-01", "2009-04-15" ) // 将返回 104

以下示例将返回从当前日期到 2009 年年末将经过的天数:

BirtDateTime.diffDay( BirtDateTime.today(), "2009-12-31" )

以下示例将返回 InvoiceDate 和 PaymentDate 字段中的值之间相差的天数:

BirtDateTime.diffDay( row["InvoiceDate"], row["PaymentDate"] )

BirtDateTime.diffHour

此函数将返回两个日期之间相差的小时数。通过用第二个日期的“小时”值减去第一个日期的“小时”值,就可以计算出相差的小时数。例如,如果第一个日期为 2009-01-31 1:30:00,第二个日期为 2009-01-31 2:00:00,那么此函数将返回 1 小时,尽管这两个日期之间只相差 30 分钟。如果某个日期没有时间值,那么此函数将假定时间为午夜(00:00:00)。

语法

integer BirtDateTime.diffHour( Date date1, Date date2 )

参数

date1

用于表示时间范围开始的日期对象。

date2

用于表示时间范围结束的日期对象。

返回

整数。两个日期之间相差的小时数。

示例

以下示例将返回特定日期之间相差的小时数:

BirtDateTime.diffHour( "2009-01-31 12:00:00", "2009-02-01 12:00:00")
// 将返回 24
BirtDateTime.diffHour( "2009-01-31", "2009-02-01 12:00:00")
// 将返回 36。因为第一个日期没有指定时间,所以将假定时间为午夜。

以下示例将返回从当前日期和时间到 2009 年年末将经过的小时数

BirtDateTime.diffHour( BirtDateTime.now(), "2009-12-31" );

以下示例将返回 StartTime 和 FinishTime 字段中的值之间相差的小时数:

BirtDateTime.diffHour( row["StartTime"], row["FinishTime"] )

BirtDateTime.diffMinute

此函数将返回两个日期之间相差的分钟数。通过用第二个日期的“分钟”值减去第一个日期的“分钟”值,就可以计算出相差的分钟数。例如,如果第一个日期为 2009-01-31 1:30:59,第二个日期为 2009-01-31 1:31:00,那么此函数将返回 1 分钟,尽管这两个日期之间只相差 1 秒钟。如果某个日期没有时间值,那么此函数将假定时间为午夜(00:00:00)。

语法

integer BirtDateTime.diffMinute( Date date1, Date date2 )

参数

date1

用于表示时间范围开始的日期对象。

date2

用于表示时间范围结束的日期对象。

返回

整数。两个日期之间相差的分钟数。

示例

以下示例将返回特定日期之间相差的分钟数:

BirtDateTime.diffMinute( "2009-01-31 1:30:30", "2009-01-31 10:45:00")
// 将返回 555
BirtDateTime.diffMinute( "2009-01-31", "2009-01-31 12:00:00")
// 将返回 720。因为第一个日期没有指定时间,所以将假定时间为午夜。

以下示例将返回从当前日期和时间到 2010 年开始将经过的分钟数

BirtDateTime.diffMinute( BirtDateTime.now(), "2010-01-01" )

以下示例将返回 StartTime 和 FinishTime 字段中的值之间相差的分钟数:

BirtDateTime.diffMinute( row["StartTime"], row["FinishTime"] )

BirtDateTime.diffMonth

此函数将返回两个日期之间相差的月数。通过用第二个日期的“月份”值减去第一个日期的“月份”值,就可以计算出相差的月数。例如,如果第一个日期为 2009-01-31,第二个日期为 2009-02-01,那么此函数将返回 1 个月,尽管这两个日期之间只相差 1 天。

语法

integer BirtDateTime.diffMonth( Date date1, Date date2 )

参数

date1

用于表示时间范围开始的日期对象。

date2

用于表示时间范围结束的日期对象。

返回

整数。两个日期之间相差的月份数。

示例

以下示例将返回特定日期之间相差的月数:

BirtDateTime.diffMonth( "2009-01-31", "2009-04-15") // 将返回 3

以下示例将返回从当前日期到 2010 年开始将经过的月份数:

BirtDateTime.diffMonth( BirtDateTime.today(), "2010-01-01" );

以下示例将返回 ProjectStart 和 ProjectComplete 字段中的值之间相差的月份数:

BirtDateTime.diffMonth( row["ProjectStart"], row["ProjectComplete"] )

BirtDateTime.diffQuarter

此函数将返回两个日期之间相差的季度数。通过用第二个日期的“月份”值减去第一个日期的“月份”值,就可以计算出相差的季度。相差 3 个月就是一个季度。例如,如果第一个日期为 2009-01-31,第二个日期为 2009-07-01,那么此函数将返回 2。如果第一个日期为 2009-01-01,第二个日期为 2009-09-30,那么此函数也将返回 2。

语法

integer BirtDateTime.diffQuarter( Date date1, Date date2 )

参数

date1

用于表示时间范围开始的日期对象。

date2

用于表示时间范围结束的日期对象。

返回

整数。两个日期之间相差的季度数。

示例

以下示例将返回特定日期之间相差的季度数:

BirtDateTime.diffQuarter( "2009-01-31", "2009-04-15") // 将返回 1

以下示例将返回从当前日期到 2010 年开始将经过的季度数:

BirtDateTime.diffQuarter( BirtDateTime.today(), "2010-01-01" );

以下示例将返回 ProjectStart 和 ProjectComplete 字段中的值之间相差的季度数:

BirtDateTime.diffQuarter( row["ProjectStart"], row["ProjectComplete"] )

BirtDateTime.diffSecond

此函数将返回两个日期之间相差的秒数。如果某个日期没有时间值,那么此函数将假定时间为午夜(00:00:00)。

语法

integer BirtDateTime.diffSecond( date1, date2 )

参数

date1

用于表示时间范围开始的日期对象。

date2

用于表示时间范围结束的日期对象。

返回

整数。两个日期之间相差的秒数。

示例

以下示例将返回特定日期之间相差的秒数:

BirtDateTime.diffSecond( "2009-01-31 11:30:30", "2009-01-31 12:00:00")
// 将返回 1770
BirtDateTime.diffSecond( "2009-01-31", "2009-01-31 1:00:00")
// 将返回 3600。因为第一个日期没有指定时间,所以将假定时间为午夜。

以下示例将返回从当前日期和时间到 2010 年开始将经过的秒数

BirtDateTime.diffSecond( BirtDateTime.now(), "2010-01-01" )

以下示例将返回 StartTime 和 FinishTime 字段中的值之间相差的秒数:

BirtDateTime.diffSecond( row["StartTime"], row["FinishTime"] )

BirtDateTime.diffWeek

此函数将返回两个日期之间相差的星期数。通过用第二个日期的星期数减去第一个日期的星期数,就可以计算出相差的星期数。例如,如果第一个日期为 2009-01-02(当年的第一个星期),第二个日期为 2009-01-05(当年的第二个星期),那么此函数将返回一个星期,尽管这两个日期之间只相差三天。

语法

integer BirtDateTime.diffWeek( Date date1, Date date2 )

参数

date1

用于表示时间范围开始的日期对象。

date2

用于表示时间范围结束的日期对象。

返回

整数。两个日期之间相差的星期数。

示例

以下示例将返回特定日期之间相差的星期数:

BirtDateTime.diffWeek( "2009-01-01", "2009-02-01") // 将返回 5

以下示例将返回从当前日期到 2010 年开始将经过的星期数:

BirtDateTime.diffWeek( BirtDateTime.today(), "2010-01-01" );

以下示例将返回 ProjectStart 和 ProjectComplete 字段中的值之间相差的星期数:

BirtDateTime.diffWeek( row["ProjectStart"], row["ProjectComplete"] )

BirtDateTime.diffYear

此函数将返回两个日期之间相差的年数。通过用第二个日期的“年份”值减去第一个日期的“年份”值,就可以计算出相差的年数。例如,如果第一个日期为 2009-01-01,第二个日期为 2009-12-31,那么此函数将返回 0。如果第一个日期为 2008-11-15,第二个日期为 2009-01-15,那么此函数将返回 1。

语法

integer BirtDateTime.diffYear( Date date1, Date date2 )

参数

date1

用于表示时间范围开始的日期对象。

date2

用于表示时间范围结束的日期对象。

返回

整数。两个日期之间相差的年数。

示例

以下示例将返回特定日期之间相差的年数:

BirtDateTime.diffYear( "2005-01-01", "2009-06-01") // 将返回 4

以下示例将返回 HireDate 字段中的每个值与当前日期之间相差的年数

BirtDateTime.diffYear( row["HireDate"], BirtDateTime.today() )

BirtDateTime.diffYear

此函数将返回两个日期之间相差的年数。通过用第二个日期的“年份”值减去第一个日期的“年份”值,就可以计算出相差的年数。例如,如果第一个日期为 2009-01-01,第二个日期为 2009-12-31,那么此函数将返回 0。如果第一个日期为 2008-11-15,第二个日期为 2009-01-15,那么此函数将返回 1。

语法

integer BirtDateTime.diffYear( Date date1, Date date2 )

参数

date1

用于表示时间范围开始的日期对象。

date2

用于表示时间范围结束的日期对象。

返回

整数。两个日期之间相差的年数。

示例

以下示例将返回特定日期之间相差的年数:

BirtDateTime.diffYear( "2005-01-01", "2009-06-01") // 将返回 4

以下示例将返回 HireDate 字段中的每个值与当前日期之间相差的年数

BirtDateTime.diffYear( row["HireDate"], BirtDateTime.today() )

BirtDateTime.firstDayOfMonth

此函数将返回输入日期所属月份的第一天的日期。

语法

Date BirtDateTime.firstDayOfMonth( Date date)

参数

date

要从其中获取月份的日期对象。

返回

Date 对象。所给定的日期所属月份的第一天。

示例

以下示例将显示为特定日期返回的月份值:

BirtDateTime.firstDayOfMonth( "2009-02-15" ) // returns 2009-02-01

BirtDateTime.firstDayOfQuarter

此函数将返回输入日期所属季度的第一天的日期。

语法

Date BirtDateTime.firstDayOfQuarter( Date date)

参数

date

要从其中获取季度的日期对象。

返回

Date 对象。所给定的日期所属季度的第一天。

示例

以下示例将显示为特定日期返回的季度值:

BirtDateTime.firstDayOfQuarter( "2009-02-15" ) // returns 2009-01-01

BirtDateTime.firstDayOfWeek

此函数将返回输入日期所属星期的第一天的日期,始终为星期天。

语法

Date BirtDateTime.firstDayOfWeek( Date date)

参数

date

要从其中获取星期的日期对象。

返回

Date 对象。所给定的日期所属星期的第一天。

示例

以下示例将显示为特定日期返回的星期值:

BirtDateTime.firstDayOfWeek( "2009-02-15" ) // returns 2009-02-15

BirtDateTime.firstDayOfYear

此函数将返回输入日期所属年份的第一天的日期。

语法

Date BirtDateTime.firstDayOfYear( Date date)

参数

date

要从其中获取年份的日期对象。

返回

Date 对象。所给定的日期所属年份的第一天。

示例

以下示例将显示为特定日期返回的年份值:

BirtDateTime.firstDayOfYear( "2009-02-15" ) // returns 2009-01-01

BirtDateTime.month

此函数将返回给定日期所属的月份。根据您指定的选项不同,此函数将返回用数字表示的月份、完整的月份名称或者缩写的月份名称。月份名称特定于语言环境。

语法

string BirtDateTime.month( Date date, integer option )

参数

date

要从其中获取月份的日期对象。

option

整数。可选。表示要返回的月份格式的一个数。请使用下列其中一个值:

*
*
*

如果省略此自变量,那么此函数将返回用数字表示的月份。

返回

字符串。所给定的日期所属的月份。

示例

以下示例将显示为特定日期返回的月份值:

BirtDateTime.month( "2009-02-15" ) // 将返回 2
BirtDateTime.month( "2009-02-15", 2 ) // 将返回 February(二月)
BirtDateTime.month( "2009-02-15", 3) // 将返回 Feb

以下示例将返回当前日期所属的月份:

BirtDateTime.month( (BirtDateTime.today() )

BirtDateTime.now

此函数将返回当前日期和时间,例如,2009 年 2 月 2 日下午 2:05。

语法

Date BirtDateTime.now( )

返回

Date 对象。当前日期和时间。

示例

以下示例将返回从当前日期和时间到圣诞节将经过的小时数

BirtDateTime.diffHour( BirtDateTime.now(), "2009-12-25" )

BirtDateTime.quarter

此函数将返回 1 到 4 之间的一个数,用来表示给定日期属于哪个季度。第一个季度从 1 月 1 日开始。

语法

integer BirtDateTime.quarter( Date date )

参数

date

要从其中获取季度数的日期对象。

返回

整数。所给定的日期所属的季度数。

示例

以下示例将显示为特定日期返回的季度数:

BirtDateTime.quarter( "2009-02-15" ) // 将返回 1
BirtDateTime.quarter( "2009-07-10" ) // 将返回 3

以下示例将返回 CloseDate 字段中每个值的季度数:

BirtDateTime.quarter( row["CloseDate"] )

以下示例将返回当前日期所属的季度数:

BirtDateTime.quarter( (BirtDateTime.today() )

BirtDateTime.today

此函数将返回其中包括午夜的时间值的当前日期,例如,2009 年 2 月 2 日午夜 12:00。

语法

Date BirtDateTime.today( )

返回

Date 对象。时间值为“午夜”的当前日期。

示例

以下示例将返回从当前日期到圣诞节将经过的天数:

BirtDateTime.diffDay( BirtDateTime.today(), "2009-12-25" )

以下示例将计算 HireDate 数据字段中的每个值与当前日期之间相差的年数。

BirtDateTime.diffYear( [HireDate], BirtDateTime.today() )

BirtDateTime.week

此函数将返回 1 到 52 之间的一个数,用来表示给定日期所属的星期数

语法

integer BirtDateTime.week( date )

参数

date

要从其中获取星期数的日期对象。

返回

整数。所给定的日期所属的星期数。

示例

以下示例将显示为特定日期返回的星期数:

BirtDateTime.week( "2009-02-15" ) // 将返回 8
BirtDateTime.week( "2009-10-12" ) // 将返回 42

以下示例将返回 CloseDate 字段中每个值的星期数:

BirtDateTime.week( row["CloseDate"] )

以下示例将返回当前日期所属的星期数:

BirtDateTime.week( (BirtDateTime.today() )

BirtDateTime.weekDay

此函数将返回给定日期是星期几。根据您指定的选项不同,此函数将返回用数字表示的星期几、完整的工作日名称或者缩写的工作日名称。工作日名称特定于语言环境。

语法

string BirtDateTime.weekDay( Date date, integer option )

参数

date

要从其中获取是星期几的日期对象。

option

整数。可选。表示要返回的格式的一个数。请使用下列其中一个值:

*
*
*
*
*

如果省略此自变量,那么此函数将假定使用选项 1。

返回

字符串。所给定日期所属星期的星期几。

示例

以下示例将显示为特定日期返回的工作日值:

BirtDateTime.weekDay( "2009-02-02" ) // 将返回 2
BirtDateTime.weekDay( "2009-02-02", 2 ) // 将返回 1
BirtDateTime.weekDay( "2009-02-02", 4 ) // 将返回 Monday(星期一)

以下示例将返回当前日期是星期几:

BirtDateTime.weekDay( (BirtDateTime.today() )

BirtDateTime.year

此函数将返回给定日期的年份值,用四位数表示。例如,如果日期为 2009-01-19,那么此函数将返回 2009。

语法

integer BirtDateTime.year( date )

参数

date

要从其中获取年份的日期对象。

返回

整数。所给定日期的四位年份值。

示例

以下示例将返回 HireDate 字段中每个值所属的年份:

BirtDateTime.year( row["HireDate"] )

以下示例将返回当前日期所属的年份:

BirtDateTime.year( (BirtDateTime.today())

© Copyright Actuate Corporation 2013