Strings.Format(Object, String) Strings.Format(Object, String) Strings.Format(Object, String) Method

Definizione

Restituisce una stringa formattata in base alle istruzioni contenute in un'espressione String di formato.Returns a string formatted according to instructions contained in a format String expression.

public static string Format (object Expression, string Style = "");
static member Format : obj * string -> string
Public Function Format (Expression As Object, Optional Style As String = "") As String

Parametri

Expression
Object Object Object

Obbligatorio.Required. Qualsiasi espressione valida.Any valid expression.

Style
String String String

Opzionale.Optional. Un'espressione String di formato denominata o definita dall'utente valida.A valid named or user-defined format String expression.

Restituisce

Stringa formattata in base alle istruzioni contenute in un'espressione String di formato.A string formatted according to instructions contained in a format String expression.

Esempi

In questo esempio sono presentati vari utilizzi della funzione Format per formattare valori mediante formati sia di tipo String che definiti dall'utente.This example shows various uses of the Format function to format values using both String formats and user-defined formats. 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 locali utilizzate per il codice.For the date separator (/), time separator (:), and the AM/PM indicators (t and tt), the actual formatted output displayed by your system depends on the locale settings the code is using. Nell'ambiente di sviluppo la data e l'ora vengono visualizzate nel formato breve delle impostazioni locali.When times and dates are displayed in the development environment, the short time format and short date format of the code locale are used.

Nota

Per le impostazioni locali che utilizzano il formato 24 ore, gli indicatori AM/PM (t e tt) non visualizzano alcun output.For locales that use a 24-hour clock, the AM/PM indicators (t and tt) display nothing.

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%")

Commenti

Il String.Format metodo fornisce inoltre una funzionalità simile.The String.Format method also provides similar functionality.

Se si formatta una stringa numerica non localizzata, è necessario utilizzare un formato numerico definito dall'utente per assicurarsi di ottenere l'aspetto desiderato.If you are formatting a nonlocalized numeric string, you should use a user-defined numeric format to ensure that you get the look you want.

Se si tenta di formattare un numero senza specificare Style, il Format funzione fornisce funzionalità simili a quelle di Str funzionare, sebbene sia a livello internazionale con riconoscimento.If you try to format a number without specifying Style, the Format function provides functionality similar to the Str function, although it is internationally aware. Tuttavia, i numeri positivi formattato come stringhe usando il Format funzione non includere uno spazio iniziale riservato per il segno del valore; quelli convertito mediante il Str funzione conservare lo spazio iniziale.However, positive numbers formatted as strings using the Format function don't include a leading space reserved for the sign of the value; those converted using the Str function retain the leading space.

Formati diversi per diversi valori numericiDifferent Formats for Different Numeric Values

Un'espressione di formato definita dall'utente per i numeri può includere da una a tre sezioni separate da punti e virgola.A user-defined format expression for numbers can have from one to three sections separated by semicolons. Se il Style argomento del Format funzione contiene uno dei formati numerici predefiniti, è consentita una sola sezione.If the Style argument of the Format function contains one of the predefined numeric formats, only one section is allowed.

Se si usaIf you use Questo è il risultatoThis is the result
Una sola sezioneOne section only L'espressione di formato viene applicata a tutti i valori.The format expression applies to all values.
DueTwo sections La prima sezione viene applicata ai valori positivi e agli zeri; il secondo si applica ai valori negativi.The first section applies to positive values and zeros; the second applies to negative values.
TreThree sections La prima sezione viene applicata ai valori positivi, il secondo si applica ai valori negativi e si applica la terza agli zeri.The first section applies to positive values, the second applies to negative values, and the third applies to zeros.

L'esempio seguente contiene due sezioni: il primo definisce il formato per i valori positivi e gli zeri; la seconda sezione definisce il formato per i valori negativi.The following example has two sections: the first defines the format for positive values and zeros; the second section defines the format for negative values. Poiché il Style argomento del Format funzione accetta una stringa, è racchiuso tra virgolette.Since the Style argument of the Format function takes a string, it is enclosed by quotation marks.

Dim style1 As String = "$#,##0;($#,##0)"

Se si include un punto e virgola consecutivi, la sezione mancante viene stampata utilizzando il formato del valore positivo.If you include semicolons with nothing between them, the missing section is printed using the format of the positive value. Ad esempio, il formato seguente visualizza positivi e negativi utilizzando il formato nella prima sezione e di visualizzare Zero se il valore è zero.For example, the following format displays positive and negative values using the format in the first section and displays Zero if the value is zero.

Dim style2 As String = "$#,##0;;\Z\e\r\o"

Formati numerici predefinitiPredefined Numeric Formats

