이전 다음

BirtMath 클래스

BirtMath 클래스는 숫자 데이터를 조작하기 위한 함수(예: 더하기, 빼기, 곱하기 나누기 및 반올림)를 제공합니다. 숫자는 데이터 바인딩 편집 대화 상자의 데이터 유형 필드에서 다른 유형으로 캐스트될 수 있는 일반 오브젝트입니다. 이 클래스는 정적입니다. 애플리케이션은 클래스의 인스턴스를 작성할 수 없습니다.

BirtMath.add

이 함수는 두 수의 합계를 리턴합니다.

구문

Number BirtMath.add( Number n1, Number n2 )

매개변수

n1

숫자 오브젝트. 계산에 사용할 첫 번째 숫자입니다.

n2

계산에 사용할 두 번째 수입니다.

리턴

숫자 오브젝트. n1과 n2를 추가하여 산출된 숫자입니다.

예제

다음 예제는 SalesTotal 및 Shipping 필드 값의 합계를 리턴합니다.

BirtMath.add( row["SalesTotal"], row["Shipping"] )

BirtMath.ceiling

이 함수는 0으로부터 멀어지도록 지정된 배수에 가장 근접하게 수를 반올림합니다.

구문

Number BirtMath.ceiling( Number n, Number significance )

매개변수

n

숫자 오브젝트. 반올림할 숫자입니다.

유의성

숫자 오브젝트. n을 반올림할 배수입니다.

리턴

숫자 오브젝트. 반올림하여 산출된 숫자입니다. n이 유의성의 정확한 배수인 경우, 반올림이 발생하지 않습니다.

예제

BirtMath.ceiling( )은 일반적으로 가격 반올림에 사용됩니다. 예를 들어, 페니와 같은 적은 금액으로 거래하는 일을 피하기 위해 다음 표현식을 사용하여 니켈에 가장 근접하도록 Price 필드의 가격을 반올림할 수 있습니다.

BirtMath.ceiling( row["Price"] , 0.05 )

가격 값이 20.52인 경우 표현식은 20.55를 리턴합니다.

다음 표현식은 다임에 가장 근접할 때까지 가격을 반올림합니다.

BirtMath.ceiling( row["Price"] , 0.1 )

가격 값이 20.52인 경우 표현식은 20.60을 리턴합니다. 가격 값이 20.40인 경우, 표현식은 20.40을 리턴합니다. 20.40은 0.1의 배수이므로 반올림되지 않습니다.

다음 표현식은 달러에 가장 근접할 때까지 가격을 반올림합니다.

BirtMath.ceiling( row["Price"] , 1 )

가격 값이 20.30인 경우 표현식은 21을 리턴합니다.

BirtMath.divide

이 함수는 한 수를 다른 수로 나눈 결과를 리턴합니다.

구문

Number BirtMath.divide( Number dividend, Number divisor )

매개변수

dividend

숫자 오브젝트. 나눌 숫자입니다.

divisor

숫자 오브젝트. 피제수를 나눈 숫자입니다.

리턴

숫자 오브젝트. 제수로 피제수를 나누어 산출된 숫자입니다.

예제

다음 예제는 특정 수를 나눈 결과를 표시합니다.

BirtMath.divide( 10, 2 ) // returns 5
BirtMath.divide( 2, 10) // returns 0.2

다음 예제는 총계 필드의 값을 Quantity 필드의 값으로 나눈 결과를 리턴합니다.

BirtMath.divide( row["Total"], row["Quantity"] )

BirtMath.mod

이 함수는 수를 제수로 나눈 후 나머지를 리턴합니다.

구문

Number BirtMath.mod( Number number, Number divisor )

매개변수

number

숫자 오브젝트. 나눌 숫자입니다.

divisor

숫자 오브젝트. 첫 번째 숫자를 나눈 숫자입니다. 0이 아닌 숫자를 지정해야 합니다.

리턴

수를 제수로 나눈 후의 나머지입니다.

예제

다음 예제는 함수가 특정 숫자에 대해 리턴한 결과를 표시합니다.

BirtMath.mod( 10, 3 ) // returns 1
BirtMath.mod( 10, 5 ) // returns 0
BirtMath.mod( 10, 6 ) // returns 4

다음 예제는 Grade 필드의 수가 홀수인지 짝수인지 확인합니다. 제수가 2인 경우, 함수는 짝수에는 0을 리턴하고 홀수에는 1을 리턴합니다.

BirtMath.mod( row["Grade"], 2 )

BirtMath.multiply

이 함수는 두 수의 곱셈을 리턴합니다.

구문

Number BirtMath.multiply( Number n1, Number n2 )

매개변수

n1

숫자 오브젝트. 계산에 사용할 첫 번째 숫자입니다.

n2

숫자 오브젝트. 계산에 사용할 두 번째 숫자입니다.

리턴

숫자 오브젝트. n1과 n2를 곱하여 산출된 숫자입니다.

예제

다음 예제는 QuantityOrdered 및 PriceEach 필드의 값을 곱한 결과를 리턴합니다.

BirtMath.multiply( row["QuantityOrdered"], row["PriceEach"] )

