Vorige Volgende

Klasse BirtMath

De klasse BirtMath biedt functies voor het bewerken van numerieke gegevens, zoals het optellen, aftrekken, vermenigvuldigen, delen en afronden van getallen. Een getal is een generiek object dat kan worden gecast naar een ander type in het veld Gegevenstype van het venster Gegevensbinding bewerken. Dit is een statische klasse. De toepassing kan geen instances van de klasse maken.

BirtMath.add

Deze functie berekent het som van twee getallen.

Syntaxis

BirtMath.add( n1, n2 )

Parameters

n1

Getalsobject. Het eerste getal dat in de berekening wordt gebruikt.

n2

Het tweede getal dat in de berekening wordt gebruikt.

Resultaat

Getalsobject. De uitkomst van het optellen van n1 en n2.

Voorbeeld

In het volgende voorbeeld wordt de som berekend van de waarden in de velden SalesTotal en Shipping:

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

BirtMath.ceiling

Deze functie rond een getal naar boven af naar het dichtstbijzijnde opgegeven veelvoud.

Syntaxis

BirtMath.ceiling( n, significantie )

Parameters

n

Getalsobject. Het af te ronden getal.

significantie

Getalsobject. Het veelvoud waarop moet worden afgerond.

Resultaat

Getalsobject. De uitkomst van de afronding. Als n een exact veelvoud van de significantie is, wordt er geen afronding uitgevoerd.

Voorbeelden

BirtMath.ceiling( ) wordt meestal gebruikt om prijzen af te ronden. Als u bijvoorbeeld niet met centen wilt werken, kunt u met de volgende expressie de prijzen in het veld Price naar de eerste stuiver afronden:

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

Als de waarde van Price 20,52 is, is het resultaat van de expressie 20,55.

Met de volgende expressie worden prijzen afgerond tot het eerste dubbeltje:

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

Als de waarde van Price 20,52 is, is het resultaat van de expressie 20,60. Als de waarde van Price 20,40 is, is het resultaat van de expressie 20,40. Er wordt geen afronding uitgevoerd, omdat 20,40 is een veelvoud van 0,1 is.

Met de volgende expressie worden prijzen afgerond tot de eerste euro:

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

Als de waarde van Price 20,30 is, is het resultaat van de expressie 21.

BirtMath.divide

Deze functie voert een deling van een getal door een ander getal uit.

Syntaxis

BirtMath.divide( teller, noemer )

Parameters

teller

Getalsobject. Het getal dat gedeeld wordt.

noemer

Getalsobject. Het getal waardoor de teller wordt gedeeld.

Resultaat

Getalsobject. Het getal dat bij deling van de teller door de noemer ontstaat.

Voorbeelden

In het volgende voorbeeld worden specifieke getallen gedeeld:

BirtMath.divide( 10, 2 ) // retourneert 5
BirtMath.divide( 2, 10) // retourneert 0,2

In het volgende voorbeeld worden de tellerwaarden in het veld Total gedeeld door de waarden in het veld Quantity:

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

BirtMath.mod

Het resultaat van deze functie is de restwaarde die overblijft als een teller door een noemer wordt gedeeld.

Syntaxis

BirtMath.mod( getal, noemer )

Parameters

getal

Getalsobject. Het getal dat gedeeld wordt.

noemer

Getalsobject. Het getal waardoor het eerste getal wordt gedeeld. Dit getal mag niet gelijk zijn aan nul.

Resultaat

De restwaarde die overblijft als een teller door een noemer wordt gedeeld.

Voorbeelden

De volgende voorbeelden tonen het resultaat van de functie voor specifieke getallen:

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

In het volgende voorbeeld wordt gecontroleerd of de getallen in het veld Grade oneven of even zijn. Als de noemer 2 is, retourneert de functie 0 voor even getallen en 1 voor oneven getallen.

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

BirtMath.multiply

Deze functie berekent het product van twee getallen.

Syntaxis

BirtMath.multiply( getal, noemer )

Parameters

n1

Getalsobject. Het eerste getal dat in de berekening wordt gebruikt.

n2

Getalsobject. Het tweede getal dat in de berekening wordt gebruikt.

Resultaat

Getalsobject. De uitkomst van het vermenigvuldigen van n1 en n2.

Voorbeeld

Het resultaat van het volgende voorbeeld is het product van de waarden in de velden QuantityOrdered en PriceEach:

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

BirtMath.round

Deze functie rondt een getal af op een opgegeven aantal cijfers.

Syntaxis

BirtMath.round( getal, dec )

Parameters

getal

