이전 다음

BirtDateTime 클래스

BirtDateTime 클래스는 두 날짜 또는 시간 사이의 시간 양을 판별하거나, 시간의 범위를 추가하거나 빼고, 날짜의 파트를 가져올 수 있는 함수를 제공합니다. 날짜 범위는 단지 숫자이므로 애플리케이션은 이에 대해 일반 수식(곱하기, 나누기, 더하기, 빼기 등)을 사용할 수 있습니다. 이 클래스는 정적입니다. 애플리케이션은 클래스의 인스턴스를 작성할 수 없습니다.

BirtDateTime.addDay

이 함수는 날짜에 일 수를 추가하여 새 날짜를 리턴합니다. 일 수로 음수를 추가할 수 있습니다. 이 경우, 결과는 날짜에서 해당 숫자를 뺀 것과 동일합니다.

구문

Date BirtDateTime.addDay( Date date, Number n )

매개변수

date

날짜 오브젝트. 시작 날짜를 나타내는 날짜 오브젝트입니다.

n

숫자 오브젝트. 날짜에 추가할 일 수입니다. 10진수는 정수로 취급되고 가장 가까운 정수로 버려집니다.

리턴

날짜 오브젝트. 시작 날짜에 지정한 일 수를 추가하여 산출된 날짜입니다.

예제

다음 예제는 특정 날짜에 일 수를 추가합니다.

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

다음 예제는 InvoiceDate 필드의 각 날짜 값에 15일을 추가합니다.

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

BirtDateTime.addHour

이 함수는 날짜에 시간 수를 추가하여 새 날짜를 리턴합니다. 시간 수로 음수를 추가할 수 있습니다. 이 경우, 결과는 날짜에서 해당 숫자를 뺀 것과 동일합니다.

구문

Date BirtDateTime.addHour( Date date, Number n )

매개변수

date

시작 날짜를 나타내는 날짜 오브젝트입니다. 시작 날짜에 시간 값이 없는 경우, 함수가 가정하는 시간은 자정입니다(00:00:00).

n

숫자 오브젝트. 날짜에 추가할 시간 수입니다.

리턴

날짜 오브젝트. 시작 날짜에 지정된 시간 수를 추가하여 산출된 날짜입니다.

예제

다음 예제는 특정 날짜 및 시간에 시간을 추가합니다.

var startDate = "2008-12-31 15:00:00";
var endDate;
endDate = BirtDateTime.addHour( startDate, 8 ); // returns Dec 31, 2008 11:00 PM
endDate = BirtDateTime.addHour( startDate, -8 ); // returns Dec 31, 2008 7:00 AM

다음 예제는 StartTime 필드의 각 날짜 값에 36시간을 추가합니다.

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

BirtDateTime.addMinute

이 함수는 날짜에 분 수를 추가하여 새 날짜를 리턴합니다. 분 수로 음수를 추가할 수 있습니다. 이 경우, 결과는 날짜에서 해당 숫자를 뺀 것과 동일합니다.

구문

Date BirtDateTime.addMinute( Date date, Number n )

매개변수

date

시작 날짜를 나타내는 날짜 오브젝트입니다. 시작 날짜에 시간 값이 없는 경우, 함수가 가정하는 시간은 자정입니다(00:00:00).

n

숫자 오브젝트. 날짜에 추가할 분 수입니다.

리턴

날짜 오브젝트. 시작 날짜에 지정한 분 수를 추가하여 산출된 날짜입니다.

예제

다음 예제는 특정 날짜 및 시간에 분을 추가합니다.

var startDate = "2008-12-31 10:30:00";
var endDate;
endDate = BirtDateTime.addMinute( startDate, 45 );
// returns Dec 31, 2008 11:15 AM
endDate = BirtDateTime.addMinute( startDate, -30 );
// returns Dec 31, 2008 10:00 AM

다음 예제는 StartTime 필드의 각 날짜 값에 15분을 추가합니다.

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

BirtDateTime.addMonth

이 함수는 날짜에 월 수를 추가하여 새 날짜를 리턴합니다. 월 수로 음수를 추가할 수 있습니다. 이 경우, 결과는 날짜에서 해당 숫자를 뺀 것과 동일합니다.

이 함수는 항상 유효한 날짜를 리턴합니다. 필요한 경우, 결과 날짜의 날짜 파트는 결과 년에 있는 결과 월의 최종 일로 하향 조정됩니다. 예를 들어, 2008년 1월 31일에 1개월을 추가하는 경우, addMonth( )는 2008년 2월 31일이 아니라 2008년(2008은 윤년) 2월 29일을 리턴합니다.

구문

Date BirtDateTime.addMonth( Date date, Number n )

매개변수

date

날짜 오브젝트. 시작 날짜를 나타내는 날짜 오브젝트입니다.

n

숫자 오브젝트. 날짜에 추가할 월 수입니다. 10진수는 정수로 취급되고 버려집니다.

리턴

날짜 오브젝트. 시작 날짜에 지정된 월 수를 추가하여 산출된 날짜입니다.

예제

다음 예제는 특정 날짜에 월을 추가합니다.

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

