Ayudante de números

El archivo Number Helper contiene funciones que le ayudan a trabajar con datos numéricos teniendo en cuenta la configuración regional.

Cargando este ayudante

Este ayudante se carga usando el siguiente código:

<?php

helper('number');

Cuando las cosas van mal

Si la lógica de internacionalización y localización de PHP no puede manejar un valor proporcionado, para la configuración regional y las opciones dadas, luego un Se lanzará BadFunctionCallException().

Funciones disponibles

Están disponibles las siguientes funciones:

number_to_size($num[, $precision = 1[, $locale = null]])
Parámetros:

  • $num (mixed) – Número de bytes

  • $precision (int) – Precisión de punto flotante

Devuelve:

cadena de tamaño de datos formateada, o false si el valor proporcionado no es numérico

Tipo del valor devuelto:

cadena

Formatea los números como bytes, según el tamaño, y agrega los valores apropiados. sufijo. Ejemplos:

<?php

echo number_to_size(456); // Returns 456 Bytes
echo number_to_size(4567); // Returns 4.5 KB
echo number_to_size(45678); // Returns 44.6 KB
echo number_to_size(456789); // Returns 447.8 KB
echo number_to_size(3456789); // Returns 3.3 MB
echo number_to_size(12345678912345); // Returns 1.8 GB
echo number_to_size(123456789123456789); // Returns 11,228.3 TB

Un segundo parámetro opcional le permite establecer la precisión del resultado:

<?php

echo number_to_size(45678, 2); // Returns 44.61 KB

Un tercer parámetro opcional le permite especificar la configuración regional que debe se utilizará al generar el número y puede afectar el formato. Si no Si se especifica la configuración regional, se analizará la solicitud y se creará una configuración regional adecuada. configuración regional tomada de los encabezados, o la aplicación predeterminada:

<?php

// Generates 11.2 TB
echo number_to_size(12345678912345, 1, 'en_US');
// Generates 11,2 TB
echo number_to_size(12345678912345, 1, 'fr_FR');

Nota

The text generated by this function is found in the following archivo de idioma: idioma/<your_lang> /Número.php

number_to_amount($num[, $precision = 1[, $locale = null])
Parámetros:

  • $num (mixed) – Número a formatear

  • $precision (int) – Precisión de punto flotante

  • $locale (string) – la configuración regional que se utilizará para formatear

Devuelve:

una versión legible por humanos de la cadena, o false si el valor proporcionado no es numérico

Tipo del valor devuelto:

cadena

Convierte un número a una versión legible por humanos, como 123,4 billones para números hasta los cuatrillones. Ejemplos:

<?php

echo number_to_amount(123456); // Returns 123 thousand
echo number_to_amount(123456789); // Returns 123 million
echo number_to_amount(1234567890123, 2); // Returns 1.23 trillion
echo number_to_amount('123,456,789,012', 2); // Returns 123.46 billion

Un segundo parámetro opcional le permite establecer la precisión del resultado:

<?php

echo number_to_amount(45678, 2); // Returns 45.68 thousand

Un tercer parámetro opcional permite especificar la configuración regional:

<?php

echo number_to_amount('123,456,789,012', 2, 'de_DE'); // Returns 123,46 billion
number_to_currency($num, $currency[, $locale = null[, $fraction = 0]])
Parámetros:

  • $num (float) – Número a formatear

  • $moneda (strings) – el tipo de moneda, es decir, USD, EUR, etc.

  • $locale (string|null) – La configuración regional que se utilizará para formatear

  • $fracción (entero) – Número de dígitos de fracción después del punto decimal

Devuelve:

El número como moneda apropiada para la configuración regional

Tipo del valor devuelto:

cadena

Convierte un número en formatos de moneda comunes, como USD, EUR, GBP, etc.:

<?php

echo number_to_currency(1234.56, 'USD', 'en_US', 2);  // Returns $1,234.56
echo number_to_currency(1234.56, 'EUR', 'de_DE', 2);  // Returns 1.234,56 €
echo number_to_currency(1234.56, 'GBP', 'en_GB', 2);  // Returns £1,234.56
echo number_to_currency(1234.56, 'YEN', 'ja_JP', 2);  // Returns YEN 1,234.56

Si no especifica una configuración regional, se utiliza la configuración regional de Solicitud.

number_to_roman($num)
Parámetros:

  • $num (int|string) – El número que desea convertir

Devuelve:

el número romano convertido a partir del parámetro dado

Tipo del valor devuelto:

cadena|nulo

Convierte un número a romano:

<?php

echo number_to_roman(23);    // Returns XXIII
echo number_to_roman(324);   // Returns CCCXXIV
echo number_to_roman(2534);  // Returns MMDXXXIV

Esta función solo maneja números en el rango del 1 al 3999. Devolverá «nulo» para cualquier valor fuera de ese rango.