Int, Funções Round, RoundDown, RoundUp e Trunc

Aplica-se a: Aplicações de tela Colunas de fórmula do Dataverse Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Platform CLI

Arredonda um número.

Round, RoundDown e RoundUp

As funções Round, RoundDown e RoundUp arredondam um número para o valor especificado de casas decimais:

  • Round arredondará para cima se o dígito seguinte for 5 ou superior. Caso contrário, esta função arredonda para baixo.
  • RoundDown arredonda sempre para baixo para o número inferior anterior, no sentido do zero.
  • RoundUp arredonda sempre para cima para o número superior seguinte, afastado do zero.

O número de casas decimais que podem ser especificadas para estas funções:

Casas decimais Descrição Exemplo
Superior a 0 O número é arredondado para a direita do separador decimal. Round( 12.37, 1 ) devolve 12.4.
0 O número é arredondado para o número inteiro mais próximo. Round( 12.37, 0 ) devolve 12.
Inferior a 0 O número é arredondado para a esquerda do separador decimal. Round( 12.37, -1 ) devolve 10.

Int e Trunc

As funções Int e Trunc arredondam um número para um número inteiro (número inteiro sem decimal):

  • Int arredonda um valor para baixo até ao número inteiro mais próximo.
  • Trunc trunca o número apenas para a parte de número inteiro, removendo qualquer porção decimal.

A diferença entre Int e Trunc está no manuseamento de números negativos. Por exemplo, para um argumento de -4.3, Int vai devolver o número inteiro mais afastado do zero, -5, enquanto Trunc devolverá o número inteiro mais próximo do zero, -4. Int devolve valores únicos entre as cinco funções de arredondamento, enquanto Trunc devolve os mesmos valores que RoundDown.

Utilize Trunc para extrair a porção decimal de um número subtraindo-o do original, por exemplo X - Trunc(X).

Os lugares decimais não podem ser especificados com Trunc como podem com Microsoft Excel. Utilize RoundDown em vez disso, quando isto for necessário.

Tabelas de coluna única

Estas funções suportam tabelas de colunas únicas. Se transmitir um único número, o valor devolvido será a versão arredondada desse número. Se transmitir uma tabela de coluna única com números, o valor devolvido será uma tabela de números arredondados de coluna única. O parâmetro DecimalPlaces pode ser um único valor ou uma tabela de coluna única. Se a tabela de coluna única tiver menos valores de que o Número, zero é utilizado para os valores restantes. Utilize ShowColumns e outras funções de modelação de tabela para extrair uma tabela de coluna única de uma tabela maior.

Sintaxe

Round( Número, DecimalPlaces )
RoundDown( Número, DecimalPlaces )
RoundUp( Número, DecimalPlaces )

  • Número – Obrigatório. Número a arredondar.
  • DecimalPlaces – Obrigatório. Número de casas decimais para arredondar. Use um valor positivo para indicar lugares decimais à direita do separador decimal, um valor negativo para a esquerda e zero para um número inteiro.

Int(Número)
Trunc(Número)

  • Número – Obrigatório. O número a ser arredondado para um número inteiro.

Exemplos

Arredondando para um número inteiro.

X Round( X, 0 ) RoundUp( X, 0 ) RoundDown( X, 0 ) Int( X ) Trunc( X )
7.9 8 8 7 7 7
-7.9 -8 -8 -7 -8 -7
7.5 8 8 7 7 7
-7.5 -8 -8 -7 -8 -7
7.1 7 8 7 7 7
-7.1 -7 -8 -7 -8 -7

Arredondamento para duas casas decimais à direita do separador decimal (0.01).

X Round( X, 2 ) RoundUp( X, 2 ) RoundDown( X, 2 )
430.123 430.12 430.13 430.12
430.125 430.13 430.13 430.12
430.128 430.13 430.13 430.12

Arredondamento para duas casas decimais à esquerda do separador decimal (100).

X Round( X, -2 ) RoundUp( X, -2 ) RoundDown( X, -2 )
430.123 400 500 400
449.942 400 500 400
450.000 500 500 400
450.124 500 500 400
479.128 500 500 400

Arredondamento para uma tabela de valores de coluna única.

X Int( X ) Round( X, 2 ) RoundDown( X, [ 0, 1, 2 ] ) RoundUp( X, [ 2 ] )
[ 123,456,
987.593,
542.639 ]
[ 123,
987,
542 ]
[ 123,46,
987,59,
542.64 ]
[ 123,
987,5,
542.63 ]
[ 123,46,
988,
543 ]