다음 예제는 InvoiceDate 필드의 각 날짜 값에 10개월을 추가합니다.

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

BirtDateTime.addQuarter

이 함수는 날짜에 분기 수를 추가하여 새 날짜를 리턴합니다. 분기는 3개월과 동일합니다. 예를 들어, 2분기를 2008년 9월 10일에 추가하는 경우 함수는 2009년 3월 10일을 리턴합니다. 분기 수로 음수를 추가할 수 있습니다. 이 경우, 결과는 날짜에서 해당 숫자를 뺀 것과 동일합니다.

구문

Date BirtDateTime.addQuarter( Date date, Number n )

매개변수

date

시작 날짜를 나타내는 날짜 오브젝트입니다.

n

숫자 오브젝트. 날짜에 추가할 분기 수입니다.

리턴

날짜 오브젝트. 시작 날짜에 지정된 분기 수를 추가하여 산출된 날짜입니다.

예제

다음 예제는 특정 날짜에 분기를 추가합니다.

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

다음 날짜는 ForecastClosing 필드의 각 날짜 값에 2분기를 추가합니다.

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

BirtDateTime.addSecond

이 함수는 날짜에 초 수를 추가하여 새 날짜를 리턴합니다. 초 수로 음수를 추가할 수 있습니다. 이 경우, 결과는 날짜에서 해당 숫자를 뺀 것과 동일합니다.

구문

Date BirtDateTime.addSecond( Date date, Number n )

매개변수

date

시작 날짜를 나타내는 날짜 오브젝트입니다. 시작 날짜에 시간 값이 없는 경우, 함수가 가정하는 시간은 자정입니다(00:00:00).

n

숫자 오브젝트. 날짜에 추가할 초 수입니다.

리턴

날짜 오브젝트. 시작 날짜에 지정된 초 수를 추가하여 산출된 결과입니다.

예제

다음 예제는 특정 날짜 및 시간에 초를 추가합니다.

var startDate = "2008-12-31 10:30:00";
var endDate;
endDate = BirtDateTime.addSecond( startDate, 10000 );
// returns returns Dec 31, 2008 1:16:40 PM
endDate = BirtDateTime.addSecond( startDate, -10000 );
// returns Dec 31, 2008 7:43:20 AM

다음 예제는 StartTime 필드의 각 날짜 값에 6000초를 추가합니다.

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

BirtDateTime.addWeek

이 함수는 날짜에 주 수를 추가하여 새 날짜를 리턴합니다. 주 수로 음수를 추가할 수 있습니다. 이 경우, 결과는 날짜에서 해당 숫자를 뺀 것과 동일합니다.

구문

Date BirtDateTime.addWeek( Date date, Number n )

매개변수

date

시작 날짜를 나타내는 날짜 오브젝트입니다.

n

숫자 오브젝트. 날짜에 추가할 주 수입니다.

리턴

날짜 오브젝트. 시작 날짜에 지정된 주 수를 추가하여 산출된 날짜입니다.

예제

다음 예제는 특정 날짜에 주를 추가합니다.

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 필드의 각 날짜 값에 2주를 추가합니다.

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

BirtDateTime.addYear

이 함수는 날짜에 년 수를 추가하여 새 날짜를 리턴합니다. 년 수로 음수를 추가할 수 있습니다. 이 경우, 결과는 날짜에서 해당 숫자를 뺀 것과 동일합니다.

구문

Date BirtDateTime.addYear( Date date, Number n )

매개변수

date

시작 날짜를 나타내는 날짜 오브젝트입니다.

n

숫자 오브젝트. 날짜에 추가할 년 수입니다. 10진수는 정수로 취급되고 버려집니다.

리턴

시작 날짜에 지정된 년 수를 추가하여 산출된 날짜입니다.

예제

다음 예제는 특정 날짜에 년을 추가합니다.

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

다음 예제는 HireDate 필드의 각 날짜 값에 5년을 추가합니다.

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

BirtDateTime.day

이 함수는 지정된 날짜에 대한 월의 일을 나타내는 1에서 31 사이의 숫자를 리턴합니다. 예를 들어, 날짜가 2009-01-19인 경우, 함수는 19를 리턴합니다.

구문

integer BirtDateTime.day( 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" ) // returns 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인 경우 두 날짜의 차이가 단 30분이라고 해도 함수는 1시간을 리턴합니다. 날짜에 시간 값이 없는 경우, 함수가 가정하는 시간은 자정입니다(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")
// returns 24
BirtDateTime.diffHour( "2009-01-31", "2009-02-01 12:00:00")
// returns 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")
// returns 555
BirtDateTime.diffMinute( "2009-01-31", "2009-01-31 12:00:00")
// returns 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") // returns 3

다음 예제는 현재 날짜에서 2010년의 첫 번째 날짜까지의 월 수를 리턴합니다.

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

다음 예제는 ProjectStart 및 ProjectComplete 필드 값 사이의 월 수를 리턴합니다.

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

BirtDateTime.diffQuarter

