Předchozí Další

Třída BirtMath

Třída BirtMath poskytuje funkce pro manipulaci s číselnými daty, například sčítání, odčítání, násobení, dělení a zaokrouhlování čísel. Číslo je generickým objektem, který lze přetypovat v poli Datový typ dialogového okna Upravit vázání dat na jiný typ. Tato třída je statická. Aplikace nemůže vytvořit instance této třídy.

BirtMath.add

Tato třída vrací součet dvou čísel.

Syntaxe

Number BirtMath.add( Number n1, Number n2 )

Parametry

n1

Objekt typu Number. První číslo, které se má použít k výpočtu.

n2

Druhé číslo, které má být použito k výpočtu.

Vrací

Objekt typu Number. Číslo, které je výsledkem součtu n1 a n2.

Příklad

Následující příklad vrací součet hodnot v polích SalesTotal a Shipping:

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

BirtMath.ceiling

Tato funkce zaokrouhluje číslo směrem od nuly k nejbližšímu zadanému násobku.

Syntaxe

Number BirtMath.ceiling( Number n, Number důležitost)

Parametry

n

Objekt typu Number. Číslo, které se má zaokrouhlit nahoru.

důležitost

Objekt typu Number. Násobek, na který má být číslo n zaokrouhleno.

Vrací

Objekt typu Number. Číslo, které je výsledkem zaokrouhlení. Je-li n celočíselným násobkem důležitosti, zaokrouhlení se neprovádí.

Příklady

BirtMath.ceiling( ) se běžně používá k zaokrouhlování cen. Chcete-li se například vyhnout manipulaci se zlomky měnové hodnoty, můžete ceny v poli Cena zaokrouhlovat na hodnoty, které lze platit nejmenšími dostupnými mincemi, například pětníky:

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

Je-li hodnota v poli Price 20,52, výraz vrátí 20,55.

Následující výraz zaokrouhluje ceny nahoru na celé desetníky:

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

Je-li hodnota v poli Price 20,52, výraz vrátí 20,60. Je-li hodnota v poli Price 20,40, výraz vrátí 20,40. K zaokrouhlení nedojde, protože 20,40 je celočíselným násobkem čísla 0,1.

Následující výraz zaokrouhluje ceny nahoru na celé dolary:

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

Je-li hodnota v poli Price 20,30, výraz vrátí 21.

BirtMath.divide

Tato funkce vrací výsledek dělení jednoho čísla druhým číslem.

Syntaxe

Number BirtMath.divide( Number dělenec, Number dělitel)

Parametry

dělenec

Objekt typu Number. Číslo, které má být vyděleno.

dělitel

Objekt typu Number. Číslo, kterým má být vydělen dělenec.

Vrací

Objekt typu Number. Číslo, které je výsledkem dělení dělence dělitelem, tj. podíl.

Příklady

Následující příklad vrací výsledky dělení specifických čísel:

BirtMath.divide( 10, 2 ) // vrací 5
BirtMath.divide( 2, 10) // vrací 0,2

Následující příklad vrací výsledek dělení hodnot v poli Total hodnotami v poli Quantity:

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

BirtMath.mod

Tato funkce vrací zbytek po vydělení čísla dělitelem.

Syntaxe

Number BirtMath.mod( Number číslo, Number dělitel)

Parametry

číslo

Objekt typu Number. Číslo, které má být vyděleno.

dělitel

Objekt typu Number. Číslo, kterým má být první číslo vyděleno. Musíte zadat nenulové číslo.

Vrací

Zbytek po vydělení čísla dělitelem.

Příklady

Následující příklad uvádí výsledky, které funkce vrací pro specifická čísla:

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

Následující příklad kontroluje, zda čísla v poli Grade jsou sudá nebo lichá. Je-li dělitel 2, funkce vrací 0 pro sudá čísla a 1 pro lichá čísla.

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

BirtMath.multiply

Tato funkce vrací výsledek vynásobení dvou čísel.

Syntaxe

Number BirtMath.multiply( Number n1, Number n2 )

Parametry

n1

Objekt typu Number. První číslo, které se má použít k výpočtu.

n2

Objekt typu Number. Druhé číslo, které má být použito k výpočtu.

Vrací

Objekt typu Number. Číslo vzniklé vynásobením čísel n1 a n2.

Příklad

