Funzione Format

Articolo
09/12/2008

Aggiornamento: novembre 2007

Restituisce una stringa formattata in base alle istruzioni contenute in un'espressione String di formato.

Public Shared Function Format( _
   ByVal Expression As Object, _
   Optional ByVal Style As String = "" _
) As String

Parametri

Expression
Obbligatorio. Qualsiasi espressione valida.
Style
Facoltativo. Espressione String di formato valida denominata o definita dall'utente.

Impostazioni

Per informazioni sulla creazione dell'argomento Style, vedere il relativo argomento specificato di seguito.

Per assegnare un formato a	Eseguire questa operazione
Numeri	Utilizzare formati numerici predefiniti oppure creare formati numerici definiti dall'utente.
Data e ora	Utilizzare formati di data/ora predefiniti oppure creare formati di data/ora definiti dall'utente.
Numeri seriali di data e ora	Utilizzare i formati di data e ora oppure i formati numerici.

Se nell'assegnare un formato a un numero non si specifica l'argomento Style, la funzione Format risulterà analoga alla funzione Str, benché supporti le impostazioni internazionali. I numeri positivi ai quali è stato assegnato il formato stringa mediante la funzione Format risultano privi dello spazio iniziale riservato al segno di valore mentre quelli convertiti utilizzando la funzione Str conservano lo spazio iniziale.

Note

Se la stringa da formattare è di tipo numerico non localizzato, utilizzare un formato numerico definito dall'utente per ottenere il risultato desiderato.

Una funzionalità analoga è garantita anche dal metodo String.Format.

Esempio

In questo esempio sono presentati vari utilizzi della funzione Format per formattare valori mediante formati sia di tipo String che definiti dall'utente. Per quanto riguarda il separatore della data (/), dell'ora (:) e gli indicatori AM/PM (t e tt), l'output formattato visualizzato dal sistema dipende dalle impostazioni internazionali utilizzate per il codice. Nell'ambiente di sviluppo la data e l'ora vengono visualizzate nel formato breve delle impostazioni internazionali locali.

Nota:
Per le impostazioni internazionali che utilizzano il formato 24 ore, gli indicatori AM/PM (t e tt) non visualizzano alcun output.

Dim TestDateTime As Date = #1/27/2001 5:04:23 PM#
Dim TestStr As String
' Returns current system time in the system-defined long time format.
TestStr = Format(Now(), "Long Time")
' Returns current system date in the system-defined long date format.
TestStr = Format(Now(), "Long Date")
' Also returns current system date in the system-defined long date 
' format, using the single letter code for the format.
TestStr = Format(Now(), "D")

' Returns the value of TestDateTime in user-defined date/time formats.
' Returns "5:4:23".
TestStr = Format(TestDateTime, "h:m:s")
' Returns "05:04:23 PM".
TestStr = Format(TestDateTime, "hh:mm:ss tt")
' Returns "Saturday, Jan 27 2001".
TestStr = Format(TestDateTime, "dddd, MMM d yyyy")
' Returns "17:04:23".
TestStr = Format(TestDateTime, "HH:mm:ss")
' Returns "23".
TestStr = Format(23)

' User-defined numeric formats.
' Returns "5,459.40".
TestStr = Format(5459.4, "##,##0.00")
' Returns "334.90".
TestStr = Format(334.9, "###0.00")
' Returns "500.00%".
TestStr = Format(5, "0.00%")