TOTVSTEC

Árvore de páginas

Realiza rescale de um decimal de ponto fixo

Sintaxe

DEC_RESCALE( < dNum >, < nScale >, [ nRound ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

dNum

decimal de ponto fixo

Indica o número que deve ser reescalonado.

X

 

nScale

numérico

Indica a nova escala do número.

X

 

nRound

numérico

Indica o tipo de rescale.

 

 

Retorno

Nome

Tipo

Descrição

dRet

decimal de ponto fixo

Retorna o número reescalonado.

Observações

  • Os tipos de rescale disponíveis são:

    Número

    Exemplo

    0 - Arredonda 5 para cima

    Realiza o arredondamento tornando .5 em 1

    1 - Arredonda 5 para baixo

    Realiza o arredondamento tornando .5 em 0

    2 - Dispensa casas (Truncate)

    Realiza o arredondamento eliminando as casas especificadas.

  • O valor padrão de <nRound> é 0 (zero).
  • Caso <dNum> não seja do tipo decimal, ou <nScale> seja menor que 0 ou maior o igual à precisão do número, ou <nRound> seja menor que 0 ou maior que 2, uma exceção será lançada para interromper a execução.

Exemplos

Exemplo 1
User Function Exemplo()
  Local Dec1
  Local Dec2
  
  Dec1 := DEC_CREATE( 5.7591111111111119, 21, 20 ) // = 5.75911111111111200000
  Dec2 := DEC_RESCALE( Dec1, 5 ) // = 5.75911
Return

Abrangência

Protheus 10, TOTVS Application Server 10, ByYou Application Server

  • Sem rótulos