Edellinen Seuraava

BirtMath-luokka

BirtMath-luokan funktioiden avulla voit käsitellä numeerisia tietoja esimerkiksi tekemällä yhteen-, vähennys-, kerto- ja jakolaskuja sekä pyöristämällä lukuja. Luku on yleisobjekti, jonka lajia voidaan vaihtaa Muokkaa tietosidosta -valintaikkunan Tietolaji-kentässä. Tämä luokka on staattinen. Sovellus ei voi luoda luokan ilmentymiä.

BirtMath.add

Tämä funktio palauttaa kahden luvun summan.

Syntaksi

Luku BirtMath.add( luku n1, luku n2 )

Parametrit

n1

Lukuobjekti. Ensimmäinen laskussa käytettävä luku.

n2

Toinen laskussa käytettävä luku.

Palautukset

Lukuobjekti. Lukujen n1 ja n2 summa.

Esimerkki

Seuraava esimerkki palauttaa SalesTotal (Kokonaismyynti)- ja Shipping-kenttien (Toimitus) arvojen summan:

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

BirtMath.ceiling

Tämä funktio pyöristää luvun ylöspäin, nollasta poispäin, lähimpään määritettyyn kerrannaiseen.

Syntaksi

Luku BirtMath.ceiling( luku n, luvun kerrannainen )

Parametrit

n

Lukuobjekti. Ylöspäin pyöristettävä luku.

Kerrannainen

Lukuobjekti. Kerrannainen, johon n-argumentin mukainen luku pyöristetään.

Palautukset

Lukuobjekti. Pyöristyksen tuloksena saatava luku. Jos n on tarkka merkitsevä kerrannainen, pyöristystä ei tehdä.

Esimerkkejä

BirtMath.ceiling( )-funktiota käytetään yleisesti hintojen ylöspäin pyöristykseen. Voit esimerkiksi välttää senttien käsittelyn pyöristämällä Price (Hinta) -kentän arvot lähimpään viisisenttiseen seuraavalla lausekkeella:

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

Jos hinta on 20,52, lauseke palauttaa arvon 20,55.

Seuraavalla lausekkeella pyöristetään hinnat ylöspäin lähimpään kymmensenttiseen:

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

Jos hinta on 20,52, lauseke palauttaa arvon 20,60. Jos hinta on 20,40, lauseke palauttaa arvon 20,40. Pyöristystä ei tehdä, koska 20,40 on 0,1:n kerrannainen.

Seuraavalla lausekkeella pyöristetään hinnat ylöspäin lähimpään euroon:

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

Jos hinta on 20,30, lauseke palauttaa arvon 21.

BirtMath.divide

Tämä funktio palauttaa kahden arvon jakotuloksen.

Syntaksi

Luku BirtMath.divide( luku [jaettava], luku [jakaja] )

Parametrit

jaettava

Lukuobjekti. Jaettava luku.

jakaja

Lukuobjekti. Luku, jolla jaettava luku jaetaan.

Palautukset

Lukuobjekti. Osamäärä, joka saadaan, kun jaettava jaetaan jakajalla.

Esimerkkejä

Seuraavissa esimerkeissä esitellään määrättyjen lukujen jakolaskujen tulokset:

BirtMath.divide( 10, 2 ) // palauttaa arvon 5
BirtMath.divide( 2, 10) // palauttaa arvon 0,2

Seuraava esimerkki palauttaa luvut, jotka saadaan jakamalla Total-kentän (Summa) arvot Quantity-kentän (Määrä) arvoilla:

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

BirtMath.mod

Tämä funktio palauttaa jakojäännöksen, joka saadaan, kun jaettava jaetaan jakajalla.

Syntaksi

Luku BirtMath.mod( luku [luku], luku [jakaja] )

Parametrit

luku

Lukuobjekti. Jaettava luku.

jakaja

Lukuobjekti. Luku, jolla ensimmäinen luku jaetaan. Luku ei saa olla nolla.

Palautukset

Jakojäännös, joka saadaan, kun jaettava jaetaan jakajalla.

Esimerkkejä

Seuraavissa esimerkeissä esitellään tulokset, jotka funktio palauttaa määrättyjä lukuja käytettäessä:

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

Seuraavassa esimerkissä tarkistetaan, ovatko Grade-kentän (Arvosana) arvot parillisia vai parittomia. Kun jakaja on 2, funktio palauttaa arvon 0, jos luku on parillinen, tai arvon 1, jos luku on pariton.

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

BirtMath.multiply

Tämä funktio palauttaa kahden luvun tulon.

Syntaksi

Luku BirtMath.multiply( luku n1, luku n2 )

Parametrit

n1

Lukuobjekti. Ensimmäinen laskussa käytettävä luku.

n2

Lukuobjekti. Toinen laskussa käytettävä luku.

Palautukset

Lukuobjekti. Lukujen n1 ja n2 tulo.

Esimerkki

Seuraava esimerkki palauttaa QuantityOrdered (Tilausmäärä)- ja PriceEach-kenttien (Kappalehinta) arvojen tulot:

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

BirtMath.round

Tämä funktio pyöristää luvun määritettyyn desimaalitarkkuuteen.

Syntaksi

Luku BirtMath.round( luku [luku], luku [desimaalitarkkuus] )

Parametrit

luku

Lukuobjekti. Pyöristettävä luku.

desimaalit

Lukuobjekti. Desimaalitarkkuus, johon luku pyöristetään. Jos argumenttia ei ole määritetty, funktio käyttää arvoa 0.

Palautukset

