Sur cette page

L'objet JavaScript « Number »

L'objet « Number » de QML étend l'objet « Number » de JavaScript avec des fonctions tenant compte des paramètres régionaux.

chaîne Number::toLocaleString(locale, format, precision)

Convertit le nombre en une chaîne adaptée à l’ locale spécifiée dans l’ format spécifiée, avec l’ precision spécifiée.

Les formats valides sont :

  • 'f' : nombre à virgule flottante décimal, par exemple 248,65
  • 'e' : notation scientifique utilisant le caractère « e », par exemple 2,4865e+2
  • 'E' : notation scientifique utilisant le caractère E, par exemple 2,4865E+2
  • 'g' : utilise la forme la plus courte entre « e » et « f »
  • « G » : utilise la valeur la plus courte entre « E » et « f »

Si la précision n'est pas spécifiée, elle sera de 2.

Si le format n'est pas spécifié, « f » sera utilisé.

Si l'locale n n'est pas spécifiée, la locale par défaut sera utilisée.

L'exemple suivant montre un nombre formaté pour la locale allemande :

import QtQuick 2.0

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

Vous pouvez personnaliser chaque champ de l’ locale pour contrôler précisément le résultat :

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

Vous pouvez appliquer la fonction toLocaleString() directement à des constantes, à condition que la décimale soit incluse dans la constante, par exemple :

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)

Convertit le nombre en devise en utilisant la devise et les conventions de l’ locale spécifiée. Si symbol est spécifié, il sera utilisé comme symbole de devise.

string Number::fromLocaleString(locale, number)

Renvoie un nombre en analysant une chaîne « number » selon les conventions de la locale fournie « locale ».

Si locale n’est pas fourni, les paramètres régionaux par défaut seront utilisés.

Par exemple, en utilisant la locale allemande :

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

Voir également Locale et 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.