Προηγούμενο Επόμενο

Κλάση BirtMath

Η κλάση BirtMath παρέχει συναρτήσεις για το χειρισμό αριθμητικών δεδομένων, για παράδειγμα για την πρόσθεση, την αφαίρεση, τον πολλαπλασιασμό, τη διαίρεση και τη στρογγυλοποίηση αριθμών. Ο αριθμός είναι ένα γενικό αντικείμενο που μπορεί να μετατραπεί σε άλλο είδος στο πεδίο Είδος δεδομένων ή στο πλαίσιο διαλόγου Τροποποίηση δεσμού δεδομένων. Αυτή η κλάση είναι στατική. Η εφαρμογή δεν μπορεί να δημιουργήσει χρήσεις της κλάσης.

BirtMath.add

Αυτή η συνάρτηση επιστρέφει το άθροισμα δύο αριθμών.

Σύνταξη

Number BirtMath.add( n1, n2 )

Παράμετροι

n1

Αντικείμενο αριθμού. Ο πρώτος αριθμός που θα χρησιμοποιηθεί στον υπολογισμό.

n2

Ο δεύτερος αριθμός που θα χρησιμοποιηθεί στον υπολογισμό.

Επιστρέφει

Αντικείμενο αριθμού. Ο αριθμός που προκύπτει από την πρόσθεση των παραμέτρων n1 και n2.

Παράδειγμα

Το ακόλουθο παράδειγμα επιστρέφει το άθροισμα των τιμών στα πεδία SalesTotal και Shipping:

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

BirtMath.ceiling

Αυτή η συνάρτηση στρογγυλοποιεί έναν αριθμό προς τα πάνω, προς το πλησιέστερο καθορισμένο πολλαπλάσιο.

Σύνταξη

Number BirtMath.ceiling( n, πολλαπλάσιο )

Παράμετροι

n

Αντικείμενο αριθμού. Ο αριθμός που θα στρογγυλοποιηθεί προς τα πάνω.

πολλαπλάσιο

Αντικείμενο αριθμού. Το πολλαπλάσιο προς το οποίο θα στρογγυλοποιηθεί ο αριθμός n.

Επιστρέφει

Αντικείμενο αριθμού. Ένας αριθμός που προκύπτει από τη στρογγυλοποίηση. Αν ο αριθμός είναι ακριβές πολλαπλάσιο, δεν πραγματοποιείται στρογγυλοποίηση.

Παραδείγματα

Η συνάρτηση BirtMath.ceiling( ) χρησιμοποιείται συνήθως για την στρογγυλοποίηση τιμών. Για παράδειγμα, για να αποφύγετε τους υπολογισμούς με μονόλεπτα, μπορείτε να στρογγυλοποιήσετε τις τιμές στο πεδίο Price προς το κοντινότερο πεντάλεπτο με την παρακάτω έκφραση:

BirtMath.ceiling( row["Price"] , 0,05 )

Αν η τιμή Price είναι 20,52, η έκφραση επιστρέφει την τιμή 20,55.

Η ακόλουθη έκφραση στρογγυλοποιεί τις τιμές προς τα πάνω, προς το κοντινότερο δεκάλεπτο:

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

Αν η τιμή Price είναι 20,52, η έκφραση επιστρέφει την τιμή 20,60. Αν η τιμή Price είναι 20,40, η έκφραση επιστρέφει την τιμή 20,40. Δεν πραγματοποιείται στρογγυλοποίηση επειδή η τιμή 20,40 είναι πολλαπλάσιο του 0,1.

Η ακόλουθη έκφραση στρογγυλοποιεί τις τιμές προς τα πάνω, προς το κοντινότερο ευρώ:

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

Αν η τιμή Price είναι 20,30, η έκφραση επιστρέφει την τιμή 21.

BirtMath.divide

Αυτή η συνάρτηση επιστρέφει το αποτέλεσμα της διαίρεσης ενός αριθμού με έναν άλλο.

Σύνταξη

Number BirtMath.divide( διαιρετέος, διαιρέτης )

Παράμετροι

διαιρετέος

Αντικείμενο αριθμού. Ο αριθμός που θα διαιρεθεί.

διαιρέτης

Αντικείμενο αριθμού. Ο αριθμός που διαιρεί το διαιρετέο.

Επιστρέφει

Αντικείμενο αριθμού. Ένας αριθμός που προκύπτει από τη διαίρεση του διαιρετέου με το διαιρέτη.

Παραδείγματα

Το ακόλουθο παράδειγμα εμφανίζει τα αποτελέσματα της διαίρεσης συγκεκριμένων αριθμών:

BirtMath.divide( 10, 2 ) // επιστρέφει την τιμή 5
BirtMath.divide( 2, 10) // επιστρέφει την τιμή 0,2

Το ακόλουθο παράδειγμα επιστρέφει το αποτέλεσμα της διαίρεσης των τιμών στο πεδίο Total με τις τιμές στο πεδίο Quantity:

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

BirtMath.mod

Αυτή η συνάρτηση επιστρέφει το υπόλοιπο μετά τη διαίρεση ενός αριθμού με ένα διαιρέτη.