이 함수를 사용하면 두 날짜 사이의 분기 수를 리턴합니다. 두 번째 날짜의 월 값에서 첫 번째 날짜의 월 값을 빼서 분기 수를 계산합니다. 3개월의 차이는 1분기와 동일합니다. 예를 들어, 첫 번째 날짜가 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") // returns 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")
// returns 1770
BirtDateTime.diffSecond( "2009-01-31", "2009-01-31 1:00:00")
// returns 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(년 중 두 번째 주)인 경우, 두 날짜 간의 차이가 단 3일이라고 해도 1주를 리턴합니다.

구문

integer BirtDateTime.diffWeek( Date date1, Date date2 )

매개변수

date1

시간 범위의 시작을 나타내는 날짜 오브젝트입니다.

date2

시간 범위의 끝을 나타내는 날짜 오브젝트입니다.

리턴

정수형. 두 날짜 사이의 주 수입니다.

예제

다음 예제는 특정 날짜 사이의 주 수를 리턴합니다.

BirtDateTime.diffWeek( "2009-01-01", "2009-02-01") // returns 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") // returns 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") // returns 4

다음 예제는 HireDate 필드 및 현재 날짜의 각 값 사이의 년 수를 리턴합니다.

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

BirtDateTime.firstDayOfMonth

이 함수는 입력 날짜가 해당되는 달의 첫 번째 날의 날짜를 리턴합니다.

구문

Date BirtDateTime.firstDayOfMonth( Date date)

매개변수

date

월을 가져올 날짜 오브젝트입니다.

리턴

날짜 오브젝트. 지정된 날짜에 대한 월의 첫째 날입니다.

예제

다음 예제는 특정 날짜에 대해 리턴된 월 값을 표시합니다.

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

BirtDateTime.firstDayOfQuarter

이 함수는 입력 날짜가 해당되는 분기의 첫 번째 날의 날짜를 리턴합니다.

구문

Date BirtDateTime.firstDayOfQuarter( Date date)

매개변수

date

분기를 가져올 날짜 오브젝트입니다.

리턴

날짜 오브젝트. 지정된 날짜에 대한 분기의 첫째 날입니다.

예제

다음 예제는 특정 날짜에 대해 리턴된 분기 값을 표시합니다.

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

BirtDateTime.firstDayOfWeek

이 함수는 입력 날짜가 해당되는 주의 첫 번째 요일(항상 일요일)의 날짜를 리턴합니다.

구문

Date BirtDateTime.firstDayOfWeek( Date date)

매개변수

date

주를 가져올 날짜 오브젝트입니다.

리턴

날짜 오브젝트. 지정된 날짜에 대한 주의 첫째 날입니다.

예제

다음 예제는 특정 날짜에 대해 리턴된 주 값을 표시합니다.

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

BirtDateTime.firstDayOfYear

이 함수는 입력 날짜가 해당되는 연도의 첫 번째 날의 날짜를 리턴합니다.

구문

Date BirtDateTime.firstDayOfYear( 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" ) // returns 2
BirtDateTime.month( "2009-02-15", 2 ) // returns February
BirtDateTime.month( "2009-02-15", 3) // returns Feb

다음 예제는 현재 날짜의 월을 리턴합니다.

BirtDateTime.month( (BirtDateTime.today() )

BirtDateTime.now

이 함수를 사용하면 현재 날짜 및 시간을 리턴합니다(예제: Feb 2, 2009 2:05 PM).

구문

Date BirtDateTime.now( )

리턴

날짜 오브젝트. 현재 날짜 및 시간입니다.

예제

다음 예제는 현재 날짜 및 시간에서 크리스마스까지의 시간 수를 리턴합니다.

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

BirtDateTime.quarter

이 함수를 사용하면 지정한 날짜가 해당되는 분기를 1부터 4까지의 수로 리턴합니다. 첫 번째 분기는 1월 1일에 시작합니다.

구문

integer BirtDateTime.quarter( Date date )

매개변수

date

분기 수를 가져올 날짜 오브젝트입니다.

리턴

정수형. 지정된 날짜에 대한 분기 수입니다.

예제

다음 예제는 특정 날짜에 대해 리턴된 분기 수를 표시합니다.

BirtDateTime.quarter( "2009-02-15" ) // returns 1
BirtDateTime.quarter( "2009-07-10" ) // returns 3

다음 예제는 CloseDate 필드의 각 값에 대한 분기 수를 리턴합니다.

BirtDateTime.quarter( row["CloseDate"] )

다음 예제는 현재 날짜의 분기 수를 리턴합니다.

BirtDateTime.quarter( (BirtDateTime.today() )

BirtDateTime.today

이 함수는 시간 값이 자정인 현재 날짜를 리턴합니다(예: Feb 2, 2009 12:00 AM).

구문

Date BirtDateTime.today( )

리턴

날짜 오브젝트. 시간 값이 자정인 현재 날짜입니다.

예제

다음 예제는 현재 날짜에서 크리스마스까지의 일 수를 리턴합니다.

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" ) // returns 8
BirtDateTime.week( "2009-10-12" ) // returns 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" ) // returns 2
BirtDateTime.weekDay( "2009-02-02", 2 ) // returns 1
BirtDateTime.weekDay( "2009-02-02", 4 ) // returns 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())

(c) Copyright Actuate Corporation 2013