Nella tabella seguente identifica i nomi di formati numerici predefiniti.The following table identifies the predefined numeric format names. Possono essere utilizzati in base al nome come le Style argomento per il Format funzione:These may be used by name as the Style argument for the Format function:

Nome del formatoFormat name DescrizioneDescription
General Number, Go gGeneral Number, G, or g Numero viene visualizzato alcun separatore delle migliaia.Displays number with no thousand separator.

Ad esempio, Format(&H3FA, "g") restituisce 1018.For example, Format(&H3FA, "g") returns 1018.
Currency, Co cCurrency, C, or c Il numero viene visualizzato il separatore delle migliaia, se appropriato; Consente di visualizzare due cifre a destra del separatore decimale.Displays number with thousand separator, if appropriate; displays two digits to the right of the decimal separator. Output si basa sulle impostazioni locali del sistema.Output is based on system locale settings.

Ad esempio, Format(1234567, "c") restituisce $1,234,567.00.For example, Format(1234567, "c") returns $1,234,567.00.
Fixed, Fo fFixed, F, or f Consente di visualizzare almeno una cifra a sinistra e due cifre a destra del separatore decimale.Displays at least one digit to the left and two digits to the right of the decimal separator.

Ad esempio, Format(1234567, "f") restituisce 1234567.00.For example, Format(1234567, "f") returns 1234567.00.
Standard, No nStandard, N, or n Visualizza numeri con separatore delle migliaia, almeno una cifra a sinistra e due cifre a destra del separatore decimale.Displays number with thousand separator, at least one digit to the left and two digits to the right of the decimal separator.

Ad esempio, Format(1234567, "n") restituisce 1,234,567.00.For example, Format(1234567, "n") returns 1,234,567.00.
Percent Visualizza il numero moltiplicato per 100 con un segno di percentuale (%) aggiunto immediatamente a destra. viene sempre visualizzato con cifre a destra del separatore decimale.Displays number multiplied by 100 with a percent sign (%) appended immediately to the right; always displays two digits to the right of the decimal separator.

Ad esempio, Format(0.4744, "Percent") restituisce 47.44%.For example, Format(0.4744, "Percent") returns 47.44%.
P, o pP, or p Visualizza il numero con separatore delle migliaia moltiplicato per 100 con un segno di percentuale (%) aggiunta a destra e separato da uno spazio singolo. viene sempre visualizzato con cifre a destra del separatore decimale.Displays number with thousandths separator multiplied by 100 with a percent sign (%) appended to the right and separated by a single space; always displays two digits to the right of the decimal separator.

Ad esempio, Format(0.80345, "p") restituisce 80.35 %.For example, Format(0.80345, "p") returns 80.35 %.
Scientific Usa la notazione scientifica standard, specificando due cifre significative.Uses standard scientific notation, providing two significant digits.

Ad esempio, Format(1234567, "Scientific") restituisce 1.23E+06.For example, Format(1234567, "Scientific") returns 1.23E+06.
E, o eE, or e Usa la notazione scientifica standard, specificando sei cifre significative.Uses standard scientific notation, providing six significant digits.

Ad esempio, Format(1234567, "e") restituisce 1.234567e+006.For example, Format(1234567, "e") returns 1.234567e+006.
D, o dD, or d Visualizza il numero sotto forma di stringa che contiene il valore del numero in formato decimale (base 10).Displays number as a string that contains the value of the number in Decimal (base 10) format. Questa opzione è supportata per i tipi integrali (Byte, Short, Integer, Long) solo.This option is supported for integral types (Byte, Short, Integer, Long) only.

Ad esempio, Format(&H7F, "d") restituisce 127.For example, Format(&H7F, "d") returns 127.
X, o xX, or x Visualizza il numero sotto forma di stringa che contiene il valore del numero in formato esadecimale (base 16).Displays number as a string that contains the value of the number in Hexadecimal (base 16) format. Questa opzione è supportata per i tipi integrali (Byte, Short, Integer, Long) solo.This option is supported for integral types (Byte, Short, Integer, Long) only.

Ad esempio, Format(127, "x") restituisce 7f.For example, Format(127, "x") returns 7f.
Yes/No Consente di visualizzare No se il numero è 0; in caso contrario, viene visualizzato Yes.Displays No if number is 0; otherwise, displays Yes.

Ad esempio, Format(0, "Yes/No") restituisce No.For example, Format(0, "Yes/No") returns No.
True/False Consente di visualizzare False se il numero è 0; in caso contrario, viene visualizzato True.Displays False if number is 0; otherwise, displays True.

Ad esempio, Format(1, "True/False") restituisce True.For example, Format(1, "True/False") returns True.
On/Off Consente di visualizzare Off se il numero è 0; in caso contrario, viene visualizzato On.Displays Off if number is 0; otherwise, displays On.

