ก่อนหน้า ถัดไป

คลาส BirtMath

คลาส BirtMath จัดเตรียมฟังก์ชันเพื่อจัดการกับข้อมูลที่เป็นตัวเลข, ตัวอย่างเช่น, เพื่อเพิ่ม, ลบ, คูณ, หาร, และปัดเศษตัวเลข ตัวเลขเป็นอ็อบเจ็กต์ที่สามารถ cast เป็นชนิดอื่นๆ ในฟิลด์ ชนิดข้อมูลของไดอะล็อก แก้ไขการโยงข้อมูล คลาสนี้เป็นแบบสแตติก แอ็พพลิเคชันไม่สามารถสร้างอินสแตนซ์ของคลาส

BirtMath.add

ฟังก์ชันนี้จะคืนค่าผลรวมของสองจำนวน

ไวยากรณ์

Number BirtMath.add( Number n1, Number n2 )

พารามิเตอร์

n1

อ็อบเจ็กต์ Number จำนวนแรกที่ต้องการใช้ในการคำนวณ

n2

จำนวนที่สองที่ต้องการใช้ในการคำนวณ

คืนค่า

อ็อบเจ็กต์ Number จำนวนที่มีผลลัพธ์มาจากการเพิ่ม n1 และ n2

ตัวอย่าง

ตัวอย่างต่อไปนี้ส่งคืนผลรวมของค่าในฟิลด์ SalesTotal และ Shipping:

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

BirtMath.ceiling

ฟังก์ชันนี้จะปัดเศษของจำนวนขึ้น (จาก 0) ให้ใกล้กับผลคูณที่สุด

ไวยากรณ์

Number BirtMath.ceiling( Number n, Number significance )

พารามิเตอร์

n

อ็อบเจ็กต์ Number จำนวนที่ต้องการปัดเศษขึ้น

significance

อ็อบเจ็กต์ Number ผลคูณที่ต้องการปัดเศษ n

คืนค่า

อ็อบเจ็กต์ Number จำนวนที่เป็นผลลัพธ์มาจากการปัดเศษ ถ้า n คือผลคูณที่มีนัยสำคัญ, จะไม่มีการปัดเศษเกิดขึ้น

ตัวอย่าง

BirtMath.ceiling( ) เป็นราคาที่ปัดขึ้นที่ใช้บ่อย ตัวอย่างเช่น, เพื่อหลีกเลี่ยงการใช้เพ็นนี, คุณสามารถปัดเศษราคาในฟิลด์ Price ขึ้นให้ใกล้เคียงกับนิกเกิลด้วยนิพจน์ต่อไปนี้:

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

ถ้าค่า ราคา คือ 20.52 นิพจน์จะคืนค่า 20.55

นิพจน์ต่อไปนี้จะปัดราคาขึ้นใกล้เคียงกับไดม์:

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

ถ้าค่า รารา คือ 20.52 นิพจน์จะคืนค่า 20.60 ถ้าค่า Price คือ 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

อ็อบเจ็กต์ Number จำนวนที่ต้องถูกหาร

divisor

อ็อบเจ็กต์ Number จำนวนที่ตัวตั้งหารถูกหาร

คืนค่า

อ็อบเจ็กต์ Number จำนวนที่เป็นผลลัพธ์มาจากการหารตัวตั้งหารด้วยตัวหาร

ตัวอย่าง

ตัวอย่างต่อไปนี้จะแสดงผลลัพธ์ของหารหารจำนวนที่ระบุ:

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

ตัวอย่างต่อไปนี้ส่งคืนผลลัพธ์ของค่าการหารในฟิดล์ Total ด้วยค่าในฟิลด์ Quantity:

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

BirtMath.mod

ฟังก์ชันนี้จะคืนค่าเศษที่เหลือหลังจากจำนวนถูกหาร

ไวยากรณ์

Number BirtMath.mod( Number number, Number divisor )

พารามิเตอร์

number

อ็อบเจ็กต์ Number จำนวนที่ต้องถูกหาร

divisor

อ็อบเจ็กต์ Number จำนวนที่ตัวเลขแรกถูกหาร คุณต้องระบุตัวเลขที่ไม่ใช่ศูนย์

คืนค่า

