money_format

money_format(string $format, float $number): string
```php

`money_format` devuelve una versión formateada del número `number`. Esta función actúa como interfaz con la función `strfmon` de la biblioteca C, con la diferencia de que esta implementación solo convierte un número a la vez.

## Parámetros

`format`  
El parámetro de formato consta de la siguiente secuencia:

- un carácter `%`

- una configuración opcional

- un tamaño de campo opcional

- una precisión izquierda opcional

- una precisión derecha opcional

- un carácter de conversión obligatorio

Flags

Se puede utilizar una o más de las siguientes configuraciones:

`=`\<f\>  
El carácter `=` seguido de un byte único \<f\> que se utilizará como carácter de relleno. El carácter de relleno predeterminado es espacio.

`^`  
Desactiva el agrupamiento de caracteres (tal como se define en la configuración local).

`+` o `(`  
Especifica el estilo de formato para números positivos y negativos. Si se utiliza `+`, se usarán los equivalentes en la configuración local de `+` y `-`. Si se utiliza `(`, las sumas negativas se colocarán entre paréntesis. Si no se proporciona ninguna especificación, el valor predeterminado es `+`.

`!`  
Suprime el símbolo monetario en la cadena final.

`-`  
Si se proporciona, esta configuración hace que los campos se justifiquen a la izquierda (rellenados a la derecha), en contraste con la configuración predeterminada que está justificada a la derecha y rellenada a la izquierda.

Tamaño del campo

\<w\>  
Un número decimal que especifica el tamaño mínimo del campo. El campo se rellenará a la izquierda, a menos que se utilice la configuración `-`. Por defecto, este valor es 0.

Precisión izquierda

`#`\<n\>  
El número máximo de dígitos (\<n\>) esperados a la izquierda del separador decimal (por ejemplo, la coma). Esta opción se utiliza generalmente para mantener el alineamiento de columnas de números, utilizando un carácter para rellenar el número si este tiene menos de \<n\> dígitos. Si el número real de dígitos es mayor que \<n\>, esta especificación se ignora.

Si el agrupamiento no ha sido desactivado mediante la configuración `^`, los separadores de agrupamiento se insertarán antes del carácter de relleno (si corresponde). Los separadores no se aplicarán a los caracteres de relleno, incluso si este carácter es un número.

Para garantizar el alineamiento, todos los caracteres que aparecen antes y después del número formateado, como los símbolos monetarios o los signos negativo y positivo, se colocarán en el mismo lugar mediante espacios adicionales, de modo que todos los tamaños de los números sean iguales.

Precisión derecha

`.`\<p\>  
Un punto seguido de un número de decimales (\<p\>). Si el valor de \<p\> es 0 (cero), el separador decimal y los decimales se eliminarán. Si no se especifica ninguna precisión derecha, el valor predeterminado se leerá en la configuración local. El número formateado se redondeará para satisfacer las restricciones de visualización.

Caracteres de conversión

`i`  
El número se formatea según el formato monetario internacional de la configuración local (por ejemplo, para Francia: 1 234,56 F).

`n`  
El número se formatea según el formato monetario nacional (por ejemplo, para la configuración `de_DE`: `EU1.234,56`).

`%`  
Devuelve el carácter `%`.

`number`  
El número a formatear.

## Valores devueltos

Devuelve la cadena formateada. Los caracteres antes y después de la cadena formateada se devolverán sin cambios. Un valor no numérico para `number` devuelve `null` y emite una advertencia `E_WARNING`.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.0.0 | Esta función ha sido eliminada. |
| 7.4.0 | Esta función está obsoleta. Utilizar NumberFormatter::formatCurrency en su lugar. |

## Ejemplos

Ejemplo con `money_format`

A continuación se muestran varios ejemplos de uso de la función `money_format` con diferentes cadenas de formato y configuraciones locales.