Σύνταξη

Number BirtMath.mod( αριθμός, διαιρέτης )

Παράμετροι

αριθμός

Αντικείμενο αριθμού. Ο αριθμός που θα διαιρεθεί.

διαιρέτης

Αντικείμενο αριθμού. Ο αριθμός που διαιρεί τον πρώτο αριθμό. Πρέπει να ορίσετε έναν αριθμό διαφορετικό από 0.

Επιστρέφει

Το υπόλοιπο που προκύπτει από τη διαίρεση ενός αριθμού με το διαιρέτη.

Παραδείγματα

Τα ακόλουθα παραδείγματα εμφανίζουν τα αποτελέσματα που επιστρέφει η συνάρτηση για συγκεκριμένους αριθμούς:

BirtMath.mod( 10, 3 ) // επιστρέφει την τιμή 1
BirtMath.mod( 10, 5 ) // επιστρέφει την τιμή 0
BirtMath.mod( 10, 6 ) // επιστρέφει την τιμή 4

Το ακόλουθο παράδειγμα ελέγχει αν οι αριθμοί στο πεδίο Grade είναι περιττοί ή άρτιοι. Όταν η τιμή του διαιρέτη είναι 2, η συνάρτηση επιστρέφει την τιμή 0 για τους άρτιους αριθμούς και την τιμή 1 για τους περιττούς.

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

BirtMath.multiply

Αυτή η συνάρτηση επιστρέφει το γινόμενο δύο αριθμών.

Σύνταξη

Number BirtMath.multiply( n1, n2 )

Παράμετροι

n1

Αντικείμενο αριθμού. Ο πρώτος αριθμός που θα χρησιμοποιηθεί στον υπολογισμό.

n2

Αντικείμενο αριθμού. Ο δεύτερος αριθμός που θα χρησιμοποιηθεί στον υπολογισμό.

Επιστρέφει

Αντικείμενο αριθμού. Ένας αριθμός που προκύπτει από τον πολλαπλασιασμό των αριθμών n1 και n2.

Παράδειγμα

Το ακόλουθο παράδειγμα επιστρέφει το αποτέλεσμα του πολλαπλασιασμού των τιμών στα πεδία QuantityOrdered και PriceEach:

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

BirtMath.round

Αυτή η συνάρτηση στρογγυλοποιεί έναν αριθμό σε έναν καθορισμένο αριθμό ψηφίων.

Σύνταξη

Number BirtMath.round( αριθμός, δεκαδικός )

Παράμετροι

αριθμός

Αντικείμενο αριθμού. Ο αριθμός που θα στρογγυλοποιηθεί.

δεκαδικός

Αντικείμενο αριθμού. Ο αριθμός των ψηφίων στον οποίο θα στρογγυλοποιηθεί ο αριθμός. Αν παραλείψετε αυτό το όρισμα, η συνάρτηση χρησιμοποιεί την τιμή 0.

Επιστρέφει

Αντικείμενο αριθμού. Ένας αριθμός που έχει στρογγυλοποιηθεί σε έναν συγκεκριμένο αριθμό ψηφίων.

Παραδείγματα

Τα ακόλουθα παραδείγματα εμφανίζουν τα αποτελέσματα που επιστρέφει η συνάρτηση για συγκεκριμένους αριθμούς:

BirtMath.round( 1545,50 ) // επιστρέφει την τιμή 1546
BirtMath.round( 1545,56, 1 ) // επιστρέφει την τιμή 1545,6
BirtMath.round( 1545,23, 1 ) // επιστρέφει την τιμή 1545,2
BirtMath.round( 1545,50, -1 ) // επιστρέφει την τιμή 1550

Το ακόλουθο παράδειγμα στρογγυλοποιεί τις τιμές στο πεδίο PriceEstimate ώστε να επιστραφεί ένας ακέραιος:

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

BirtMath.roundDown

Αυτή η συνάρτηση στρογγυλοποιεί προς τα κάτω έναν αριθμό σε συγκεκριμένο αριθμό ψηφίων.

Σύνταξη

Number BirtMath.roundDown( αριθμός, δεκαδικός )

Παράμετροι

αριθμός

Αντικείμενο αριθμού. Ο αριθμός που θα στρογγυλοποιηθεί.

δεκαδικός

Αντικείμενο αριθμού. Ο αριθμός των ψηφίων στον οποίο θα στρογγυλοποιηθεί ο αριθμός. Αν παραλείψετε αυτό το όρισμα, η συνάρτηση χρησιμοποιεί την τιμή 0.

Επιστρέφει

Αντικείμενο αριθμού. Ένας αριθμός που έχει στρογγυλοποιηθεί προς τα κάτω σε έναν συγκεκριμένο αριθμό ψηφίων.

Παραδείγματα

Τα ακόλουθα παραδείγματα εμφανίζουν τα αποτελέσματα που επιστρέφει η συνάρτηση για συγκεκριμένους αριθμούς:

BirtMath.roundDown( 1545,50 ) // επιστρέφει την τιμή 1545
BirtMath.roundDown( 1545,56, 1 ) // επιστρέφει την τιμή 1545,5
BirtMath.roundDown( 1545,23, 1 ) // επιστρέφει την τιμή 1545,2
BirtMath.roundDown( 1545,50, -1 ) // επιστρέφει την τιμή 1540

Το ακόλουθο παράδειγμα στρογγυλοποιεί προς τα κάτω τις τιμές στο πεδίο PriceEstimate ώστε να επιστραφεί ένας ακέραιος:

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

BirtMath.roundUp

Αυτή η συνάρτηση στρογγυλοποιεί έναν αριθμό προς τα πάνω, σε έναν καθορισμένο αριθμό ψηφίων.

Σύνταξη

Number BirtMath.roundUp( αριθμός, δεκαδικός )

Παράμετροι

αριθμός

Αντικείμενο αριθμού. Ο αριθμός που θα στρογγυλοποιηθεί προς τα πάνω.

δεκαδικός

Αντικείμενο αριθμού. Ο αριθμός των ψηφίων στον οποίο θα στρογγυλοποιηθεί ο αριθμός. Αν παραλείψετε αυτό το όρισμα, η συνάρτηση χρησιμοποιεί την τιμή 0.

Επιστρέφει

Αντικείμενο αριθμού. Ένας αριθμός που έχει στρογγυλοποιηθεί προς τα πάνω σε έναν συγκεκριμένο αριθμό ψηφίων.

Παραδείγματα

Τα ακόλουθα παραδείγματα εμφανίζουν τα αποτελέσματα που επιστρέφει η συνάρτηση για συγκεκριμένους αριθμούς:

BirtMath.roundUp( 1545,50 ) // επιστρέφει την τιμή 1546
BirtMath.roundUp( 1545,56, 1 ) // επιστρέφει την τιμή 1545,6
BirtMath.roundUp( 1545,23, 1 ) // επιστρέφει την τιμή 1545,3
BirtMath.roundUp( 1545,50, -1 ) // επιστρέφει την τιμή 1550

Το ακόλουθο παράδειγμα στρογγυλοποιεί προς τα πάνω τις τιμές στο πεδίο PriceEstimate ώστε να επιστραφεί ένας ακέραιος:

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

BirtMath.safeDivide

Αυτή η συνάρτηση επιστρέφει το αποτέλεσμα της διαίρεσης ενός αριθμού με έναν άλλο και εμποδίζει τη διαίρεση με το 0.

Σύνταξη

Number BirtMath.safeDivide( διαιρετέος, διαιρέτης, ifZero )

Παράμετροι

διαιρετέος

Αντικείμενο αριθμού. Ο αριθμός που θα διαιρεθεί.

διαιρέτης

Αντικείμενο αριθμού. Ο αριθμός που διαιρεί το διαιρετέο.

ifZero

Αντικείμενο. Η τιμή που επιστρέφεται όταν ο διαιρέτης είναι 0.

Επιστρέφει

Αντικείμενο αριθμού. Αντικείμενο αριθμού. Ένας αριθμός που προκύπτει από τη διαίρεση του διαιρετέου με το διαιρέτη.

Παραδείγματα

Το ακόλουθο παράδειγμα εμφανίζει τα αποτελέσματα που επιστρέφει η συνάρτηση για συγκεκριμένους αριθμούς:

BirtMath.safeDivide( 10, 2, 0 ) // επιστρέφει την τιμή 5
BirtMath.safeDivide( 10, 0, 0 ) // επιστρέφει την τιμή 0

Το ακόλουθο παράδειγμα επιστρέφει το αποτέλεσμα της διαίρεσης των τιμών στο πεδίο Revenue με τις τιμές στο πεδίο Volume. Αν η τιμή του πεδίου Volume είναι 0, η συνάρτηση επιστρέφει την τιμή 0.

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

BirtMath.subtract

Αυτή η συνάρτηση επιστρέφει το αποτέλεσμα της αφαίρεσης ενός αριθμού από έναν άλλο.

Σύνταξη

Number BirtMath.subtract( n1, n2 )

Παράμετροι

n1

Αντικείμενο αριθμού. Ο αριθμός από τον οποίο θα αφαιρεθεί ένας άλλος.

n2

Αντικείμενο αριθμού. Ο αριθμός που θα αφαιρεθεί από τον αριθμό n1.

Επιστρέφει

Αντικείμενο αριθμού. Ένας αριθμός που προκύπτει από την αφαίρεση του αριθμού n2 από τον αριθμό n1.

Παράδειγμα

Το ακόλουθο παράδειγμα εμφανίζει τα αποτελέσματα της αφαίρεσης συγκεκριμένων αριθμών:

BirtMath.subtract( 12, 4 ) // επιστρέφει την τιμή 8
BirtMath.subtract( 4, 12) // επιστρέφει την τιμή -8

Το ακόλουθο παράδειγμα επιστρέφει το αποτέλεσμα της αφαίρεσης των τιμών στο πεδίο Discount από τις τιμές στο πεδίο Total:

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

(c) Copyright Actuate Corporation 2013