| Wiki Markup |
|---|
{scrollbar}
----
h2. Clase BirtMath
La clase BirtMath proporciona funciones para manipular datos numéricos, por ejemplo, para sumar, restar, dividir, multiplicar, y redondear números.
h3. BirtMath.add
Esta función devuelve la suma de dos números.
*Sintaxis*
{code} |
...
Clase BirtMath
La clase BirtMath proporciona funciones para manipular datos numéricos, por ejemplo, para sumar, restar, dividir, multiplicar, y redondear números.
BirtMath.add
Esta función devuelve la suma de dos números.
Sintaxis
| Code Block |
|---|
BirtMath.add (n1, n2)
{code}
*Parámetros*
n1 - El primer número a utilizar en el cálculo.
n2 - El segundo número a utilizar en el cálculo.
*Devoluciones*
Un número que resulte de sumar n1 y n2.
*Ejemplo*
El ejemplo siguiente devuelve la suma de los valores en los campos SalesTotal y Shipping:
{code} |
Parámetros
n1 - El primer número a utilizar en el cálculo.
n2 - El segundo número a utilizar en el cálculo.
Devoluciones
Un número que resulte de sumar n1 y n2.
Ejemplo
El ejemplo siguiente devuelve la suma de los valores en los campos SalesTotal y Shipping:
| Code Block |
|---|
BirtMath.add( row["SalesTotal"], row["Shipping"] )
{code}
h3. |
BirtMath.ceiling
...
Esta
...
función
...
redondea
...
un
...
número
...
hacia
...
arriba,
...
alejado
...
de
...
0,
...
al
...
múltiplo
...
más
...
cercano
...
especificado.
...
Sintaxis
| Code Block |
|---|
BirtMath.ceiling (n, importancia)
{code}
*Parámetros*
n - El número a redondear al alza.
importancia - Los múltiplos para redondear n.
*Devoluciones*
Un número que resulta del redondeo. Si n es un múltiplo exacto de importancia, no se redondea.
*Ejemplos*
{code} |
Parámetros
n - El número a redondear al alza.
importancia - Los múltiplos para redondear n.
Devoluciones
Un número que resulta del redondeo. Si n es un múltiplo exacto de importancia, no se redondea.
Ejemplos
| Code Block |
|---|
BirtMath.ceiling ()
{code}
|
Se
...
utiliza
...
comúnmente
...
para
...
redondear
...
al
...
alza
...
los
...
precios.
...
| Code Block |
|---|
BirtMath.ceiling (row ["precio"], 0,05)
{code}
|
Si
...
el
...
valor
...
del
...
precio
...
es
...
20.52,
...
la
...
expresión
...
devuelve
...
20.55.
...
| Code Block |
|---|
BirtMath.ceiling (row ["precio"], 0,1)
{code}
|
Si
...
el
...
valor
...
del
...
precio
...
es
...
20.52,
...
la
...
expresión
...
devuelve
...
20.60.
...
Si
...
el
...
valor
...
del
...
precio
...
es
...
20.40,
...
la
...
expresión
...
devuelve
...
20.40.
...
No
...
hay
...
redondeo
...
se
...
debe
...
a
...
que
...
20,40
...
es
...
un
...
múltiplo
...
de
...
0,1.
...
| Code Block |
|---|
BirtMath.ceiling (row ["precio"], 1)
{code}
|
Si
...
el
...
valor
...
del
...
precio
...
es
...
20.30,
...
la
...
expresión
...
devuelve
...
21.
...
BirtMath.divide
...
Esta
...
función
...
devuelve
...
el
...
resultado
...
de
...
dividir
...
un
...
número
...
por
...
otro.
...
Sintaxis
| Code Block |
|---|
BirtMath.divide (dividendo, divisor)
{code}
*Parámetros*
dividendos - El número que se divide.
divisor - El número por el cual los dividendos se dividen.
*Devoluciones*
Un número que resulte de dividir dividendo por el divisor.
*Ejemplos*
El siguiente ejemplo muestra el resultado de dividir un número específico:
{code} |
Parámetros
dividendos - El número que se divide.
divisor - El número por el cual los dividendos se dividen.
Devoluciones
Un número que resulte de dividir dividendo por el divisor.
Ejemplos
El siguiente ejemplo muestra el resultado de dividir un número específico:
| Code Block |
|---|
BirtMath.divide (10, 2) // devuelve 5
BirtMath.divide (2, 10) // devuelve 0.2
{code}
|
El
...
ejemplo
...
siguiente
...
devuelve
...
el
...
resultado
...
de
...
dividir
...
los
...
valores
...
del
...
campo
...
total
...
de
...
valores
...
en
...
el
...
campo
...
Cantidad:
...
| Code Block |
|---|
BirtMath.divide (row ["total"], row ["Cantidad"])
{code}
h3. |
BirtMath.mod
...
Esta
...
función
...
devuelve
...
el
...
resto
...
después
...
de
...
dividir
...
un
...
número
...
por
...
un
...
divisor.
...
Sintaxis
| Code Block |
|---|
BirtMath.mod (número, divisor)
{code}
*Parámetros*
número - El número que se divide.
divisor - El número por el cual el primer número está dividido. Debe especificar un número distinto de cero.
*Devoluciones*
El resto después de dividir un número por el divisor.
*Ejemplos*
Los siguientes ejemplos muestran los resultados que devuelve la función de números específicos:
{code} |
Parámetros
número - El número que se divide.
divisor - El número por el cual el primer número está dividido. Debe especificar un número distinto de cero.
Devoluciones
El resto después de dividir un número por el divisor.
Ejemplos
Los siguientes ejemplos muestran los resultados que devuelve la función de números específicos:
| Code Block |
|---|
BirtMath.mod (10, 3) // devuelve 1
BirtMath.mod (10, 5) // devuelve 0
BirtMath.mod (10, 6) // devuelve 4
{code}
|
El
...
siguiente
...
ejemplo
...
comprueba
...
si
...
los
...
números
...
en
...
el
...
campo
...
de
...
grado
...
son
...
pares
...
o
...
impares.
...
Cuando
...
el
...
divisor
...
es
...
2,
...
la
...
función
...
devuelve
...
0
...
para
...
los
...
números
...
pares,
...
y
...
1
...
para
...
números
...
impares.
...
| Code Block |
|---|
BirtMath.mod (row ["Grado"], 2)
{code}
h3. |
BirtMath.multiply
...
Esta
...
función
...
devuelve
...
la
...
multiplicación
...
de
...
dos
...
números.
...
Sintaxis
| Code Block |
|---|
BirtMath.multiply (n1, n2)
{code}
*Parámetros*
n1 - El primer número a utilizar en el cálculo.
n2 - El segundo número a utilizar en el cálculo.
*Devoluciones*
Un número que resulte de multiplicar n1 y n2.
*Ejemplo*
En el ejemplo siguiente se devuelve el resultado de multiplicar los valores en los campos QuantityOrdered y PriceEach:
{code} |
Parámetros
n1 - El primer número a utilizar en el cálculo.
n2 - El segundo número a utilizar en el cálculo.
Devoluciones
Un número que resulte de multiplicar n1 y n2.
Ejemplo
En el ejemplo siguiente se devuelve el resultado de multiplicar los valores en los campos QuantityOrdered y PriceEach:
| Code Block |
|---|
BirtMath.multiply (row ["QuantityOrdered"], row ["PriceEach"])
{code}
h3. |
BirtMath.round
...
Esta
...
función
...
redondea
...
un
...
número
...
a
...
un
...
número
...
determinado
...
de
...
dígitos.
...
Sintaxis
| Code Block |
|---|
BirtMath.round (número, dec)
{code}
*Parámetros*
número - El número para el redondeo.
dec - El número de dígitos de redondeo para todo el número. Si se omite este argumento, la función supone 0.
*Devoluciones*
Un número redondeado a un número determinado de dígitos.
*Ejemplos*
Los siguientes ejemplos muestran los resultados que devuelve la función de números específicos:
{code} |
Parámetros
número - El número para el redondeo.
dec - El número de dígitos de redondeo para todo el número. Si se omite este argumento, la función supone 0.
Devoluciones
Un número redondeado a un número determinado de dígitos.
Ejemplos
Los siguientes ejemplos muestran los resultados que devuelve la función de números específicos:
| Code Block |
|---|
BirtMath.round (1.545,50) // devuelve 1546
BirtMath.round (1545,56, 1) // devuelve 1545.6
BirtMath.round (1545,23, 1) // devuelve 1545.2
BirtMath.round (1.545,50, -1) // devuelve 1550
{code}
|
Las
...
rondas
...
siguiente
...
ejemplo
...
los
...
valores
...
en
...
el
...
campo
...
PriceEstimate
...
para
...
devolver
...
un
...
número
...
entero:
...
| Code Block |
|---|
BirtMath.round (row ["PriceEstimate"], 0)
{code}
h3. |
BirtMath.roundDown
...
Esta
...
función
...
redondea
...
un
...
número
...
a
...
un
...
número
...
determinado
...
de
...
dígitos.
...
Sintaxis
| Code Block |
|---|
BirtMath.roundDown (número, dec)
{code}
*Parámetros*
número - El número para el redondeo.
dec - El número de dígitos de redondeo para todo el número. Si se omite este argumento, la función supone 0.
*Devoluciones*
Un número redondeado a un número determinado de dígitos.
*Ejemplos*
Los siguientes ejemplos muestran los resultados que devuelve la función de números específicos:
{code} |
Parámetros
número - El número para el redondeo.
dec - El número de dígitos de redondeo para todo el número. Si se omite este argumento, la función supone 0.
Devoluciones
Un número redondeado a un número determinado de dígitos.
Ejemplos
Los siguientes ejemplos muestran los resultados que devuelve la función de números específicos:
| Code Block |
|---|
BirtMath.roundDown (1.545,50) // devuelve 1545
BirtMath.roundDown (1545,56, 1) // devuelve 1545.5
BirtMath.roundDown (1545,23, 1) // devuelve 1545.2
BirtMath.roundDown (1.545,50, -1) // devuelve 1540
{code}
|
Las
...
rondas
...
de
...
ejemplo
...
siguiente
...
se
...
establecen
...
los
...
valores
...
en
...
el
...
campo
...
PriceEstimate
...
para
...
devolver
...
un
...
número
...
entero:
...
| Code Block |
|---|
BirtMath.roundDown (row ["PriceEstimate"], 0)
{code}
h3. |
BirtMath.roundUp
...
Esta
...
función
...
redondea
...
un
...
número
...
hasta
...
un
...
número
...
determinado
...
de
...
dígitos.
...
Sintaxis
| Code Block |
|---|
BirtMath.roundUp (número, dec)
{code}
*Parámetros*
número - El número para el redondeo.
\\
dec - El número de dígitos de redondeo para todo el número. Si se omite este argumento, la función supone 0.
*Devoluciones*
Un número redondeado a un número determinado de dígitos.
*Ejemplos*
Los siguientes ejemplos muestran los resultados que devuelve la función de números específicos:
{code} |
Parámetros
número - El número para el redondeo.
dec - El número de dígitos de redondeo para todo el número. Si se omite este argumento, la función supone 0.
Devoluciones
Un número redondeado a un número determinado de dígitos.
Ejemplos
Los siguientes ejemplos muestran los resultados que devuelve la función de números específicos:
| Code Block |
|---|
BirtMath.roundUp (1.545,50) // devuelve 1546
BirtMath.roundUp (1545,56, 1) // devuelve 1545.6
BirtMath.roundUp (1545,23, 1) // devuelve 1545.3
BirtMath.roundUp (1.545,50, -1) // devuelve 1550
{code}
|
Las
...
rondas
...
de
...
ejemplo
...
el
...
seguimiento
...
de
...
los
...
valores
...
en
...
el
...
campo
...
PriceEstimate
...
para
...
devolver
...
un
...
número
...
entero:
...
| Code Block |
|---|
BirtMath.roundUp (row ["PriceEstimate"], 0)
{code}
h3. |
BirtMath.safeDivide
...
Esta
...
función
...
devuelve
...
el
...
resultado
...
de
...
dividir
...
un
...
número
...
por
...
otro,
...
evitar
...
una
...
división
...
por
...
cero
...
condición.
...
Sintaxis
| Code Block |
|---|
BirtMath.safeDivide (dividendo, divisor, ifZero)
{code}
*Parámetros*
dividendos - El número que se divide.
divisor - El número por el cual los dividendos se dividen.
ifZero - El valor que se devolverá cuando el divisor es cero.
*Devoluciones*
Un número que resulte de dividir dividendo por el divisor.
*Ejemplos*
El siguiente ejemplo muestra los resultados que devuelve la función de números específicos:
{code} |
Parámetros
dividendos - El número que se divide.
divisor - El número por el cual los dividendos se dividen.
ifZero - El valor que se devolverá cuando el divisor es cero.
Devoluciones
Un número que resulte de dividir dividendo por el divisor.
Ejemplos
El siguiente ejemplo muestra los resultados que devuelve la función de números específicos:
| Code Block |
|---|
BirtMath.safeDivide (10, 2, 0) // devuelve 5
BirtMath.safeDivide (10, 0, 0) // devuelve 0
{code}
|
En
...
el
...
ejemplo
...
siguiente
...
se
...
devuelve
...
el
...
resultado
...
de
...
dividir
...
los
...
valores
...
en
...
el
...
ámbito
...
de
...
los
...
ingresos
...
por
...
valores
...
en
...
el
...
campo
...
de
...
volumen.
...
Si
...
el
...
valor
...
de
...
volumen
...
es
...
0,
...
la
...
función
...
devuelve
...
0.
...
| Code Block |
|---|
BirtMath.safeDivide (row ["Ingresos"], row ["Volumen"], 0)
{code}
h3. |
BirtMath.subtract
...
Esta
...
función
...
devuelve
...
el
...
resultado
...
de
...
restar
...
un
...
número
...
de
...
otro.
...
Sintaxis
| Code Block |
|---|
BirtMath.subtract (n1, n2)
{code}
*Parámetros*
n1 - El número de los que a restar.
n2 - El número a restar de n1.
*Devoluciones*
Un número que resulta de restar n2 de n1.
*Ejemplo*
El siguiente ejemplo muestra los resultados de restar números específicos:
{code} |
Parámetros
n1 - El número de los que a restar.
n2 - El número a restar de n1.
Devoluciones
Un número que resulta de restar n2 de n1.
Ejemplo
El siguiente ejemplo muestra los resultados de restar números específicos:
| Code Block |
|---|
BirtMath.subtract (12, 4) // devuelve 8
BirtMath.subtract (4, 12) // devuelve -8
{code}
|
En
...
el
...
ejemplo
...
siguiente
...
se
...
devuelve
...
el
...
resultado
...
de
...
restar
...
descuento
...
del
...
total:
...
| Code Block |
|---|
BirtMath.subtract (row ["total"], row ["Descuento"])
{code}
----
|
...
| Wiki Markup |
|---|
{scrollbar} |