Strings.Format(Object, String) Metodo

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

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

Style
String

facoltativo.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 metodo String.Format fornisce anche funzionalità simili.The String.Format method also provides similar functionality.

Se si sta formattando una stringa numerica non localizzata, è necessario usare 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, la funzione Format fornisce funzionalità simili a quelle della funzione Str, sebbene sia in grado di riconoscere a livello internazionale.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 formattati come stringhe tramite la funzione Format non includono uno spazio principale riservato per il segno del valore. quelli convertiti tramite la funzione Str mantengono lo spazio principale.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 valori numerici diversiDifferent Formats for Different Numeric Values

In un'espressione di formato definita dall'utente per i numeri possono essere incluse 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 l'argomento Style della funzione Format 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 si applica a tutti i valori.The format expression applies to all values.
DueTwo sections La prima sezione viene applicata ai valori positivi e agli zeri, la seconda 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, la seconda ai valori negativi e la terza agli zeri.The first section applies to positive values, the second applies to negative values, and the third applies to zeros.

Nell'esempio seguente sono presenti due sezioni: la prima 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é l'argomento Style della funzione Format 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 specificano punti e virgola consecutivi, la sezione mancante viene stampata utilizzando il formato dei valori positivi.If you include semicolons with nothing between them, the missing section is printed using the format of the positive value. Il formato seguente, ad esempio, Visualizza i valori positivi e negativi usando il formato nella prima sezione e visualizza 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 sono indicati i nomi dei formati numerici predefinitiThe following table identifies the predefined numeric format names. Questi possono essere utilizzati in base al nome come argomento Style per la funzione Format:These may be used by name as the Style argument for the Format function:

Nome del formatoFormat name DescriptionDescription
General Number, Go gGeneral Number, G, or g Visualizza il numero senza il 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 Visualizza il numero con il separatore delle migliaia, se appropriato. Visualizza due cifre a destra del separatore decimale.Displays number with thousand separator, if appropriate; displays two digits to the right of the decimal separator. L'output è basato 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 il numero con il 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 Il numero viene visualizzato moltiplicato per 100 con un segno di percentuale (%) aggiunto immediatamente a destra e sempre con due 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 Il numero viene visualizzato con il separatore delle migliaia, moltiplicato per 100 con un segno di percentuale (%) aggiunto immediatamente a destra e separato da uno spazio singolo. Inoltre viene visualizzato sempre con due 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 Viene utilizzata 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 Viene utilizzata 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 Il numero viene visualizzato come stringa contenente il valore del numero in formato decimale (in base 10).Displays number as a string that contains the value of the number in Decimal (base 10) format. Questa opzione è supportata solo per i tipi integrali (Byte, Short, Integer, Long).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 Il numero viene visualizzato come stringa contenente il valore del numero in formato esadecimale (in base 16).Displays number as a string that contains the value of the number in Hexadecimal (base 16) format. Questa opzione è supportata solo per i tipi integrali (Byte, Short, Integer, Long).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 Visualizza 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 Visualizza 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 Visualizza 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

I formati Yes/No, True/False e On/Off 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 vengono identificati i caratteri che è possibile utilizzare per creare formati di numero definiti dall'utente.The following table identifies characters you can use to create user-defined number formats. Questi possono essere usati per compilare l'argomento Style per la funzione Format:These may be used to build the Style argument for the Format function:

CarattereCharacter DescriptionDescription
nessunoNone Viene visualizzato il numero senza formattazione.Displays the number with no formatting.
(0)(0) Segnaposto cifra.Digit placeholder. Viene visualizzata una cifra o uno zero.Displays a digit or a zero. Se nell'espressione è presente una cifra nella posizione in cui lo zero viene visualizzato nella stringa di formato, visualizzarlo; in caso contrario, in tale posizione verrà visualizzato uno zero.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 è costituito da meno cifre di quanti sono gli zeri nell'espressione di formato, su entrambi i lati del separatore decimale, verranno visualizzati 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, a destra del separatore decimale nell'espressione di formato, il numero è costituito da più cifre di quanti sono gli zeri, viene arrotondato specificando 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, a sinistra del separatore decimale nell'espressione di formato, il numero è costituito da più cifre di quanti sono gli zeri, vengono visualizzate 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 cifra.Digit placeholder. Viene visualizzata una cifra o nulla.Displays a digit or nothing. Se nell'espressione è presente una cifra nella posizione in cui il carattere # viene visualizzato nella stringa di formato, lo Visualizza; in caso contrario, non viene visualizzato alcun elemento in quella 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 il segnaposto 0 digit, ad eccezione del fatto che gli zeri iniziali e finali non vengono visualizzati se il numero ha meno cifre rispetto a # caratteri su entrambi i 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 visualizzate 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 # a 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 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 come separatore decimale viene utilizzata la virgola.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, è necessario utilizzare il punto come segnaposto decimale nei formati in uso anche se per le 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 sarà visualizzata nel formato corretto per le impostazioni locali.The formatted string will appear in the format correct for the locale.
(%)(%) Segnaposto percentuale.Percent placeholder. Consente di moltiplicare l'espressione per 100.Multiplies the expression by 100. Il carattere di percentuale (%) viene inserito nella posizione in cui viene visualizzato 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 consente di separare 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. Viene specificato l'utilizzo standard del separatore delle migliaia se il formato contiene un separatore delle migliaia racchiuso tra segnaposto di cifra (0 o #).Standard use of the thousand separator is specified if the format contains a thousand separator surrounded by digit placeholders (0 or #).

Se un separatore delle migliaia è posizionato immediatamente a sinistra del separatore decimale, indipendentemente dal fatto che sia specificato un decimale, o come carattere più a destra della stringa, significa che il numero verrà 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 1.000 ma maggiori o uguali a 500 vengono visualizzati come 1 e 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 consentono di ridurre di 1 milione e di un fattore aggiuntivo di 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 una qualsiasi posizione diversa da immediatamente a sinistra del separatore decimale o all'estrema destra nella stringa vengono trattati come semplici elementi che specificano l'uso di un separatore di 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, come separatore delle migliaia viene utilizzato un punto.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 computer in uso.The actual character used as the thousand separator in the formatted output depends on the Number Format recognized by your system. Pertanto, è necessario utilizzare la virgola come separatore delle migliaia nei formati in uso anche se per le impostazioni locali configurate 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 sarà visualizzata 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:

- @ no__t-1, che usa il separatore delle migliaia per formattare il numero 100 milioni come stringa "100 milioni".- "#,0.", which uses the thousands separator to format the number 100 million as the string "100,000,000".
- @ no__t-1, che usa il ridimensionamento di un fattore 1000 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".
- @ no__t-1, che usa il separatore delle migliaia e il ridimensionamento di 1000 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 ora.Time separator. In alcune impostazioni locali, potrebbero essere utilizzati altri caratteri per rappresentare il separatore dell'ora.In some locales, other characters may be used to represent the time separator. Quest'ultimo consente di separare le ore, i minuti e i 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 in uso.The actual character used as the time separator in formatted output is determined by your system settings.
(/)(/) Separatore data.Date separator. In alcune impostazioni locali, potrebbero essere utilizzati altri caratteri per rappresentare il separatore della data.In some locales, other characters may be used to represent the date separator. Quest'ultimo consente di separare il giorno, il mese e l'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 in uso.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 o #) a sinistra di E-, E+, e- o e+, il numero viene visualizzato in formato scientifico e viene inserito E o e tra il numero e il relativo esponente.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 consente di determinare il numero di cifre nell'esponente.The number of digit placeholders to the left determines the number of digits in the exponent. Usare 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. Usare 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 di questo 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 uno di quelli elencati, precederlo con 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 con un significato speciale come carattere letterale, anteporre a una barra rovesciata (\).To display a character that has special meaning as a literal character, precede it with a backslash (\). La barra rovesciata non viene visualizzata.The backslash itself isn't displayed. L'uso di una barra rovesciata equivale a 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, usare 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 di data e ora (a, c, d, h, m, n, p, q, s, t, 0, 1, @no__ t-12 e 3), i caratteri di formattazione numerica (4, 5, 6, 7, 8, virgola e punto) e i caratteri di formattazione delle stringhe (9, 0, 1, 2 e 3).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``") Consente di visualizzare la stringa racchiusa tra virgolette doppie (" ").Displays the string inside the double quotation marks (" "). Per includere una stringa nell'argomento dello stile dall'interno del codice, è necessario utilizzare Chr(34) per racchiudere il testo (34 è il codice carattere per le 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 sono contenute alcune espressioni di formato di esempio per i numeri.The following table contains some sample format expressions for numbers. In questi esempi si presuppone che le impostazioni locali del sistema in uso siano inglese-Stati Uniti. La prima colonna contiene le stringhe di formato per l'argomento Style della funzione Format; le altre colonne contengono l'output risultante se i dati formattati hanno il valore specificato 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 sono identificati i nomi dei formati di data e ora predefiniti.The following table identifies the predefined date and time format names. Questi possono essere utilizzati in base al nome come argomento dello stile per la funzione Format:These may be used by name as the style argument for the Format function:

Nome del formatoFormat Name DescriptionDescription
General Date o GGeneral Date, or G Visualizza una data e/o un'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. La visualizzazione relativa alla data è determinata dal valore delle impostazioni cultura correnti dell'applicazione in uso.Date display is determined by your application's current culture value.
Long Date, Medium Dateo DLong Date, Medium Date, or D Viene visualizzata una data in base al formato di data estesa delle impostazioni 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 Viene visualizzata una data in base al formato di data breve delle impostazioni cultura correnti.Displays a date using your current culture's short date format. Ad esempio 3/12/2008.For example, 3/12/2008.

Il carattere d Visualizza 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 Viene visualizzata un'ora in base al formato ora estesa delle 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 Viene visualizzata un'ora in base al formato ora breve delle impostazioni cultura correnti.Displays a time using your current culture's short time format. Ad esempio 11:07 AM.For example, 11:07 AM.

Il carattere t Visualizza i valori AM o PM per le impostazioni locali che utilizzano un formato a 12 ore in un formato di 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 Viene visualizzata la data estesa e l'ora breve in base al formato delle impostazioni 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 Viene visualizzata la data estesa e l'ora estesa in base al formato delle impostazioni 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 Viene visualizzata la data breve e l'ora breve in base al formato delle impostazioni 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 Vengono visualizzati il mese e il giorno di una data.Displays the month and the day of a date. Ad esempio March 12.For example, March 12.

Il carattere M Visualizza il mese in un formato di data definito dall'utente.The M character displays the month in a user-defined date format. Il carattere m Visualizza i minuti in un formato di ora definito dall'utente.The m character displays the minutes in a user-defined time format.
R, rR, r Formatta la data in base alla proprietà RFC1123Pattern.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 consente di regolare il valore della data e ora.The formatted date does not adjust the value of the date and time. Prima di chiamare la funzione Format, è necessario modificare il valore di data/ora in GMT.You must adjust the Date/Time value to GMT before calling the Format function.
s Consente di 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 carattere s Visualizza i secondi in un formato di ora definito dall'utente.The s character displays the seconds in a user-defined time format.
u Consente di 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 Consente di formattare la data e ora con la data e l'ora estese in base al fuso orario 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 Consente di formattare la data come anno e mese.Formats the date as the year and month. Ad esempio March, 2008.For example, March, 2008.

I caratteri Y e y visualizzano 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 ulteriori informazioni sulle impostazioni cultura correnti dell'applicazione, vedere come le impostazioni cultura influiscono 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 vengono illustrati i caratteri che è possibile utilizzare per creare formati di data/ora definiti dall'utente.The following table shows characters you can use to create user-defined date/time formats. Diversamente dalle versioni precedenti di Visual Basic, questi caratteri di formato distinguono tra maiuscole e minuscole.Unlike in earlier versions of Visual Basic, these format characters are case-sensitive.

CarattereCharacter DescriptionDescription
(:)(:) Separatore ora.Time separator. In alcune impostazioni locali, potrebbero essere utilizzati altri caratteri per rappresentare il separatore dell'ora.In some locales, other characters may be used to represent the time separator. Quest'ultimo consente di separare le ore, i minuti e i 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 in uso.The actual character that is used as the time separator in formatted output is determined by your application's current culture value.
(/)(/) Separatore data.Date separator. In alcune impostazioni locali, potrebbero essere utilizzati altri caratteri per rappresentare il separatore della data.In some locales, other characters may be used to represent the date separator. Quest'ultimo consente di separare il giorno, il mese e l'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 in uso.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 successivo 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. Utilizzato 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 ulteriori dettagli.See what follows for additional details.
d Visualizza il giorno sotto forma di numero senza zero iniziali (ad esempio, 1).Displays the day as a number without a leading zero (for example, 1). Utilizzare %d se è 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 principale (ad esempio, 01).Displays the day as a number with a leading zero (for example, 01).
ddd Visualizza il giorno come abbreviazione, ad esempio Sun.Displays the day as an abbreviation (for example, Sun).
dddd Visualizza il giorno come 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 iniziali (ad esempio, gennaio è rappresentato come 1).Displays the month as a number without a leading zero (for example, January is represented as 1). Utilizzare %M se è 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 principale (ad esempio, 01/12/01).Displays the month as a number with a leading zero (for example, 01/12/01).
MMM Visualizza il mese come abbreviazione, ad esempio Jan.Displays the month as an abbreviation (for example, Jan).
MMMM Visualizza il nome completo del mese (ad esempio, January).Displays the month as a full month name (for example, January).
gg Visualizza la stringa del 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 usando 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). Utilizzare %h se è 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 usando 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 usando 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). Utilizzare %H se è 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 usando 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). Utilizzare %m se è 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). Utilizzare %s se è 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 Consente di visualizzare le frazioni di secondo.Displays fractions of seconds. Ad esempio ff Visualizza centesimi di secondi, mentre ffff Visualizza dieci millesimi di secondo.For example ff displays hundredths of seconds, whereas ffff displays ten-thousandths of seconds. È possibile utilizzare fino a sette simboli f nel formato definito dall'utente.You may use up to seven f symbols in your user-defined format. Utilizzare %f se è 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 visualizza una maiuscola A per qualsiasi ora prima di mezzogiorno; Visualizza un @no__t maiuscolo-1 per qualsiasi ora tra mezzogiorno e 11:59 oreUses 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. Utilizzare %t se è 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 le impostazioni locali che usano un formato a 12 ore, Visualizza una maiuscola AM con qualsiasi ora prima di mezzogiorno; Visualizza un @no__t maiuscolo-1 con qualsiasi ora tra mezzogiorno e 11:59.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 in cui viene utilizzato il formato a 24 ore, non viene visualizzato nulla.For locales that use a 24-hour clock, displays nothing.
y Consente di visualizzare il numero dell'anno (0-9) senza zeri iniziali.Displays the year number (0-9) without leading zeros. Utilizzare %y se è l'unico carattere nel formato numerico definito dall'utente.Use %y if this is the only character in your user-defined numeric format.
yy Consente di visualizzare 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 Consente di visualizzare l'anno in formato numerico a quattro cifre.Displays the year in four-digit numeric format.
yyyy Consente di visualizzare l'anno in formato numerico a quattro cifre.Displays the year in four-digit numeric format.
z Consente di visualizzare la differenza di fuso orario senza zero (ad esempio, -8).Displays the timezone offset without a leading zero (for example, -8). Utilizzare %z se è 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 del fuso orario con uno zero (ad esempio, -08)Displays the timezone offset with a leading zero (for example, -08)
zzz Visualizza l'offset completo del fuso orario (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 formati di data e ora definiti dall'utente 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 minima del tempo per un dispositivo è determinata dal produttore del dispositivo.The minimum time resolution for a device is determined by the manufacturer of the device. Se la risoluzione dell'ora del dispositivo è sufficientemente grossolana, il carattere di formato f restituisce 0 quando viene eseguito su tale 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