BirtMath.round

이 함수는 지정된 자릿수로 수를 반올림합니다.

구문

Number BirtMath.round( Number number, Number dec )

매개변수

number

숫자 오브젝트. 반올림할 숫자입니다.

dec

숫자 오브젝트. 숫자를 반올림할 자릿수입니다. 이 인수를 생략하는 경우, 함수는 0을 가정합니다.

리턴

숫자 오브젝트. 지정된 자릿수로 반올림한 숫자입니다.

예제

다음 예제는 함수가 특정 숫자에 대해 리턴한 결과를 표시합니다.

BirtMath.round( 1545.50 ) // returns 1546
BirtMath.round( 1545.56, 1 ) // returns 1545.6
BirtMath.round( 1545.23, 1 ) // returns 1545.2
BirtMath.round( 1545.50, -1 ) // returns 1550

다음 예제는 PriceEstimate 필드의 값을 반올림하여 정수를 리턴합니다.

BirtMath.round( row["PriceEstimate"], 0 )

BirtMath.roundDown

이 함수는 지정된 자릿수로 수를 내림합니다.

구문

Number BirtMath.roundDown( Number number, Number dec )

매개변수

number

숫자 오브젝트. 반올림할 숫자입니다.

dec

숫자 오브젝트. 숫자를 반내림할 자릿수입니다. 이 인수를 생략하는 경우, 함수는 0을 가정합니다.

리턴

숫자 오브젝트. 지정된 자릿수로 반내림한 숫자입니다.

예제

다음 예제는 함수가 특정 숫자에 대해 리턴한 결과를 표시합니다.

BirtMath.roundDown( 1545.50 ) // returns 1545
BirtMath.roundDown( 1545.56, 1 ) // returns 1545.5
BirtMath.roundDown( 1545.23, 1 ) // returns 1545.2
BirtMath.roundDown( 1545.50, -1 ) // returns 1540

다음 예제는 PriceEstimate 필드의 값을 반내림하여 정수를 리턴합니다.

BirtMath.roundDown( row["PriceEstimate"], 0 )

BirtMath.roundUp

이 함수는 지정된 자릿수로 수를 올림합니다.

구문

Number BirtMath.roundUp( Number number, Number dec )

매개변수

number

숫자 오브젝트. 반올림할 숫자입니다.

dec

숫자 오브젝트. 숫자를 반올림할 자릿수입니다. 이 인수를 생략하는 경우, 함수는 0을 가정합니다.

리턴

숫자 오브젝트. 지정된 자릿수로 반올림한 숫자입니다.

예제

다음 예제는 함수가 특정 숫자에 대해 리턴한 결과를 표시합니다.

BirtMath.roundUp( 1545.50 ) // returns 1546
BirtMath.roundUp( 1545.56, 1 ) // returns 1545.6
BirtMath.roundUp( 1545.23, 1 ) // returns 1545.3
BirtMath.roundUp( 1545.50, -1 ) // returns 1550

다음 예제는 PriceEstimate 필드의 값을 반올림하여 정수를 리턴합니다.

BirtMath.roundUp( row["PriceEstimate"], 0 )

BirtMath.safeDivide

이 함수는 한 숫자를 다른 숫자로 나눈 결과를 리턴하며, 0으로 나누는 조건을 사용할 수 없습니다.

구문

Number BirtMath.safeDivide( Number dividend, Number divisor, object ifZero )

매개변수

dividend

숫자 오브젝트. 나눌 숫자입니다.

divisor

숫자 오브젝트. 피제수를 나눈 숫자입니다.

ifZero

오브젝트. 제수가 0인 경우 리턴할 값입니다.

리턴

숫자 오브젝트. 제수로 피제수를 나누어 산출된 숫자입니다.

예제

다음 예제는 함수가 특정 숫자에 대해 리턴한 결과를 표시합니다.

BirtMath.safeDivide( 10, 2, 0 ) // returns 5
BirtMath.safeDivide( 10, 0, 0 ) // returns 0

다음 예제는 Revenue 필드의 값을 Volume 필드의 값으로 나눈 결과를 리턴합니다. Volume 값이 0인 경우, 함수는 0을 리턴합니다.

BirtMath.safeDivide( row["Revenue"], row["Volume"], 0 )

BirtMath.subtract

이 함수는 한 수를 다른 수에서 뺀 결과를 리턴합니다.

구문

Number BirtMath.subtract( Number n1, Number n2 )

매개변수

n1

숫자 오브젝트. 뺄 숫자입니다.

n2

숫자 오브젝트. n1에서 뺄 숫자입니다.

리턴

숫자 오브젝트. n1에서 n2를 빼 산출된 숫자입니다.

예제

다음 예제는 특정 수를 뺀 결과를 표시합니다.

BirtMath.subtract( 12, 4 ) // returns 8
BirtMath.subtract( 4, 12) // returns -8

다음 예제는 Total 필드의 값에서 Discount 필드의 값을 뺀 결과를 리턴합니다.

BirtMath.subtract( row["Total"], row["Discount"] )

(c) Copyright Actuate Corporation 2013