Scopo
Ritorna in formato stringa il valore numerico formattato in base ai parametri indicati.
Sintassi
Risultato := NumberToString(espressione, separatore decimale, separatore gruppo)
Argomenti
Espressione | Obbligatorio. È l'espressione numerica di cui si vuole ottenere il valore nel formato stringa specificato. Deve essere una qualunque espressione il cui risultato sia un numero. |
Separatore Decimale | Opzionale. Indica il carattere che deve essere utilizzato come separatore decimale. In caso sia omesso verrà considerato quanto specificato nel parametro di compilazione UseDecimalDot. |
Separatore Gruppo | Opzionale. Indica il carattere che deve essere utilizzato come separatore di gruppo. In caso sia omesso verrà considerato quanto specificato nel parametro di compilazione UseDecimalDot. |
Valore di ritorno
Viene ritornata una stringa che contiene il valore dell'espressione passato come argomento opportunatamente formattato.
Esempio di codice
// *********************************************************
// Explain which processing is carried out by this procedure
// *********************************************************
public void EsempiGF.MostraTotale()
{
currency Totale = 1213234.34 // Totale bilancio
string Messaggio = "Il bilancio si è chiuso con il seguente totale: " //
//
Messaggio := Messaggio +c NumberToString(Totale, virgola, punto) +c euro
//
// Il bilancio si è chiuso con il seguente totale: 1.213.234,34 euro
EsempiGF.MessageBox(Messaggio)
}
// Explain which processing is carried out by this procedure
// *********************************************************
public void EsempiGF.MostraTotale()
{
currency Totale = 1213234.34 // Totale bilancio
string Messaggio = "Il bilancio si è chiuso con il seguente totale: " //
//
Messaggio := Messaggio +c NumberToString(Totale, virgola, punto) +c euro
//
// Il bilancio si è chiuso con il seguente totale: 1.213.234,34 euro
EsempiGF.MessageBox(Messaggio)
}
- Se non sono stati specificati gli argomenti opzionali per la formattazione di valori numerici viene preso in considerazione il parametro di compilazione UseDecimalDot, in particolare:
- se UseDecimalDot è uguale a YES allora Separatore Decimale = '.' (punto) e Separatore Gruppo = ',' (virgola)
- se UseDecimalDot è uguale a NO allora Separatore Decimale = ',' (virgola) e Separatore Gruppo = '.' (punto)
- Se è richiesta una maschera di formattazione particolare per convertire valori numerici in stringhe è possibile usare la funzione Format
- E' fortemente consigliato l'utilizzo di questa funzione al posto della funzione ToString perchè mentre la funzione ToString utilizza forzatamente il punto come separatore dei decimali e nessun altro tipo di separatore, la funzione NumberToString tiene conto della localizzazione dell'applicazione utilizzando i separatori decimali e di gruppo così come specificato.
Ultima modifica: 20/11/2020 / Validità: da 6.5.2680