number_format

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

number_formatFormatear un número con los millares agrupados

Descripción

number_format(float $number, int $decimals = 0): string
number_format(
    float $number,
    int $decimals = 0,
    string $dec_point = ".",
    string $thousands_sep = ","
): string

Esta función acepta uno, dos, o cuatro parámetros (no tres):

Si solo se proporciona un parámetro, number será formateado sin decimales, pero con una coma (",") entre cada grupo de millares.

Si se proporcionan dos parámetros, number será formateado con tantos decimales como se hayan definido en decimals colocando un punto (".") delante, y una coma (",") entre cada grupo de millares.

Si se proporcionan los cuatro parámetros, number será formateado con tantos decimales como hayamos definido en decimals, dec_point sustituirá al punto (".") como seperador de los decimales y el separador por defecto de los millares, la coma (","), será sustituida por thousands_sep.

Parámetros

number

El número al que dar formato.

decimals

Establece el número de puntos decimales.

dec_point

Establece el separador para los decimales.

thousands_sep

Establece el separador para los millares.

Valores devueltos

Una versión formateada de number.

Historial de cambios

Versión Descripción
5.4.0 Esta función ahora admite múltiples bytes en dec_point y thousands_sep. En versiones anteriors solamente se utilizaba el primer byte de cada separador.

Ejemplos

Ejemplo #1 Ejemplo de number_format()

Por ejemplo, la notación francesa suele utilizar dos decimales, una coma (',') como separador decimal y el espacio (' ') como separador de millares. Esto consigue esto mediante las siguientes líneas:

<?php

$número 
1234.56;

// notación inglesa (por defecto)
$número_formato_inglés number_format($número);
// 1,235

// notación francesa
$nombre_format_francais number_format($número2','' ');
// 1 234,56

$número 1234.5678;

// notación inglesa sin separador de millares
$english_format_number number_format($número2'.''');
// 1234.57

?>

Ver también

  • money_format() - Da formato a un número como un string de moneda
  • sprintf() - Devuelve un string formateado
  • printf() - Imprimir una cadena con formato
  • sscanf() - Interpreta un string de entrada de acuerdo con un formato