Função de ER ROUNDAMOUNT
A função ROUNDAMOUNT
retorna um valor Real como resultado do arredondamento do número especificado para o múltiplo mais próximo de outro número de acordo com a regra de arredondamento especificada.
Sintaxe
ROUNDAMOUNT (number, decimals, round rule)
Argumentos
number
: Int ou Real
Um valor numérico que deve ser arredondado.
decimals
: Int ou Real
O valor do parâmetro number
deve ser arredondado para um múltiplo desse número.
round rule
: Valor de enumeração
Um valor de enumeração da enumeração RoundOffType que define a regra de arredondamento. Essa enumeração oferece os seguintes valores:
- Normal (Ordinary)
- Para baixo (RoundDown)
- Para cima (RoundUp)
Valores de retorno
Real
O valor numérico resultante é um múltiplo do valor especificado pelo parâmetro decimals
e está mais próximo do valor especificado pelo parâmetro number
.
Notas de uso
Quando o parâmetro number
é zero, esta função sempre retorna zero.
Quando o parâmetro decimals
é zero, esta função arredonda para o valor de arredondamento padrão. Quando o parâmetro round rule
está definido como RoundOffType.Ordinary, o valor de arredondamento padrão é 0,01. Caso contrário, o valor de arredondamento padrão é 1,0.
Quando o parâmetro round rule
está definido como RoundOffType.Ordinary, esta função arredonda para o valor de arredondamento mais próximo.
Quando o parâmetro round rule
está definido como RoundOffType.RoundDown, esta função arredonda em direção ao zero para o valor de arredondamento mais próximo.
Quando o parâmetro round rule
está definido como RoundOffType.RoundUp, esta função arredonda se afastando do zero para o valor de arredondamento mais próximo.
Quando o parâmetro round rule
está definido como RoundOffType.Ordinary, esta função se comporta como a função MROUND do Excel e a função ROUND do X++.
Comentários
Para arredondar um valor numérico para um número especificado de casas decimais, use a função ROUND.
Exemplo
Se o parâmetro model.RoundOff estiver definido como RoundOffType.Ordinary, ROUNDAMOUNT (7.45, 1.05, model.RoundOff)
retorna 7,35.
Se o parâmetro model.RoundOff estiver definido como RoundOffType.RoundDown, ROUNDAMOUNT (7.45, 1.05, model.RoundOff)
retorna 7,35.
Se o parâmetro model.RoundOff estiver definido como RoundOffType.RoundUp, ROUNDAMOUNT (7.45, 1.05, model.RoundOff)
retorna 8,4.