เศษที่เหลือจากการหาร

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงผลลัพธ์ที่ฟังก์ชันส่งคืนตัวเลขที่ระบุเฉพาะ:

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

อ็อบเจ็กต์ Number จำนวนแรกที่ต้องการใช้ในการคำนวณ

n2

อ็อบเจ็กต์ Number จำนวนที่สองที่ใช้ในการคำนวณ

คืนค่า

อ็อบเจ็กต์ Number จำนวนที่เป็นผลลัพธ์มาจากการคูณ n1 และ n2

ตัวอย่าง

ตัวอย่างต่อไปนี้ส่งคืนผลลัพธ์ของการคูณค่าในฟิลด์ QuantityOrdered และ PriceEach:

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

BirtMath.round

ฟังก์ชันนี้จะปัดจำนวนตามจำนวนหลักที่ระบุ

ไวยากรณ์

Number BirtMath.round( Number number, Number dec )

พารามิเตอร์

number

อ็อบเจ็กต์ Number จำนวนที่ต้องการปัดเศษ

dec

อ็อบเจ็กต์ Number จำนวนของดิจิตที่ต้องการปัดเศษตัวเลข ถ้าคุณละเว้นอาร์กิวเมนต์นี้, ฟังก์ชันจะสมมติว่าเป็น 0

คืนค่า

อ็อบเจ็กต์ Number จำนวนที่ปัดเศษไปเป็นจำนวนดิจิตที่ระบุไว้

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงผลลัพธ์ที่ฟังก์ชันส่งคืนตัวเลขที่ระบุเฉพาะ:

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

อ็อบเจ็กต์ Number จำนวนที่ต้องการปัดเศษ

dec

อ็อบเจ็กต์ Number จำนวนดิจิตที่ต้องการปัดเศษลง ถ้าคุณละเว้นอาร์กิวเมนต์นี้, ฟังก์ชันจะสมมติว่าเป็น 0

คืนค่า

อ็อบเจ็กต์ Number จำนวนที่ต้องถูกปัดเศษลงเป็นจำนวนดิจิตที่ถูกระบุไว้

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงผลลัพธ์ที่ฟังก์ชันส่งคืนตัวเลขที่ระบุเฉพาะ:

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

อ็อบเจ็กต์ Number จำนวนที่ต้องการปัดเศษขึ้น

dec

อ็อบเจ็กต์ Number จำนวนดิจิตที่ต้องการปัดเศษขึ้น ถ้าคุณละเว้นอาร์กิวเมนต์นี้, ฟังก์ชันจะสมมติว่าเป็น 0

คืนค่า

อ็อบเจ็กต์ Number จำนวนที่ถูกปัดเศษขึ้นเป็นจำนวนดิจิตที่ระบุไว้

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงผลลัพธ์ที่ฟังก์ชันส่งคืนตัวเลขที่ระบุเฉพาะ:

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

อ็อบเจ็กต์ Number จำนวนที่ต้องถูกหาร

divisor

อ็อบเจ็กต์ Number จำนวนที่ตัวตั้งหารถูกหาร

ifZero

Object ค่าที่ต้องการส่งคืนเมื่อตัวหารคือศูนย์

คืนค่า

อ็อบเจ็กต์ Number อ็อบเจ็กต์ Number จำนวนที่เป็นผลลัพธ์มาจากการหารตัวตั้งหารด้วยตัวหาร

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงผลลัพธ์ที่มีผลมาจากที่ฟังก์ชันส่งคืนตัวเลขที่ระบุเฉพาะ:

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

อ็อบเจ็กต์ Number จำนวนที่ต้องการลบ

n2

อ็อบเจ็กต์ Number จำนวนที่ต้องการลบออกจาก n1

คืนค่า

อ็อบเจ็กต์ Number จำนวนที่เป็นผลลัพธ์มาจากการลบ n2 จาก n1

ตัวอย่าง

ตัวอย่างต่อไปนี้จะแสดงผลลัพธ์ของการลบจำนวนที่ระบุ:

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

ตัวอย่างต่อไปนี้ส่งคืนผลลัพธ์ของค่าการลบในฟิลด์ Discount ออกจากค่าในฟิลด์ Total:

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

(c) ลิขสิทธิ์ Actuate Corporation 2013