Formatear un número

# NumberFormatter::format

# numfmt_format

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

NumberFormatter::format -- numfmt_format — Formatear un número

### Descripción

Estilo orientado a objetos

public function NumberFormatter::format(int|float `$num`, int `$type` = `NumberFormatter::TYPE_DEFAULT`): string|false

Estilo procedimental

function numfmt_format(NumberFormatter `$formatter`, int|float `$num`, int `$type` = `NumberFormatter::TYPE_DEFAULT`): string|false

Formatea un valor numérico según las reglas del formateador.

### Parámetros

`formatter`

  Objeto NumberFormatter.

`num`

  El valor a formatear. Puede ser int o float, otros valores serán convertidos a un valor numérico.

`type`

  El tipo de formato a usar. Tenga en cuenta que `NumberFormatter::TYPE_CURRENCY` no está soportado; use NumberFormatter::formatCurrency() en su lugar.

### Valores devueltos

Devuelve el string que contiene el valor formateado, o `false` en caso de error.

### Ejemplos

Ejemplo #1 Ejemplo de numfmt_format()

    <?php
    $fmt = numfmt_create( 'de_DE', NumberFormatter::DECIMAL );
    $data = numfmt_format($fmt, 1234567.891234567890000);
    var_dump($data);
    ?>

Ejemplo #2 Ejemplo POO

    <?php
    $fmt = new NumberFormatter( 'de_DE', NumberFormatter::DECIMAL );
    $data = $fmt->format(1234567.891234567890000);
    var_dump($data);
    ?>

El ejemplo anterior mostrará:

    string(13) "1.234.567,891"

### Notas

> Nota:

> Los formatos alcanzables por este método de formateo no pueden utilizar completamente las posibilidades de la biblioteca ICU subyacente, como por ejemplo formatear moneda con símbolo de moneda estrecho.

> Para utilizarlas completamente use msgfmt_format_message().

### Ver también

- numfmt_get_error_code() - Obtener el último código de error del formateador
- numfmt_format_currency() - Formatea un valor monetario
- numfmt_parse() - Analiza un número
- msgfmt_format_message() - Formatea rápidamente un mensaje

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open