Arredonda um valor numérico até uma quantidade especificada de casas decimais.

Sintaxe

Round( < nValue >, < nPoint > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

nValue

numérico

Indica o valor que será arredondado.

X


nPoint

numérico

Indica o número de casas decimais para arredondamento.

X


Retorno

Nome

Tipo

Descrição

nRet

numérico

Retorna um valor numérico arredondado.

Observações

  • A precisão do valor de nRet é de 7 dígitos significativos.
  • Caso a chave FloatingPointPrecise, na seção General do arquivo INI do TOTVS | Application Server, tenha o valor 1, a precisão de nRet aumenta para 15 dígitos significativos.

Exemplos

Exemplo 1
user function round1()
  nValue := 14.123456
  conout( Round( nValue, 0 ) ) // Resultado: 14
  conout( Round( nValue, 1 ) ) // Resultado: 14.1
  conout( Round( nValue, 2 ) ) // Resultado: 14.12
  conout( Round( nValue, 3 ) ) // Resultado: 14.123
return

Exemplos

Exemplo 1
user function round2()
  nValor := 7777.666
  MsgAlert( ROUND(nValor, 0) )         // Resulta 7778.00000
  MsgAlert( ROUND(nValor, -1) )        // Resulta 7780.00000
  MsgAlert( ROUND(nValor, -2) )        // Resulta 7800.00000
  MsgAlert( ROUND(nValor, -3) )        // Resulta 8000.00000
return

Abrangência

Microsiga Protheus 8.11, Protheus 10, Protheus 11, Protheus 12

Veja também

  • Sem rótulos