round

    (PHP 4, PHP 5, PHP 7, PHP 8)

    round — Arredonda um float

    Descrição

    round(int|float$num, int$precision = 0, int$mode = PHP_ROUND_HALF_UP): float

    Retorna um valor arredondado de num com a precisão especificada em precision (número de dígitos depois do ponto decimal). precision também pode ser negativo ou zero (padrão).

    Parâmetros

    num

    Valor a ser arredondado.

    precision

    O número opcional de dígitos decimais para arredondar.

    Se precision for positivo, num será arredondado para precision de dígitos significativos depois do ponto decimal.

    Se precision for negativo, num será arredondado para precision de dígitos significativos depois do ponto decimal, isto é: o múltiplo mais próximo de pow(10, -$precision), por exemplo: para um precision de -1 num é arredondado para dezenas, para um precision de -2 para centenas, etc.

    mode

    Use uma das seguintes constantes para especificar o modo ao qual o arredondamento ocorre.

    ConstantesDescrição
    PHP_ROUND_HALF_UP Arredonda num para longe de zero quando ele está na metade do caminho, tornando 1.5 em 2 e -1.5 em -2.
    PHP_ROUND_HALF_DOWN Arredonda num na direção de zero quando ele está na metade do caminho, tornando 1.5 em 1 e -1.5 em -1.
    PHP_ROUND_HALF_EVEN Arredonda num em direção ao valor par mais próximo quando ele está na metade do caminho, tornando ambos 1.5 e 2.5 em 2.
    PHP_ROUND_HALF_ODD Arredonda num em direção ao valor ímpar mais próximo quando ele está na metade do caminho, tornando 1.5 em 1 e 2.5 em 3.

    Valor Retornado

    O valor arredondado para precision fornecido como um float.

    Registro de Alterações

    VersãoDescrição
    8.0.0num não mais aceita objetos internos que suportam conversões numéricas.

    Exemplos

    Exemplo #1 Exemplos de round()

    <?php
    var_dump    (round(3.4));
    var_dump(round(3.5));
    var_dump(round(3.6));
    var_dump(round(3.6, 0));
    var_dump(round(5.045, 2));
    var_dump(round(5.055, 2));
    var_dump(round(345, -2));
    var_dump(round(345, -3));
    var_dump(round(678, -2));
    var_dump(round(678, -3));
    ?>

    O exemplo acima produzirá:

    float(3) float(4) float(4) float(4) float(5.05) float(5.06) float(300) float(0) float(700) float(1000)

    Exemplo #2 Como precision afeta um float

    <?php
    $numero     = 135.79;

    var_dump(round($numero, 3));
    var_dump(round($numero, 2));
    var_dump(round($numero, 1));
    var_dump(round($numero, 0));
    var_dump(round($numero, -1));
    var_dump(round($numero, -2));
    var_dump(round($numero, -3));
    ?>

    O exemplo acima produzirá:

    float(135.79) float(135.79) float(135.8) float(136) float(140) float(100) float(0)

    Exemplo #3 Exemplos de mode

    <?php
    echo 'Modos de arredondamento com 9.5' . PHP_EOL;
    var_dump(round(9.5, 0, PHP_ROUND_HALF_UP));
    var_dump(round(9.5, 0, PHP_ROUND_HALF_DOWN));
    var_dump(round(9.5, 0, PHP_ROUND_HALF_EVEN));
    var_dump(round(9.5, 0, PHP_ROUND_HALF_ODD));

    echo     PHP_EOL;
    echo     'Modos de arredondamento com 8.5' . PHP_EOL;
    var_dump(round(8.5, 0, PHP_ROUND_HALF_UP));
    var_dump(round(8.5, 0, PHP_ROUND_HALF_DOWN));
    var_dump(round(8.5, 0, PHP_ROUND_HALF_EVEN));
    var_dump(round(8.5, 0, PHP_ROUND_HALF_ODD));
    ?>

    O exemplo acima produzirá:

    Modos de arredondamento com 9.5 float(10) float(9) float(10) float(9) Modos de arredondamento com 8.5 float(9) float(8) float(8) float(9)

    Exemplo #4 Exemplos de mode com precision

    <?php
    echo 'Usando PHP_ROUND_HALF_UP com precisão decimal de 1 dígito' . PHP_EOL;
    var_dump(round( 1.55, 1, PHP_ROUND_HALF_UP));
    var_dump(round(-1.55, 1, PHP_ROUND_HALF_UP));

    echo     PHP_EOL;
    echo     'Usando PHP_ROUND_HALF_DOWN com precisão decimal de 1 dígito' . PHP_EOL;
    var_dump(round( 1.55, 1, PHP_ROUND_HALF_DOWN));
    var_dump(round(-1.55, 1, PHP_ROUND_HALF_DOWN));

    echo     PHP_EOL;
    echo     'Usando PHP_ROUND_HALF_EVEN com precisão decimal de 1 dígito' . PHP_EOL;
    var_dump(round( 1.55, 1, PHP_ROUND_HALF_EVEN));
    var_dump(round(-1.55, 1, PHP_ROUND_HALF_EVEN));

    echo     PHP_EOL;
    echo     'Usando PHP_ROUND_HALF_ODD com precisão decimal de 1 dígito' . PHP_EOL;
    var_dump(round( 1.55, 1, PHP_ROUND_HALF_ODD));
    var_dump(round(-1.55, 1, PHP_ROUND_HALF_ODD));
    ?>

    O exemplo acima produzirá:

    Usando PHP_ROUND_HALF_UP with 1 com precisão decimal de 1 digito float(1.6) float(-1.6) Usando PHP_ROUND_HALF_DOWN with 1 com precisão decimal de 1 digito float(1.5) float(-1.5) Usando PHP_ROUND_HALF_EVEN with 1 com precisão decimal de 1 digito float(1.6) float(-1.6) Usando PHP_ROUND_HALF_ODD with 1 com precisão decimal de 1 digito float(1.5) float(-1.5)

    Veja Também

    To Top