Následující příklad vrací výsledek vynásobení hodnot v polích QuantityOrdered a PriceEach:

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

BirtMath.round

Tato funkce zaokrouhluje číslo směrem nahoru na zadaný počet desetinných míst.

Syntaxe

Number BirtMath.round( Number číslo, Number des )

Parametry

číslo

Objekt typu Number. Číslo, které má být zaokrouhleno.

des

Objekt typu Number. Počet desetinných míst, na které má být číslo zaokrouhleno. Pokud vynecháte tento argument, funkce bude předpokládat hodnotu 0.

Vrací

Objekt typu Number. Číslo zaokrouhlené na zadaný počet desetinných míst.

Příklady

Následující příklad uvádí výsledky, které funkce vrací pro specifická čísla:

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

Následující příklad zaokrouhluje hodnoty v polí PriceEstimate na celé číslo:

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

BirtMath.roundDown

Tato funkce zaokrouhluje číslo směrem dolů na zadaný počet desetinných míst.

Syntaxe

Number BirtMath.roundDown( Number číslo, Number des )

Parametry

číslo

Objekt typu Number. Číslo, které má být zaokrouhleno.

des

Objekt typu Number. Počet desetinných míst, na které má být číslo zaokrouhleno. Pokud vynecháte tento argument, funkce bude předpokládat hodnotu 0.

Vrací

Objekt typu Number. Číslo zaokrouhlené dolů na zadaný počet desetinných míst.

Příklady

Následující příklad uvádí výsledky, které funkce vrací pro specifická čísla:

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

Následující příklad zaokrouhluje dolů hodnoty v poli PriceEstimate na celé číslo:

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

BirtMath.roundUp

Tato funkce zaokrouhluje číslo směrem nahoru na zadaný počet desetinných míst.

Syntaxe

Number BirtMath.roundUp( Number číslo, Number des )

Parametry

číslo

Objekt typu Number. Číslo, které se má zaokrouhlit nahoru.

des

Objekt typu Number. Počet desetinných míst, na které má být číslo zaokrouhleno směrem nahoru. Pokud vynecháte tento argument, funkce bude předpokládat hodnotu 0.

Vrací

Objekt typu Number. Číslo zaokrouhlené nahoru na zadaný počet desetinných míst.

Příklady

Následující příklad uvádí výsledky, které funkce vrací pro specifická čísla:

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

Následující příklad zaokrouhluje hodnoty v poli PriceEstimate směrem nahoru na celé číslo:

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

BirtMath.safeDivide

Tato funkce vrací výsledek dělení jednoho čísla jiným číslem, přičemž zamezuje dělení nulou.

Syntaxe

Number BirtMath.safeDivide( Number dělenec, Number dělitel, object ifZero )

Parametry

dělenec

Objekt typu Number. Číslo, které má být vyděleno.

dělitel

Objekt typu Number. Číslo, kterým má být vydělen dělenec.

ifZero

Objekt. Hodnota, která má být vracena v případě, že dělitel je nulový.

Vrací

Objekt typu Number. Objekt typu Number. Číslo, které je výsledkem dělení dělence dělitelem, tj. podíl.

Příklady

Následující příklad uvádí výsledky, které tato funkce vrací pro specifická čísla:

BirtMath.safeDivide( 10, 2, 0 ) // vrací 5
BirtMath.safeDivide( 10, 0, 0 ) // vrací 0

Následující příklad vrací výsledek dělení hodnot v poli Revenue hodnotami v poli Volume. Je-li hodnota v poli Volume nulová, funkce vrací 0.

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

BirtMath.subtract

Tato funkce vrací výsledek odečtení jednoho čísla od jiného čísla.

Syntaxe

Number BirtMath.subtract( Number n1, Number n2 )

Parametry

n1

Objekt typu Number. Číslo, od kterého má být provedeno odečtení.

n2

Objekt typu Number. Číslo, které má být odečteno od čísla n1.

Vrací

Objekt typu Number. Číslo, které je výsledkem odečtení čísla n2 od čísla n1.

Příklad

Následující příklad vrací výsledky odečtení specifických čísel:

BirtMath.subtract( 12, 4 ) // vrací 8
BirtMath.subtract( 4, 12) // vrací -8

Následující příklad vrací výsledek odečtení hodnot v poli Discount od hodnot v poli Total:

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

(c) Copyright Actuate Corporation 2013