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

Aplica-se a: Aplicativos Canvas Dataverse Colunas de fórmula Fluxos de desktop Aplicativos baseados em modelo Power Pages 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 for 5 ou maior. Caso contrário, essa função arredonda para baixo.
• RoundDown sempre arredonda para baixo, para o número menor anterior, em direção a zero.
• RoundUp sempre arredonda para o próximo número mais alto, longe de 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 para o 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 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

Redondo(Número, CasasDecimais)
Arredondar para baixo(Número, Casas decimais)
Arredondamento(Número, Casas Decimais)

• Número - 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)
Truncar(Número)

• Número - 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]