Ad esempio, Format(1, "On/Off") restituisce On.For example, Format(1, "On/Off") returns On.

Note per gli sviluppatori di Smart DeviceSmart Device Developer Notes

Il Yes/No, True/False, e On/Off formati non sono supportati.The Yes/No, True/False, and On/Off formats are not supported.

Formati numerici definiti dall'utenteUser-Defined Numeric Formats

Nella tabella seguente sono indicati i caratteri che è possibile usare per creare formati di numero definiti dall'utente.The following table identifies characters you can use to create user-defined number formats. Possono essere utilizzati per compilare il Style argomento per il Format funzione:These may be used to build the Style argument for the Format function:

CarattereCharacter DescrizioneDescription
nessunoNone Visualizza il numero senza formattazione.Displays the number with no formatting.
(0)(0) Segnaposto per cifre.Digit placeholder. Viene visualizzata una cifra o uno zero.Displays a digit or a zero. Se l'espressione è presente una cifra nella posizione in cui è presente lo zero nella stringa di formato, visualizzarlo; in caso contrario, viene visualizzato uno zero in tale posizione.If the expression has a digit in the position where the zero appears in the format string, display it; otherwise, displays a zero in that position.

Se il numero ha meno cifre di quanti sono gli zeri (su entrambi i lati del separatore decimale) nell'espressione di formato, consente di visualizzare zeri iniziali o finali.If the number has fewer digits than there are zeros (on either side of the decimal) in the format expression, displays leading or trailing zeros. Se il numero include più cifre a destra del separatore decimale rispetto a quanti sono gli zeri a destra del separatore decimale nell'espressione di formato, arrotondare le tante cifre decimali quanti sono gli zeri.If the number has more digits to the right of the decimal separator than there are zeros to the right of the decimal separator in the format expression, rounds the number to as many decimal places as there are zeros. Se il numero include più cifre a sinistra del separatore decimale rispetto a quanti sono gli zeri a sinistra del separatore decimale nell'espressione di formato, consente di visualizzare le cifre aggiuntive senza modifiche.If the number has more digits to the left of the decimal separator than there are zeros to the left of the decimal separator in the format expression, displays the extra digits without modification.
(#)(#) Segnaposto per cifre.Digit placeholder. Viene visualizzata una cifra o nulla.Displays a digit or nothing. Se l'espressione è presente una cifra nella posizione in cui il # carattere viene visualizzato nella stringa di formato, viene visualizzato; in caso contrario, non visualizzerà niente in tale posizione.If the expression has a digit in the position where the # character appears in the format string, displays it; otherwise, displays nothing in that position.

Questo simbolo funziona come le 0 segnaposto cifra, ad eccezione del fatto che zeri iniziali e finali non vengono visualizzati se il numero ha meno cifre di quanti sono # caratteri ai lati del separatore decimale nell'espressione di formato.This symbol works like the 0 digit placeholder, except that leading and trailing zeros aren't displayed if the number has fewer digits than there are # characters on either side of the decimal separator in the format expression.
(.)(.) Segnaposto decimale.Decimal placeholder. Il segnaposto decimale determina il numero di cifre visualizzato a sinistra e a destra del separatore decimale.The decimal placeholder determines how many digits are displayed to the left and right of the decimal separator. Se l'espressione di formato contiene solo # caratteri alla sinistra di questo simbolo; i numeri inferiori a 1 iniziano con un separatore decimale.If the format expression contains only # characters to the left of this symbol; numbers smaller than 1 begin with a decimal separator. Per visualizzare uno zero iniziale con i numeri frazionari, utilizzare zero come primo segnaposto di cifra a sinistra del separatore decimale.To display a leading zero displayed with fractional numbers, use zero as the first digit placeholder to the left of the decimal separator. In alcune impostazioni locali, viene utilizzata una virgola come separatore decimale.In some locales, a comma is used as the decimal separator. Il carattere effettivo utilizzato come segnaposto decimale nell'output formattato dipende dal formato numerico riconosciuto dal sistema in uso.The actual character used as a decimal placeholder in the formatted output depends on the number format recognized by your system. Pertanto, utilizzare il periodo come segnaposto decimale nei formati in uso anche se trovano in impostazioni locali configurate viene utilizzata una virgola come segnaposto decimale.Thus, you should use the period as the decimal placeholder in your formats even if you are in a locale that uses a comma as a decimal placeholder. La stringa formattata verrà visualizzato nel formato corretto per le impostazioni locali.The formatted string will appear in the format correct for the locale.
(%)(%) Segnaposto percentuale.Percent placeholder. Moltiplica l'espressione per 100.Multiplies the expression by 100. Il carattere di percentuale (%) viene inserito nella posizione in cui presente nella stringa di formato.The percent character (%) is inserted in the position where it appears in the format string.
(,)(,) Separatore delle migliaia.Thousand separator. Il separatore delle migliaia separa le migliaia dalle centinaia all'interno di un numero con quattro o più posizioni a sinistra del separatore decimale.The thousand separator separates thousands from hundreds within a number that has four or more places to the left of the decimal separator. Utilizzo standard del separatore delle migliaia viene specificato se il formato include un separatore delle migliaia racchiuso da segnaposti cifra (0 o #).Standard use of the thousand separator is specified if the format contains a thousand separator surrounded by digit placeholders (0 or #).

Un separatore delle migliaia immediatamente a sinistra del separatore decimale (se viene specificato un numero decimale) o come più a destra di caratteri della stringa indica che "ridimensionare il numero essere diviso per 1000 e arrotondato se necessario."A thousand separator immediately to the left of the decimal separator (whether or not a decimal is specified) or as the rightmost character in the string means "scale the number by dividing it by 1,000, rounding as needed." I numeri inferiori a 1000 ma maggiori o uguali a 500 vengono visualizzati come 1e i numeri inferiori a 500 vengono visualizzati come 0.Numbers smaller than 1,000 but greater or equal to 500 are displayed as 1, and numbers smaller than 500 are displayed as 0. Due separatori delle migliaia adiacenti in questa posizione puoi ridimensionare un fattore pari a 1 milione e un fattore aggiuntivo pari a 1.000 per ogni separatore aggiuntivo.Two adjacent thousand separators in this position scale by a factor of 1 million, and an additional factor of 1,000 for each additional separator.

Più separatori in qualsiasi posizione diversa da quella immediatamente a sinistra del separatore decimale o all'estrema destra nella stringa vengono trattati come semplici che specificano l'utilizzo di un separatore delle migliaia.Multiple separators in any position other than immediately to the left of the decimal separator or the rightmost position in the string are treated simply as specifying the use of a thousand separator. In alcune impostazioni locali, viene utilizzato un punto come separatore delle migliaia.In some locales, a period is used as a thousand separator. Il carattere effettivo utilizzato come separatore delle migliaia nell'output formattato dipende dal formato numerico riconosciuto dal sistema in uso.The actual character used as the thousand separator in the formatted output depends on the Number Format recognized by your system. In questo modo, si deve usare la virgola come separatore delle migliaia nei formati in uso anche se trovano in delle impostazioni locali che viene utilizzato un punto come separatore delle migliaia.Thus, you should use the comma as the thousand separator in your formats even if you are in a locale that uses a period as a thousand separator. La stringa formattata verrà visualizzato nel formato corretto per le impostazioni locali.The formatted string will appear in the format correct for the locale.

Ad esempio, considerare le tre stringhe di formato seguenti:For example, consider the three following format strings:

- "#,0.", utilizza il separatore delle migliaia per formattare il numero 100 milioni come stringa "100.000.000".- "#,0.", which uses the thousands separator to format the number 100 million as the string "100,000,000".
- "#0,.", che usa l'implementazione della scalabilità tramite un fattore di mille per formattare il numero 100 milioni come stringa "100000".- "#0,.", which uses scaling by a factor of one thousand to format the number 100 million as the string "100000".
- "#,0,.", che utilizza il separatore delle migliaia e la riduzione di mille per formattare il numero 100 milioni come stringa "100.000".- "#,0,.", which uses the thousands separator and scaling by one thousand to format the number 100 million as the string "100,000".
(:)(:) Separatore dell'ora.Time separator. In alcune impostazioni locali, possono essere utilizzati altri caratteri per rappresentare il separatore dell'ora.In some locales, other characters may be used to represent the time separator. Il separatore dell'ora separa le ore, minuti e secondi nei valori di ora formattati.The time separator separates hours, minutes, and seconds when time values are formatted. Il carattere effettivo utilizzato come separatore dell'ora nell'output formattato è determinato dalle impostazioni del sistema.The actual character used as the time separator in formatted output is determined by your system settings.
(/)(/) Separatore della data.Date separator. In alcune impostazioni locali, possono essere utilizzati altri caratteri per rappresentare il separatore della data.In some locales, other characters may be used to represent the date separator. Il separatore della data separa il giorno, mese e anno nei valori di data formattati.The date separator separates the day, month, and year when date values are formatted. Il carattere effettivo utilizzato come separatore della data nell'output formattato è determinato dalle impostazioni del sistema.The actual character used as the date separator in formatted output is determined by your system settings.
(E-``E+``e-``e+)(E-``E+``e-``e+) Formato scientifico.Scientific format. Se l'espressione di formato contiene almeno un segnaposto di cifra (0 oppure #) a sinistra del E-, E+, e-, oppure e+, il numero viene visualizzato in formato scientifico e E o e tra il numero e il relativo esponente verrà inserito.If the format expression contains at least one digit placeholder (0 or #) to the left of E-, E+, e-, or e+, the number is displayed in scientific format and E or e is inserted between the number and its exponent. Il numero di segnaposti cifra a sinistra determina il numero di cifre nell'esponente.The number of digit placeholders to the left determines the number of digits in the exponent. Uso E- o e- per inserire un segno meno accanto agli esponenti negativi.Use E- or e- to place a minus sign next to negative exponents. Uso E+ o e+ per inserire un segno meno accanto agli esponenti negativi e un segno più accanto agli esponenti positivi.Use E+ or e+ to place a minus sign next to negative exponents and a plus sign next to positive exponents. È necessario includere anche segnaposti cifra a destra del simbolo per ottenere una formattazione corretta.You must also include digit placeholders to the right of this symbol to get correct formatting.
- + $ ( )- + $ ( ) Caratteri letterali.Literal characters. Questi caratteri vengono visualizzati esattamente come vengono digitati nella stringa di formato.These characters are displayed exactly as typed in the format string. Per visualizzare un carattere diverso da quelli elencati, anteporvi una barra rovesciata (\) o racchiuderlo tra virgolette doppie ("").To display a character other than one of those listed, precede it with a backslash (\) or enclose it in double quotation marks (" ").
(\)(\) Visualizza il carattere successivo nella stringa di formato.Displays the next character in the format string. Per visualizzare un carattere dotato di significato speciale come carattere letterale, anteporvi una barra rovesciata (\).To display a character that has special meaning as a literal character, precede it with a backslash (\). Non viene visualizzata la barra rovesciata.The backslash itself isn't displayed. Con una barra rovesciata equivale racchiudere il carattere successivo tra virgolette doppie.Using a backslash is the same as enclosing the next character in double quotation marks. Per visualizzare una barra rovesciata, utilizzare due barre rovesciate (\\).To display a backslash, use two backslashes (\\).

Esempi di caratteri che non possono essere visualizzati come caratteri letterali sono i caratteri di formattazione delle date e formattazione dell'ora (a, c, d, h, m, n, p, q, s, t, w, y, /, e :), i caratteri di formattazione di numeri (#, 0, %, E, e, virgola e punto) e i caratteri di formattazione di stringhe (@, &, <, >, e !).Examples of characters that can't be displayed as literal characters are the date-formatting and time-formatting characters (a, c, d, h, m, n, p, q, s, t, w, y, /, and :), the numeric-formatting characters (#, 0, %, E, e, comma, and period), and the string-formatting characters (@, &, <, >, and !).
("``ABC``")("``ABC``") Visualizza la stringa racchiusa tra virgolette doppie ("").Displays the string inside the double quotation marks (" "). Per includere una stringa nell'argomento dello stile all'interno del codice, è necessario utilizzare Chr(34) racchiudere il testo (34 è il codice carattere per un segno di virgolette (")).To include a string in the style argument from within code, you must use Chr(34) to enclose the text (34 is the character code for a quotation mark (")).

Esempio di codice precedenteLegacy Code Example

Nella tabella seguente contiene alcuni esempi di espressioni di formato per i numeri.The following table contains some sample format expressions for numbers. (Questi esempi si presuppone che le impostazioni del sistema dalle impostazioni locali sono inglese-Stati Uniti) La prima colonna contiene le stringhe di formato per il Style argomento del Format funzione; le altre colonne contengono l'output risultante se i dati formattati dispongono del valore fornito nelle intestazioni di colonna.(These examples all assume that your system's locale setting is English-U.S.) The first column contains the format strings for the Style argument of the Format function; the other columns contain the resulting output if the formatted data has the value given in the column headings.

Formato (Style)Format (Style) "5" nel formato"5" formatted as "-5" nel formato"-5" formatted as "0,5" nel formato"0.5" formatted as
Zero-length string ("") 5 -5 0.5
0 5 -5 1
0.00 5.00 -5.00 0.50
#,##0 5 -5 1
$#,##0;($#,##0) $5 ($5) $1
$#,##0.00;($#,##0.00) $5.00 ($5.00) $0.50
0% 500% -500% 50%
0.00% 500.00% -500.00% 50.00%
0.00E+00 5.00E+00 -5.00E+00 5.00E-01
0.00E-00 5.00E00 -5.00E00 5.00E-01

Formati di data/ora predefinitiPredefined Date/Time Formats

Nella tabella seguente identifica il data predefiniti e i nomi di formato di ora.The following table identifies the predefined date and time format names. Questi possono essere usati in base al nome come argomento dello stile per il Format funzione:These may be used by name as the style argument for the Format function:

Nome del formatoFormat Name DescrizioneDescription
General Date, o GGeneral Date, or G Visualizza una data o ora.Displays a date and/or time. Ad esempio 3/12/2008 11:07:31 AM.For example, 3/12/2008 11:07:31 AM. Visualizzazione della data è determinata dal valore delle impostazioni cultura correnti dell'applicazione.Date display is determined by your application's current culture value.
Long Date, Medium Dateo DLong Date, Medium Date, or D Visualizza la data in base al formato di data estesa di cultura correnti.Displays a date according to your current culture's long date format. Ad esempio Wednesday, March 12, 2008.For example, Wednesday, March 12, 2008.
Short Date, o dShort Date, or d Visualizza la data utilizzando il formato di data breve di cultura correnti.Displays a date using your current culture's short date format. Ad esempio 3/12/2008.For example, 3/12/2008.

Il d carattere consente di visualizzare il giorno in un formato di data definito dall'utente.The d character displays the day in a user-defined date format.
Long Time, Medium Timeo TLong Time, Medium Time, or T Visualizza l'ora utilizzando il formato di ora estesa le impostazioni cultura correnti; in genere comprende ore, minuti, secondi.Displays a time using your current culture's long time format; typically includes hours, minutes, seconds. Ad esempio 11:07:31 AM.For example, 11:07:31 AM.
Short Time o tShort Time or t Visualizza l'ora utilizzando il formato di ora breve di cultura correnti.Displays a time using your current culture's short time format. Ad esempio 11:07 AM.For example, 11:07 AM.

Il t carattere consente di visualizzare AM o PM valori per le impostazioni locali che usano un formato a 12 ore in un formato ora definito dall'utente.The t character displays AM or PM values for locales that use a 12-hour clock in a user-defined time format.
f Visualizza la data estesa e ora breve in base al formato di cultura correnti.Displays the long date and short time according to your current culture's format. Ad esempio Wednesday, March 12, 2008 11:07 AM.For example, Wednesday, March 12, 2008 11:07 AM.
F Visualizza la data estesa e ora estesa in base al formato di cultura correnti.Displays the long date and long time according to your current culture's format. Ad esempio Wednesday, March 12, 2008 11:07:31 AM.For example, Wednesday, March 12, 2008 11:07:31 AM.
g Visualizza la data breve e ora breve in base al formato di cultura correnti.Displays the short date and short time according to your current culture's format. Ad esempio 3/12/2008 11:07 AM.For example, 3/12/2008 11:07 AM.
M, mM, m Visualizza il mese e giorno di una data.Displays the month and the day of a date. Ad esempio March 12.For example, March 12.

Il M carattere consente di visualizzare il mese in un formato di data definito dall'utente.The M character displays the month in a user-defined date format. Il m carattere consente di visualizzare i minuti in un formato ora definito dall'utente.The m character displays the minutes in a user-defined time format.
R, rR, r Consente di formattare la data in base al RFC1123Pattern proprietà.Formats the date according to the RFC1123Pattern property. Ad esempio Wed, 12 Mar 2008 11:07:31 GMT.For example, Wed, 12 Mar 2008 11:07:31 GMT. La data formattata non modificare il valore di data e ora.The formatted date does not adjust the value of the date and time. È necessario modificare il valore di data/ora in GMT prima di chiamare il Format (funzione).You must adjust the Date/Time value to GMT before calling the Format function.
s Formattare la data e ora come indice ordinabile.Formats the date and time as a sortable index. Ad esempio 2008-03-12T11:07:31.For example, 2008-03-12T11:07:31.

Il s carattere consente di visualizzare i secondi in un formato ora definito dall'utente.The s character displays the seconds in a user-defined time format.
u Formattare la data e ora come indice ordinabile GMT.Formats the date and time as a GMT sortable index. Ad esempio 2008-03-12 11:07:31Z.For example, 2008-03-12 11:07:31Z.
U Formattare la data e ora con la data e ora estesa come GMT.Formats the date and time with the long date and long time as GMT. Ad esempio Wednesday, March 12, 2008 6:07:31 PM.For example, Wednesday, March 12, 2008 6:07:31 PM.
Y, yY, y Formattare la data come anno e mese.Formats the date as the year and month. Ad esempio March, 2008.For example, March, 2008.

Il Y e y caratteri visualizzare l'anno in un formato di data definito dall'utente.The Y and y characters display the year in a user-defined date format.

Per altre informazioni sulle impostazioni cultura correnti dell'applicazione, vedere modo in cui le impostazioni cultura influisce sulle stringhe in Visual Basic.For more information about the application's current culture information, see How Culture Affects Strings in Visual Basic.

Formati di data/ora definiti dall'utenteUser-Defined Date/Time Formats

Nella tabella seguente Mostra caratteri che è possibile usare per creare formati di data/ora definiti dall'utente.The following table shows characters you can use to create user-defined date/time formats. A differenza nelle versioni precedenti di Visual Basic, i caratteri di formattazione sono tra maiuscole e minuscole.Unlike in earlier versions of Visual Basic, these format characters are case-sensitive.

CarattereCharacter DescrizioneDescription
(:)(:) Separatore dell'ora.Time separator. In alcune impostazioni locali, possono essere utilizzati altri caratteri per rappresentare il separatore dell'ora.In some locales, other characters may be used to represent the time separator. Il separatore dell'ora separa le ore, minuti e secondi nei valori di ora formattati.The time separator separates hours, minutes, and seconds when time values are formatted. Il carattere effettivo utilizzato come separatore dell'ora nell'output formattato è determinato dal valore delle impostazioni cultura correnti dell'applicazione.The actual character that is used as the time separator in formatted output is determined by your application's current culture value.
(/)(/) Separatore della data.Date separator. In alcune impostazioni locali, possono essere utilizzati altri caratteri per rappresentare il separatore della data.In some locales, other characters may be used to represent the date separator. Il separatore della data separa il giorno, mese e anno nei valori di data formattati.The date separator separates the day, month, and year when date values are formatted. Il carattere effettivo utilizzato come separatore della data nell'output formattato è determinato dalle impostazioni cultura correnti dell'applicazione.The actual character that is used as the date separator in formatted output is determined by your application's current culture.
(%)(%) Utilizzato per indicare che il carattere seguente deve essere letto come un formato a lettera singola indipendentemente dalle lettere finali.Used to indicate that the following character should be read as a single-letter format without regard to any trailing letters. Usato anche per indicare che un formato a lettera singola viene letto come un formato definito dall'utente.Also used to indicate that a single-letter format is read as a user-defined format. Vedere di seguito per altri dettagli.See what follows for additional details.
d Visualizza il giorno sotto forma di numero senza zero iniziale (ad esempio, 1).Displays the day as a number without a leading zero (for example, 1). Usare %d se questo è l'unico carattere nel formato numerico definito dall'utente.Use %d if this is the only character in your user-defined numeric format.
dd Visualizza il giorno sotto forma di numero con uno zero iniziale (ad esempio, 01).Displays the day as a number with a leading zero (for example, 01).
ddd Visualizza il giorno nella forma abbreviata (ad esempio, Sun).Displays the day as an abbreviation (for example, Sun).
dddd Visualizza il giorno con un nome completo (ad esempio, Sunday).Displays the day as a full name (for example, Sunday).
M Visualizza il mese sotto forma di numero senza zero iniziale (ad esempio gennaio viene rappresentato come 1).Displays the month as a number without a leading zero (for example, January is represented as 1). Usare %M se questo è l'unico carattere nel formato numerico definito dall'utente.Use %M if this is the only character in your user-defined numeric format.
MM Visualizza il mese sotto forma di numero con uno zero iniziale (ad esempio, 01/12/01).Displays the month as a number with a leading zero (for example, 01/12/01).
MMM Visualizza il mese nella forma abbreviata (ad esempio, Jan).Displays the month as an abbreviation (for example, Jan).
MMMM Visualizza il mese come nome completo del mese (ad esempio, January).Displays the month as a full month name (for example, January).
gg Visualizza la stringa di periodo/era (ad esempio, A.D.).Displays the period/era string (for example, A.D.).
h Visualizza l'ora sotto forma di numero senza zeri iniziali tramite il formato a 12 ore (ad esempio, 1:15:15 PM).Displays the hour as a number without leading zeros using the 12-hour clock (for example, 1:15:15 PM). Usare %h se questo è l'unico carattere nel formato numerico definito dall'utente.Use %h if this is the only character in your user-defined numeric format.
hh Visualizza l'ora sotto forma di numero con zeri iniziali tramite il formato a 12 ore (ad esempio, 01:15:15 PM).Displays the hour as a number with leading zeros using the 12-hour clock (for example, 01:15:15 PM).
H Visualizza l'ora sotto forma di numero senza zeri iniziali tramite il formato a 24 ore (ad esempio, 1:15:15).Displays the hour as a number without leading zeros using the 24-hour clock (for example, 1:15:15). Usare %H se questo è l'unico carattere nel formato numerico definito dall'utente.Use %H if this is the only character in your user-defined numeric format.
HH Visualizza l'ora sotto forma di numero con zeri iniziali tramite il formato a 24 ore (ad esempio, 01:15:15).Displays the hour as a number with leading zeros using the 24-hour clock (for example, 01:15:15).
m Visualizza il minuto sotto forma di numero senza zeri iniziali (ad esempio, 12:1:15).Displays the minute as a number without leading zeros (for example, 12:1:15). Usare %m se questo è l'unico carattere nel formato numerico definito dall'utente.Use %m if this is the only character in your user-defined numeric format.
mm Visualizza il minuto sotto forma di numero con zeri iniziali (ad esempio, 12:01:15).Displays the minute as a number with leading zeros (for example, 12:01:15).
s Visualizza il secondo sotto forma di numero senza zeri iniziali (ad esempio, 12:15:5).Displays the second as a number without leading zeros (for example, 12:15:5). Usare %s se questo è l'unico carattere nel formato numerico definito dall'utente.Use %s if this is the only character in your user-defined numeric format.
ss Visualizza il secondo sotto forma di numero con zeri iniziali (ad esempio, 12:15:05).Displays the second as a number with leading zeros (for example, 12:15:05).
f Visualizza le frazioni di secondo.Displays fractions of seconds. Ad esempio ff consente di visualizzare i centesimi di secondi, mentre ffff i decimillesimi di secondi.For example ff displays hundredths of seconds, whereas ffff displays ten-thousandths of seconds. È possibile usare fino a sette f simboli nel formato definito dall'utente.You may use up to seven f symbols in your user-defined format. Usare %f se questo è l'unico carattere nel formato numerico definito dall'utente.Use %f if this is the only character in your user-defined numeric format.
t Usa il formato a 12 ore e maiuscolo A per qualsiasi ora prima di mezzogiorno Visualizza maiuscolo P per qualsiasi ora tra mezzogiorno e le 11:59 P.M.Uses the 12-hour clock and displays an uppercase A for any hour before noon; displays an uppercase P for any hour between noon and 11:59 P.M. Usare %t se questo è l'unico carattere nel formato numerico definito dall'utente.Use %t if this is the only character in your user-defined numeric format.
tt Per impostazioni locali che usano un formato a 12 ore, viene visualizzato un maiuscolo AM con qualsiasi ora prima di mezzogiorno vengono visualizzate in maiuscolo PM con qualsiasi ora tra mezzogiorno e le 11:59 P.M.For locales that use a 12-hour clock, displays an uppercase AM with any hour before noon; displays an uppercase PM with any hour between noon and 11:59 P.M.

Per le impostazioni locali che usano un formato a 24 ore, verrà visualizzato nulla.For locales that use a 24-hour clock, displays nothing.
y Visualizza il numero dell'anno (0-9) senza zeri iniziali.Displays the year number (0-9) without leading zeros. Usare %y se questo è l'unico carattere nel formato numerico definito dall'utente.Use %y if this is the only character in your user-defined numeric format.
yy Visualizza l'anno in formato numerico a due cifre con uno zero iniziale, se applicabile.Displays the year in two-digit numeric format with a leading zero, if applicable.
yyy Visualizza l'anno nel formato numerico a quattro cifre.Displays the year in four-digit numeric format.
yyyy Visualizza l'anno nel formato numerico a quattro cifre.Displays the year in four-digit numeric format.
z Visualizza la differenza di fuso orario senza zero iniziale (ad esempio, -8).Displays the timezone offset without a leading zero (for example, -8). Usare %z se questo è l'unico carattere nel formato numerico definito dall'utente.Use %z if this is the only character in your user-defined numeric format.
zz Visualizza la differenza di fuso orario con uno zero iniziale (ad esempio, -08)Displays the timezone offset with a leading zero (for example, -08)
zzz Consente di visualizzare la differenza di fuso orario completa (ad esempio, -08:00)Displays the full timezone offset (for example, -08:00)

Esempio di codice precedenteLegacy Code Example

Di seguito sono riportati esempi di data definito dall'utente e formati di ora per December 7, 1958, 8:50 PM, 35 seconds:The following are examples of user-defined date and time formats for December 7, 1958, 8:50 PM, 35 seconds:

FormatoFormat VisualizzaDisplays
M/d/yy 12/7/58
d-MMM 7-Dec
d-MMMM-yy 7-December-58
d MMMM 7 December
MMMM yy December 58
hh:mm tt 08:50 PM
h:mm:ss t 8:50:35 P
H:mm 20:50
H:mm:ss 20:50:35
M/d/yyyy H:mm 12/7/1958 20:50

Note per gli sviluppatori di Smart DeviceSmart Device Developer Notes

La risoluzione di tempo minimo per un dispositivo viene determinata dal produttore del dispositivo.The minimum time resolution for a device is determined by the manufacturer of the device. Se il tempo di risoluzione per il dispositivo non è sufficientemente, precisa di f formato carattere restituisce 0 quando viene eseguito sul dispositivo.If the time resolution for the device is coarse enough, the f format character returns 0 when run on that device.

Si applica a

Vedi anche