En esta página

El objeto «Number» de JavaScript

El objeto «Number» de QML amplía el objeto «Number» de JavaScript con funciones que tienen en cuenta la configuración regional.

string Number::toLocaleString(locale, format, precision)

Convierte el valor numérico en una cadena adecuada para la configuración regional especificada ( locale ) en el formato especificado ( format), con la precisión especificada ( precision).

Los formatos válidos son:

  • 'f' Decimal de coma flotante, p. ej., 248,65
  • 'e' Notación científica con el carácter «e», p. ej., 2,4865e+2
  • 'E': notación científica con el carácter «E», p. ej., 2,4865E+2
  • 'g': utiliza el más corto de «e» o «f»
  • «G»: utiliza el más corto de «E» o «f»

Si no se especifica la precisión, esta será 2.

Si no se especifica el formato, se utilizará «f».

Si no se especifica « locale », se utilizará la configuración regional predeterminada.

El siguiente ejemplo muestra un número formateado para la configuración regional alemana:

import QtQuick 2.0

Text {
    text: "The value is: " +  Number(4742378.423).toLocaleString(Qt.locale("de_DE"))
}

Puedes personalizar campos individuales de la cadena de formato « locale » para controlar con precisión la salida:

let locale = Qt.locale("de_DE");
let a = Number(1000).toLocaleString(locale)); // a == 1.000,00
locale.numberOptions = Locale.OmitGroupSeparator;
let b = Number(1000).toLocaleString(locale)); // b == 1000,00

Se puede aplicar toLocaleString() directamente a constantes, siempre que la parte decimal esté incluida en la constante, p. ej.:

123.0.toLocaleString(Qt.locale("de_DE")) // OK
123..toLocaleString(Qt.locale("de_DE"))  // OK
123.toLocaleString(Qt.locale("de_DE"))   // fails

string Number::toLocaleCurrencyString(locale, symbol)

Convierte el número en una moneda utilizando la moneda y las convenciones de la configuración regional especificada ( locale). Si se especifica « symbol », se utilizará como símbolo de la moneda.

string Number::fromLocaleString(locale, number)

Devuelve un número analizando number según las convenciones de la configuración regional proporcionada locale.

Si no se proporciona locale, se utilizará la configuración regional predeterminada.

Por ejemplo, utilizando la configuración regional alemana:

var german = Qt.locale("de_DE");
var d;
d = Number.fromLocaleString(german, "1234,56")   // d == 1234.56
d = Number.fromLocaleString(german, "1.234,56") // d == 1234.56
d = Number.fromLocaleString(german, "1234.56")  // throws exception
d = Number.fromLocaleString(german, "1.234")    // d == 1234.0

Véase también Locale y Locale::currencySymbol().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.