Restringe um valor numérico dentro de um intervalo específico determinado de forma precisa.

Figura 1 - Bloco Restringir Número

Compatibilidade

• Bloco cliente: cronapi.precise.restrictNumber()

Retorno

Retorna o valor passado desde que este esteja dentro da faixa de valores. Se o valor ultrapassar o limite superior do intervalo, o resultado será igual ao valor máximo definido. Caso o valor esteja abaixo do limite inferior, o resultado será o valor mínimo do intervalo.

O resultado é retornado como um objeto decimal de alta precisão. Esse objeto possui uma estrutura interna com as propriedades:

• s: define o sinal do número, ou seja, se o número é positivo ou negativo. O sinal de valor "1" representa um número positivo, enquanto o valor "-1" representa um número negativo.
• e: define o expoente decimal do número, ou seja, a posição da vírgula ou ponto decimal em relação ao início dos dígitos significativos.
• d: define o algarismo significativo do número em formato de array.

Parâmetros

Valor

Valor a ser restringido.

• Posição: 1
• Inglês: Value
• Tipo: Numérico / Numeric

• Exemplo: 2

Valor mínimo

Valor mínimo da faixa de valores.

• Posição: 2
• Inglês: Minimum value
• Tipo: Numérico / Numeric

• Exemplo: 1

Valor máximo

Valor máximo da faixa de valores.

• Posição: 3
• Inglês: Maximum value
• Tipo: Numérico / Numeric

• Exemplo: 10

Exemplo

Na função abaixo, o bloco Restringir Número irá retornar o valor numérico restringido de acordo com os limites estabelecidos. O resultado de execução será impresso no console do navegador.

Figura 2 - Exemplo de uso do bloco Restringir Número

Na imagem a seguir, podemos observar o resultado de execução da função da Figura 2. Observe que o bloco retorna o valor máximo do limite estabelecido, visto que o valor informado ultrapassa esse limite.

Figura 2.1 - Resultado de execução da função da Figura 2