Lukuobjekti. Määritettyyn desimaalitarkkuuteen pyöristetty luku.

Esimerkkejä

Seuraavissa esimerkeissä esitellään tulokset, jotka funktio palauttaa määrättyjä lukuja käytettäessä:

BirtMath.round( 1545.50 ) // palauttaa arvon 1546
BirtMath.round( 1545.56, 1 ) // palauttaa arvon 1545,6
BirtMath.round( 1545.23, 1 ) // palauttaa arvon 1545,2
BirtMath.round( 1545.50, -1 ) // palauttaa arvon 1550

Seuraavassa esimerkissä pyöristetään PriceEstimate-kentän (Hinta-arvio) arvot niin, että funktio palauttaa kokonaislukuja:

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

BirtMath.roundDown

Tämä funktio pyöristää luvun alaspäin määritettyyn desimaalitarkkuuteen.

Syntaksi

Luku BirtMath.roundDown( luku [luku], luku [desimaalitarkkuus] )

Parametrit

luku

Lukuobjekti. Pyöristettävä luku.

desimaalit

Lukuobjekti. Luvun alaspäin pyöristyksen desimaalitarkkuus. Jos argumenttia ei ole määritetty, funktio käyttää arvoa 0.

Palautukset

Lukuobjekti. Alaspäin määritettyyn desimaalitarkkuuteen pyöristetty luku.

Esimerkkejä

Seuraavissa esimerkeissä esitellään tulokset, jotka funktio palauttaa määrättyjä lukuja käytettäessä:

BirtMath.roundDown( 1545.50 ) // palauttaa arvon 1545
BirtMath.roundDown( 1545.56, 1 ) // palauttaa arvon 1545,5
BirtMath.roundDown( 1545.23, 1 ) // palauttaa arvon 1545,2
BirtMath.roundDown( 1545.50, -1 ) // palauttaa arvon 1540

Seuraavassa esimerkissä pyöristetään PriceEstimate-kentän (Hinta-arvio) arvot alaspäin niin, että funktio palauttaa kokonaislukuja:

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

BirtMath.roundUp

Tämä funktio pyöristää luvun ylöspäin määritettyyn desimaalitarkkuuteen.

Syntaksi

Luku BirtMath.roundUp( luku [luku], luku [desimaalitarkkuus] )

Parametrit

luku

Lukuobjekti. Ylöspäin pyöristettävä luku.

desimaalit

Lukuobjekti. Luvun ylöspäin pyöristyksen desimaalitarkkuus. Jos argumenttia ei ole määritetty, funktio käyttää arvoa 0.

Palautukset

Lukuobjekti. Ylöspäin määritettyyn desimaalitarkkuuteen pyöristetty luku.

Esimerkkejä

Seuraavissa esimerkeissä esitellään tulokset, jotka funktio palauttaa määrättyjä lukuja käytettäessä:

BirtMath.roundUp( 1545.50 ) // palauttaa arvon 1546
BirtMath.roundUp( 1545.56, 1 ) // palauttaa arvon 1545,6
BirtMath.roundUp( 1545.23, 1 ) // palauttaa arvon 1545,3
BirtMath.roundUp( 1545.50, -1 ) // palauttaa arvon 1550

Seuraavassa esimerkissä pyöristetään PriceEstimate-kentän (Hinta-arvio) arvot ylöspäin niin, että funktio palauttaa kokonaislukuja:

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

BirtMath.safeDivide

Tämä funktio palauttaa kahden arvon jakotuloksen ja estää nollalla jaon.

Syntaksi

Luku BirtMath.safeDivide( luku [jaettava], luku [jakaja], objekti ifZero )

Parametrit

jaettava

Lukuobjekti. Jaettava luku.

jakaja

Lukuobjekti. Luku, jolla jaettava luku jaetaan.

nolla-arvo

Objekti. Arvo, jonka järjestelmä palauttaa, kun jakaja on nolla.

Palautukset

Lukuobjekti. Lukuobjekti. Osamäärä, joka saadaan, kun jaettava jaetaan jakajalla.

Esimerkkejä

Seuraavassa esimerkissä esitellään tulos, jonka funktio palauttaa määrättyjä lukuja käytettäessä:

BirtMath.safeDivide( 10, 2, 0 ) // palauttaa arvon 5
BirtMath.safeDivide( 10, 0, 0 ) // palauttaa arvon 0

Seuraava esimerkki palauttaa luvut, jotka saadaan jakamalla Revenue-kentän (Liikevaihto) arvot Volume-kentän (Määrä) arvoilla. Jos määrä on 0, funktio palauttaa arvon 0.

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

BirtMath.subtract

Tämä funktio palauttaa kahden arvon vähennyslaskun tuloksen.

Syntaksi

Luku BirtMath.subtract( luku n1, luku n2 )

Parametrit

n1

Lukuobjekti. Luku, josta toinen luku vähennetään.

n2

Lukuobjekti. N1-arvosta vähennettävä luku.

Palautukset

Lukuobjekti. Luku, joka saadaan vähentämällä n2-argumentin mukainen luku n1-argumentin mukaisesta luvusta.

Esimerkki

Seuraavissa esimerkeissä esitellään määrättyjen lukujen vähennyslaskujen tulokset:

BirtMath.subtract( 12, 4 ) // palauttaa arvon 8
BirtMath.subtract( 4, 12) // palauttaa arvon -8

Seuraava esimerkki palauttaa luvut, jotka saadaan vähentämällä Discount-kentän (Alennus) arvot Total-kentän (Summa) arvoista:

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

(c) Copyright Actuate Corporation 2013