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

  • Artigo

Aplica-se a: Aplicativos de tela Colunas de fórmula do Dataverse Fluxos da área de trabalho Aplicativos baseados em modelo Power Platform CLI

Arredonda um número.

Round, RoundDown e RoundUp

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

  • Round arredonda para cima se o próximo dígito é 5 ou maior. Caso contrário, essa função arredonda para baixo.
  • RoundDown sempre arredonda para baixo, para o menor número anterior, em direção a zero.
  • RoundUp sempre arredonda para cima, para o próximo número maior, em direção oposta a zero.

O número de casas decimais pode ser especificado para essas funções:

Casas decimais Descrição Exemplo
Maior que 0 O número é arredondado para a direita do separador decimal. Round( 12.37, 1 ) retorna 12,4.
0 O número é arredondado para o inteiro mais próximo. Round( 12.37, 0 ) retorna 12.
Menor que 0 O número é arredondado à esquerda do separador decimal. Round( 12.37, -1 ) retorna 10.

Int e Trunc

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

  • Int arredonda para baixo até o número inteiro mais próximo.
  • Trunc trunca o número para apenas a parte inteira, removendo qualquer parte decimal.

A diferença entre Int e Trunc está no tratamento de números negativos. Por exemplo, para um argumento de -4.3, Int retornará o inteiro mais longe de zero, -5, enquanto Trunc retornará o inteiro mais próximo de zero, -4. Int retorna valores que são únicos entre as cinco funções de arredondamento, enquanto Trunc retorna os mesmos valores que RoundDown.

Use Trunc para extrair a parte decimal de um número subtraindo-o do original, como X - Trunc(X).

Casas decimais não podem ser especificadas com Trunc, já que podem com o Microsoft Excel. Use RoundDown em vez disso quando for necessário.

Tabelas de coluna única

Essas funções oferecem suporte a tabelas de coluna única. Se você passar um único número, o valor de retorno será a versão arredondada dele. Se você passar uma tabela com uma coluna contendo números, o valor de retorno será uma tabela com uma coluna de números arredondados. O parâmetro DecimalPlaces pode ser um valor único ou uma tabela de coluna única. Se a tabela de coluna única tiver menos valores que Número, zero será usado para os valores restantes. Use ShowColumns e outras funções de modelagem de tabela para extrair uma tabela de coluna única de uma tabela maior.

Sintaxe

Round( Number, DecimalPlaces )
RoundDown( Number, DecimalPlaces )
RoundUp( Number, DecimalPlaces )

  • Number - obrigatório. Número a ser arredondado.
  • DecimalPlaces - obrigatório. Número de casas decimais para arredondar. Use um valor positivo para indicar as casas decimais à direita do separador decimal, um valor negativo à esquerda e zero para um número inteiro.

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

  • Number - obrigatório. O número a ser arredondado para um 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 de 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]