Getalsobject. Het af te ronden getal.

dec

Getalsobject. Het aantal decimalen waarop het getal wordt afgerond. Als u dit argument weglaat, maakt de functie gebruik van de waarde 0.

Resultaat

Getalsobject. Een getal dat is afgerond op het opgegeven aantal decimalen.

Voorbeelden

De volgende voorbeelden tonen het resultaat van de functie voor specifieke getallen:

BirtMath.round( 1545,50 ) // retourneert 1546
BirtMath.round( 1545,56, 1 ) // retourneert 1545,6
BirtMath.round( 1545,23, 1 ) // retourneert 1545,2
BirtMath.round( 1545,50, -1 ) // retourneert 1550

In het volgende voorbeeld worden de waarden in het veld PriceEstimate afgerond en wordt er een geheel getal geretourneerd:

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

BirtMath.roundDown

Deze functie rondt een getal naar beneden af op een opgegeven aantal cijfers.

Syntaxis

BirtMath.roundDown( getal, dec )

Parameters

getal

Getalsobject. Het af te ronden getal.

dec

Getalsobject. Het aantal decimalen waarop het getal naar beneden wordt afgerond. Als u dit argument weglaat, maakt de functie gebruik van de waarde 0.

Resultaat

Getalsobject. Een getal dat naar beneden is afgerond op het opgegeven aantal decimalen.

Voorbeelden

De volgende voorbeelden tonen het resultaat van de functie voor specifieke getallen:

BirtMath.roundDown( 1545,50 ) // retourneert 1545
BirtMath.roundDown( 1545,56, 1 ) // retourtneert 1545,5
BirtMath.roundDown( 1545,23, 1 ) // retourneert 1545,2
BirtMath.roundDown( 1545,50, -1 ) // retourneert 1540

In het volgende voorbeeld worden de waarden in het veld PriceEstimate naar beneden afgerond en wordt er een geheel getal geretourneerd:

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

BirtMath.roundUp

Deze functie rondt een getal naar boven af op een opgegeven aantal cijfers.

Syntaxis

BirtMath.roundUp( getal, dec )

Parameters

getal

Getalsobject. Het af te ronden getal.

dec

Getalsobject. Het aantal decimalen waarop het getal naar boven wordt afgerond. Als u dit argument weglaat, maakt de functie gebruik van de waarde 0.

Resultaat

Getalsobject. Een getal dat naar boven is afgerond op het opgegeven aantal decimalen.

Voorbeelden

De volgende voorbeelden tonen het resultaat van de functie voor specifieke getallen:

BirtMath.roundUp( 1545,50 ) // retourneert 1546
BirtMath.roundUp( 1545,56, 1 ) // retourneert 1545,6
BirtMath.roundUp( 1545,23, 1 ) // retourneert 1545,3
BirtMath.roundUp( 1545,50, -1 ) // retourneert 1550

In het volgende voorbeeld worden de waarden in het veld PriceEstimate naar boven afgerond en wordt er een geheel getal geretourneerd:

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

BirtMath.safeDivide

Deze functie voert een deling van een getal door een ander getal uit, waarbij wordt voorkómen dat er wordt gedeeld door nul.

Syntaxis

BirtMath.safeDivide( teller, noemer, alsNul )

Parameters

teller

Getalsobject. Het getal dat gedeeld wordt.

noemer

Getalsobject. Het getal waardoor de teller wordt gedeeld.

alsNul

Object. De waarde die moet worden geretourneerd als de noemer nul is.

Resultaat

Getalsobject. Getalsobject. Het getal dat bij deling van de teller door de noemer ontstaat.

Voorbeelden

Het volgende voorbeeld toont het resultaat van de functie voor specifieke getallen:

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

In het volgende voorbeeld worden de tellerwaarden in het veld Revenue gedeeld door de waarden in het veld Volume. Als de Volume-waarde 0 is, is het resultaat van de functie 0.

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

BirtMath.subtract

Deze functie trekt een getal van een ander getal af.

Syntaxis

BirtMath.subtract( n1, n2 )

Parameters

n1

Getalsobject. Het getal waarvan het tweede getal wordt afgetrokken.

n2

Getalsobject. Het getal dat van het eerste getal wordt afgetrokken.

Resultaat

Getalsobject. Het resultaat als n2 wordt afgetrokken van n1.

Voorbeeld

In het volgende voorbeeld wordt het verschil van specifieke getallen berekend:

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

In het volgende voorbeeld worden de waarden in het veld Discount afgetrokken van de waarden in het veld Total:

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

(c) Copyright Actuate Corporation 2013