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

Definición

Devuelve una cadena con el formato que especifiquen las instrucciones contenidas en una expresión String de 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

Parámetros

Expression
Object Object Object

Obligatorio.Required. Cualquier expresión válida.Any valid expression.

Style
String String String

Opcional.Optional. Expresión válida de formato de tipo String con nombre o definida por el usuario.A valid named or user-defined format String expression.

Devoluciones

Cadena con el formato que especifiquen las instrucciones contenidas en una expresión String de formato.A string formatted according to instructions contained in a format String expression.

Ejemplos

En este ejemplo se muestran los diversos usos de la función Format para dar formato a valores tanto con formatos String como otros definidos por el usuario.This example shows various uses of the Format function to format values using both String formats and user-defined formats. Para el separador de fecha (/), hora (:) e indicadores de a.m./p.m. (t y tt), el formato de salida que muestre su sistema dependerá de la configuración regional que use el código.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. Cuando las horas y fechas se muestren en el entorno de desarrollo, se utilizará el formato de fecha y hora corta de la configuración regional del código.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

Para configuraciones regionales que utilizan un reloj de 24 horas, los indicadores de a.m./p.m. (t y tt) no muestran nada.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%")

Comentarios

El String.Format método también proporciona una funcionalidad similar.The String.Format method also provides similar functionality.

Si va a dar formato a una cadena numérica no localizada, debe utilizar un formato numérico definido por el usuario para asegurarse de que obtiene el aspecto que desea.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.

Si intenta dar formato a un número sin especificar Style, la Format función proporciona una funcionalidad similar a la Str función, aunque es internacionalmente consciente.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. Sin embargo, los números positivos con formato de Format cadenas mediante la función no incluyen un espacio inicial reservado para el signo del valor; los convertidos mediante la Str función conservan el espacio inicial.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.

Formatos diferentes para los distintos valores numéricosDifferent Formats for Different Numeric Values

Una expresión de formato definida por el usuario para números puede tener de una a tres secciones separadas por punto y coma.A user-defined format expression for numbers can have from one to three sections separated by semicolons. Si el Style argumento de la Format función contiene uno de los formatos numéricos predefinidos, solo se permite una sección.If the Style argument of the Format function contains one of the predefined numeric formats, only one section is allowed.

Si usaIf you use Este es el resultadoThis is the result
Solo una secciónOne section only La expresión de formato se aplica a todos los valores.The format expression applies to all values.
Dos seccionesTwo sections La primera sección se aplica a valores positivos y ceros; la segunda se aplica a los valores negativos.The first section applies to positive values and zeros; the second applies to negative values.
Tres secciones.Three sections La primera sección se aplica a los valores positivos, la segunda se aplica a los valores negativos y la tercera se aplica a ceros.The first section applies to positive values, the second applies to negative values, and the third applies to zeros.

El siguiente ejemplo tiene dos secciones: la primera define el formato de los valores positivos y los ceros; la segunda sección define el formato de los valores negativos.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. Puesto que Style el argumento de Format la función toma una cadena, se incluye entre comillas.Since the Style argument of the Format function takes a string, it is enclosed by quotation marks.

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

Si incluye signos de punto y coma sin nada entre ellos, la sección que falta se imprime utilizando el formato del valor positivo.If you include semicolons with nothing between them, the missing section is printed using the format of the positive value. Por ejemplo, el siguiente formato muestra los valores positivos y negativos utilizando el formato de la primera sección y Zero muestra si el valor es cero.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"

Formatos numéricos predefinidosPredefined Numeric Formats

En la tabla siguiente se identifican los nombres de formato numérico predefinidos.The following table identifies the predefined numeric format names. Se pueden usar por nombre como el Style argumento de la Format función:These may be used by name as the Style argument for the Format function:

Nombre de formatoFormat name DescripciónDescription
General Number, Go gGeneral Number, G, or g Muestra el número sin separador de miles.Displays number with no thousand separator.

Por ejemplo, Format(&H3FA, "g") devuelve 1018.For example, Format(&H3FA, "g") returns 1018.
Currency, Co cCurrency, C, or c Muestra el número con separador de miles, si es necesario. muestra dos dígitos a la derecha del separador decimal.Displays number with thousand separator, if appropriate; displays two digits to the right of the decimal separator. La salida se basa en la configuración regional del sistema.Output is based on system locale settings.

Por ejemplo, Format(1234567, "c") devuelve $1,234,567.00.For example, Format(1234567, "c") returns $1,234,567.00.
Fixed, Fo fFixed, F, or f Muestra al menos un dígito a la izquierda y dos a la derecha del separador decimal.Displays at least one digit to the left and two digits to the right of the decimal separator.

Por ejemplo, Format(1234567, "f") devuelve 1234567.00.For example, Format(1234567, "f") returns 1234567.00.
Standard, No nStandard, N, or n Muestra el número con separador de miles, al menos un dígito a la izquierda y dos a la derecha del separador de decimales.Displays number with thousand separator, at least one digit to the left and two digits to the right of the decimal separator.

Por ejemplo, Format(1234567, "n") devuelve 1,234,567.00.For example, Format(1234567, "n") returns 1,234,567.00.
Percent Muestra el número multiplicado por 100 por un signo de porcentaje (%) anexa inmediatamente a la derecha; siempre muestra dos dígitos a la derecha del separador decimal.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.

Por ejemplo, Format(0.4744, "Percent") devuelve 47.44%.For example, Format(0.4744, "Percent") returns 47.44%.
P, opP, or p Muestra el número con separador de milésimas multiplicado por 100 con un signo de porcentaje (%) se anexa a la derecha y se separa mediante un solo espacio; siempre muestra dos dígitos a la derecha del separador decimal.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.

Por ejemplo, Format(0.80345, "p") devuelve 80.35 %.For example, Format(0.80345, "p") returns 80.35 %.
Scientific Utiliza la notación científica estándar, que proporciona dos dígitos significativos.Uses standard scientific notation, providing two significant digits.

Por ejemplo, Format(1234567, "Scientific") devuelve 1.23E+06.For example, Format(1234567, "Scientific") returns 1.23E+06.
E, oeE, or e Utiliza la notación científica estándar, que proporciona seis dígitos significativos.Uses standard scientific notation, providing six significant digits.

Por ejemplo, Format(1234567, "e") devuelve 1.234567e+006.For example, Format(1234567, "e") returns 1.234567e+006.
D, odD, or d Muestra el número como una cadena que contiene el valor del número en formato decimal (base 10).Displays number as a string that contains the value of the number in Decimal (base 10) format. Esta opción solo se admite para los tiposByteenteros Short( Integer, Long,,).This option is supported for integral types (Byte, Short, Integer, Long) only.

Por ejemplo, Format(&H7F, "d") devuelve 127.For example, Format(&H7F, "d") returns 127.
X, oxX, or x Muestra el número como una cadena que contiene el valor del número en formato hexadecimal (base 16).Displays number as a string that contains the value of the number in Hexadecimal (base 16) format. Esta opción solo se admite para los tiposByteenteros Short( Integer, Long,,).This option is supported for integral types (Byte, Short, Integer, Long) only.

Por ejemplo, Format(127, "x") devuelve 7f.For example, Format(127, "x") returns 7f.
Yes/No Muestra No si el número es 0; de lo Yescontrario, muestra.Displays No if number is 0; otherwise, displays Yes.

Por ejemplo, Format(0, "Yes/No") devuelve No.For example, Format(0, "Yes/No") returns No.
True/False Muestra False si el número es 0; de lo Truecontrario, muestra.Displays False if number is 0; otherwise, displays True.

Por ejemplo, Format(1, "True/False") devuelve True.For example, Format(1, "True/False") returns True.
On/Off Muestra Off si el número es 0; de lo Oncontrario, muestra.Displays Off if number is 0; otherwise, displays On.

Por ejemplo, Format(1, "On/Off") devuelve On.For example, Format(1, "On/Off") returns On.

Notas para desarrolladores de Smart DeviceSmart Device Developer Notes

No Yes/Nose True/Falseadmiten On/Off los formatos, y.The Yes/No, True/False, and On/Off formats are not supported.

Formatos numéricos definidos por el usuarioUser-Defined Numeric Formats

En la tabla siguiente se identifican los caracteres que se pueden usar para crear formatos de número definidos por el usuario.The following table identifies characters you can use to create user-defined number formats. Se pueden usar para generar el Style argumento para la Format función:These may be used to build the Style argument for the Format function:

CarácterCharacter DescripciónDescription
NingunaNone Muestra el número sin formato.Displays the number with no formatting.
(0)(0) Marcador de posición de dígitos.Digit placeholder. Muestra un dígito o un cero.Displays a digit or a zero. Si la expresión tiene un dígito en la posición donde aparece el cero en la cadena de formato, se muestra; de lo contrario, muestra un cero en esa posición.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.

Si el número tiene menos dígitos que ceros (en cualquier lado del separador decimal) en la expresión de formato, muestra ceros a la izquierda o a la derecha.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. Si el número tiene más dígitos a la derecha del separador decimal que ceros a la derecha del separador decimal en la expresión de formato, redondea el número a tantos lugares decimales como ceros haya.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. Si el número tiene más dígitos a la izquierda del separador decimal que ceros a la izquierda del separador decimal en la expresión de formato, muestra los dígitos adicionales sin modificación.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.
(#)(#) Marcador de posición de dígitos.Digit placeholder. Muestra un dígito o nada.Displays a digit or nothing. Si la expresión tiene un dígito en la posición donde aparece # el carácter en la cadena de formato, lo muestra; de lo contrario, no muestra nada en esa posición.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.

Este símbolo funciona como el 0 marcador de posición de dígitos, salvo que no se # muestran ceros a la izquierda ni a la derecha si el número tiene menos dígitos que caracteres situados a cada lado del separador decimal en la expresión de 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.
(.)(.) Marcador de posición decimal.Decimal placeholder. El marcador de posición decimal determina el número de dígitos que se muestran a la izquierda y a la derecha del separador decimal.The decimal placeholder determines how many digits are displayed to the left and right of the decimal separator. Si la expresión de formato solo # contiene caracteres a la izquierda de este símbolo; los números menores que 1 comienzan con un separador decimal.If the format expression contains only # characters to the left of this symbol; numbers smaller than 1 begin with a decimal separator. Para mostrar un cero a la izquierda con números fraccionarios, utilice el cero como primer marcador de posición de dígitos a la izquierda del separador de decimales.To display a leading zero displayed with fractional numbers, use zero as the first digit placeholder to the left of the decimal separator. En algunas configuraciones regionales, se usa una coma como separador decimal.In some locales, a comma is used as the decimal separator. El carácter real utilizado como marcador de posición de decimales en la salida con formato depende del formato de número que reconozca el sistema.The actual character used as a decimal placeholder in the formatted output depends on the number format recognized by your system. Por lo tanto, debe usar el punto como el marcador de posición decimal en los formatos, incluso si está en una configuración regional que usa una coma como marcador de posición decimal.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 cadena con formato aparecerá en el formato correcto para la configuración regional.The formatted string will appear in the format correct for the locale.
(%)(%) Marcador de posición de porcentaje.Percent placeholder. Multiplica la expresión por 100.Multiplies the expression by 100. El carácter de porcentaje%() se inserta en la posición en la que aparece en la cadena de formato.The percent character (%) is inserted in the position where it appears in the format string.
(,)(,) Separador de miles.Thousand separator. El separador de miles separa miles de cientos en un número que tiene cuatro o más posiciones a la izquierda del separador decimal.The thousand separator separates thousands from hundreds within a number that has four or more places to the left of the decimal separator. El uso estándar del separador de miles se especifica si el formato contiene un separador de miles rodeado de0 marcadores #de posición de dígitos (o).Standard use of the thousand separator is specified if the format contains a thousand separator surrounded by digit placeholders (0 or #).

Un separador de miles inmediatamente a la izquierda del separador decimal (tanto si se ha especificado un decimal como si no) o como el carácter situado más a la derecha de la cadena significa "escalar el número dividiéndolo por 1.000, redondeo según sea necesario".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." Los números menores que 1.000 pero mayores o iguales a 500 se muestran 1como, y los números menores que 500 se 0muestran como.Numbers smaller than 1,000 but greater or equal to 500 are displayed as 1, and numbers smaller than 500 are displayed as 0. Dos separadores de miles adyacentes en esta posición escalan por un factor de 1 millón y un factor adicional de 1.000 para cada separador adicional.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.

Los separadores múltiples en cualquier posición que no sea la inmediatamente a la izquierda del separador decimal o la posición más a la derecha de la cadena se tratan simplemente como si se especificara el uso de un separador de miles.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. En algunas configuraciones regionales, se usa un punto como separador de miles.In some locales, a period is used as a thousand separator. El carácter real que se usa como separador de miles en la salida con formato depende del formato de número que reconozca el sistema.The actual character used as the thousand separator in the formatted output depends on the Number Format recognized by your system. Por lo tanto, debe usar la coma como separador de miles en los formatos, incluso si está en una configuración regional que usa un punto como separador de miles.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 cadena con formato aparecerá en el formato correcto para la configuración regional.The formatted string will appear in the format correct for the locale.

Por ejemplo, considere las tres cadenas de formato siguientes:For example, consider the three following format strings:

- "#,0.", que usa el separador de miles para dar formato al número 100 millones como la cadena "100 millones".- "#,0.", which uses the thousands separator to format the number 100 million as the string "100,000,000".
- "#0,.", que usa el escalado en un factor de 1000 para dar formato al número 100 millones como la cadena "100000".- "#0,.", which uses scaling by a factor of one thousand to format the number 100 million as the string "100000".
- "#,0,.", que usa el separador de miles y el escalado de 1000 para dar formato al número 100 millones como la cadena "100.000".- "#,0,.", which uses the thousands separator and scaling by one thousand to format the number 100 million as the string "100,000".
(:)(:) Separador de hora.Time separator. En algunas configuraciones regionales, se pueden usar otros caracteres para representar el separador de hora.In some locales, other characters may be used to represent the time separator. El separador de hora separa las horas, los minutos y los segundos cuando se da formato a los valores de hora.The time separator separates hours, minutes, and seconds when time values are formatted. La configuración del sistema determina el carácter real que se usa como separador de hora en la salida con formato.The actual character used as the time separator in formatted output is determined by your system settings.
(/)(/) Separador de fecha.Date separator. En algunas configuraciones regionales, se pueden usar otros caracteres para representar el separador de fecha.In some locales, other characters may be used to represent the date separator. El separador de fecha separa el día, el mes y el año en que se da formato a los valores de fecha.The date separator separates the day, month, and year when date values are formatted. La configuración del sistema determina el carácter real que se usa como separador de fecha en la salida con formato.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 científico.Scientific format. Si la expresión de formato contiene al menos un marcador de0 posición #de dígitos (o) E-a E+ e-la izquierda de e+,, o, el número se muestra en E formato científico y o e se inserta entre el número y su exponente.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. El número de marcadores de posición de dígitos a la izquierda determina el número de dígitos del exponente.The number of digit placeholders to the left determines the number of digits in the exponent. Use E- oe- para colocar un signo menos junto a los exponentes negativos.Use E- or e- to place a minus sign next to negative exponents. Use E+ oe+ para colocar un signo menos junto a los exponentes negativos y un signo más junto a los exponentes positivos.Use E+ or e+ to place a minus sign next to negative exponents and a plus sign next to positive exponents. También debe incluir marcadores de posición de dígitos a la derecha de este símbolo para obtener el formato correcto.You must also include digit placeholders to the right of this symbol to get correct formatting.
- + $ ( )- + $ ( ) Caracteres literales.Literal characters. Estos caracteres se muestran exactamente como se escriben en la cadena de formato.These characters are displayed exactly as typed in the format string. Para mostrar un carácter que no sea uno de los enumerados, debe ir precedido de\una barra diagonal inversa () o encerrarlo entre comillas dobles ("").To display a character other than one of those listed, precede it with a backslash (\) or enclose it in double quotation marks (" ").
(\) Muestra el siguiente carácter en la cadena de formato.(\)
("``ABC``")("``ABC``") Muestra la cadena entre comillas dobles ("").Displays the string inside the double quotation marks (" "). Para incluir una cadena en el argumento de estilo de en el código, debe Chr(34) usar para incluir el texto34 (es el código de carácter de una comilla (")).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 (")).

Ejemplo de código heredadoLegacy Code Example

La tabla siguiente contiene algunas expresiones de formato de ejemplo para los números.The following table contains some sample format expressions for numbers. (En estos ejemplos se asume que la configuración regional del sistema es inglés-U. S). La primera columna contiene las cadenas de formato para Style el argumento de Format la función; las demás columnas contienen la salida resultante si los datos con formato tienen el valor especificado en los encabezados de columna.(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" con el formato"5" formatted as "-5" con el formato"-5" formatted as "0,5" con el 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

Formatos de fecha y hora predefinidosPredefined Date/Time Formats

En la tabla siguiente se identifican los nombres de formato de fecha y hora predefinidos.The following table identifies the predefined date and time format names. Se pueden usar por nombre como el argumento de estilo de la Format función:These may be used by name as the style argument for the Format function:

Nombre de formatoFormat Name DescripciónDescription
General Date, oGGeneral Date, or G Muestra una fecha o una hora.Displays a date and/or time. Por ejemplo: 3/12/2008 11:07:31 AM.For example, 3/12/2008 11:07:31 AM. La presentación de fecha está determinada por el valor de referencia cultural actual de la aplicación.Date display is determined by your application's current culture value.
Long Date, Medium Dateo DLong Date, Medium Date, or D Muestra una fecha según el formato de fecha larga de la referencia cultural actual.Displays a date according to your current culture's long date format. Por ejemplo: Wednesday, March 12, 2008.For example, Wednesday, March 12, 2008.
Short Date, odShort Date, or d Muestra una fecha con el formato de fecha corta de la referencia cultural actual.Displays a date using your current culture's short date format. Por ejemplo: 3/12/2008.For example, 3/12/2008.

El d carácter muestra el día en un formato de fecha definido por el usuario.The d character displays the day in a user-defined date format.
Long Time, Medium Timeo TLong Time, Medium Time, or T Muestra una hora con el formato de hora larga de la referencia cultural actual; normalmente incluye horas, minutos y segundos.Displays a time using your current culture's long time format; typically includes hours, minutes, seconds. Por ejemplo: 11:07:31 AM.For example, 11:07:31 AM.
Short Time o tShort Time or t Muestra una hora con el formato de hora corta de la referencia cultural actual.Displays a time using your current culture's short time format. Por ejemplo: 11:07 AM.For example, 11:07 AM.

El t carácter muestra AM oPM los valores de las configuraciones regionales que utilizan un reloj de 12 horas en un formato de hora definido por el usuario.The t character displays AM or PM values for locales that use a 12-hour clock in a user-defined time format.
f Muestra la fecha larga y la hora corta según el formato de la referencia cultural actual.Displays the long date and short time according to your current culture's format. Por ejemplo: Wednesday, March 12, 2008 11:07 AM.For example, Wednesday, March 12, 2008 11:07 AM.
F Muestra la fecha larga y la hora larga según el formato de la referencia cultural actual.Displays the long date and long time according to your current culture's format. Por ejemplo: Wednesday, March 12, 2008 11:07:31 AM.For example, Wednesday, March 12, 2008 11:07:31 AM.
g Muestra la fecha corta y la hora corta según el formato de la referencia cultural actual.Displays the short date and short time according to your current culture's format. Por ejemplo: 3/12/2008 11:07 AM.For example, 3/12/2008 11:07 AM.
M, mM, m Muestra el mes y el día de una fecha.Displays the month and the day of a date. Por ejemplo: March 12.For example, March 12.

El M carácter muestra el mes en un formato de fecha definido por el usuario.The M character displays the month in a user-defined date format. El m carácter muestra los minutos en un formato de hora definido por el usuario.The m character displays the minutes in a user-defined time format.
R, rR, r Da formato a la fecha según RFC1123Pattern la propiedad.Formats the date according to the RFC1123Pattern property. Por ejemplo: Wed, 12 Mar 2008 11:07:31 GMT.For example, Wed, 12 Mar 2008 11:07:31 GMT. La fecha con formato no ajusta el valor de la fecha y la hora.The formatted date does not adjust the value of the date and time. Debe ajustar el valor de fecha y hora a GMT antes de llamar Format a la función.You must adjust the Date/Time value to GMT before calling the Format function.
s Da formato a la fecha y hora como un índice que se va a ordenar.Formats the date and time as a sortable index. Por ejemplo: 2008-03-12T11:07:31.For example, 2008-03-12T11:07:31.

El s carácter muestra los segundos en un formato de hora definido por el usuario.The s character displays the seconds in a user-defined time format.
u Da formato a la fecha y hora como un índice que se va a ordenar GMT.Formats the date and time as a GMT sortable index. Por ejemplo: 2008-03-12 11:07:31Z.For example, 2008-03-12 11:07:31Z.
U Da formato a la fecha y hora con la fecha larga y la hora larga como GMT.Formats the date and time with the long date and long time as GMT. Por ejemplo: Wednesday, March 12, 2008 6:07:31 PM.For example, Wednesday, March 12, 2008 6:07:31 PM.
Y, yY, y Da formato a la fecha como el año y el mes.Formats the date as the year and month. Por ejemplo: March, 2008.For example, March, 2008.

Los Y caracteres y y muestran el año en un formato de fecha definido por el usuario.The Y and y characters display the year in a user-defined date format.

Para obtener más información sobre la información de referencia cultural actual de la aplicación, vea Cómo afecta la referencia cultural a las cadenas en Visual Basic.For more information about the application's current culture information, see How Culture Affects Strings in Visual Basic.

Formatos de fecha y hora definidos por el usuarioUser-Defined Date/Time Formats

En la tabla siguiente se muestran los caracteres que puede usar para crear formatos de fecha y hora definidos por el usuario.The following table shows characters you can use to create user-defined date/time formats. A diferencia de las versiones anteriores de Visual Basic, estos caracteres de formato distinguen mayúsculas de minúsculas.Unlike in earlier versions of Visual Basic, these format characters are case-sensitive.

CarácterCharacter DescripciónDescription
(:)(:) Separador de hora.Time separator. En algunas configuraciones regionales, se pueden usar otros caracteres para representar el separador de hora.In some locales, other characters may be used to represent the time separator. El separador de hora separa las horas, los minutos y los segundos cuando se da formato a los valores de hora.The time separator separates hours, minutes, and seconds when time values are formatted. El carácter real que se usa como separador de hora en la salida con formato viene determinado por el valor de referencia cultural actual de la aplicación.The actual character that is used as the time separator in formatted output is determined by your application's current culture value.
(/)(/) Separador de fecha.Date separator. En algunas configuraciones regionales, se pueden usar otros caracteres para representar el separador de fecha.In some locales, other characters may be used to represent the date separator. El separador de fecha separa el día, el mes y el año en que se da formato a los valores de fecha.The date separator separates the day, month, and year when date values are formatted. El carácter real que se usa como separador de fecha en la salida con formato viene determinado por la referencia cultural actual de la aplicación.The actual character that is used as the date separator in formatted output is determined by your application's current culture.
(%)(%) Se utiliza para indicar que el siguiente carácter se debe leer como un formato de una sola letra sin tener en cuenta las letras finales.Used to indicate that the following character should be read as a single-letter format without regard to any trailing letters. También se usa para indicar que un formato de una sola letra se lee como un formato definido por el usuario.Also used to indicate that a single-letter format is read as a user-defined format. Vea lo siguiente para obtener más información.See what follows for additional details.
d Muestra el día como un número sin un cero a la izquierda (por 1ejemplo,).Displays the day as a number without a leading zero (for example, 1). Use %d si es el único carácter de su formato numérico definido por el usuario.Use %d if this is the only character in your user-defined numeric format.
dd Muestra el día como un número con un cero a la izquierda (por 01ejemplo,).Displays the day as a number with a leading zero (for example, 01).
ddd Muestra el día como una abreviatura (por ejemplo, Sun).Displays the day as an abbreviation (for example, Sun).
dddd Muestra el día como un nombre completo (por ejemplo, Sunday).Displays the day as a full name (for example, Sunday).
M Muestra el mes como un número sin un cero a la izquierda (por ejemplo, enero se 1representa como).Displays the month as a number without a leading zero (for example, January is represented as 1). Use %M si es el único carácter de su formato numérico definido por el usuario.Use %M if this is the only character in your user-defined numeric format.
MM Muestra el mes como un número con un cero a la izquierda (por 01/12/01ejemplo,).Displays the month as a number with a leading zero (for example, 01/12/01).
MMM Muestra el mes como una abreviatura (por ejemplo, Jan).Displays the month as an abbreviation (for example, Jan).
MMMM Muestra el mes como un nombre completo del mes (por ejemplo January,).Displays the month as a full month name (for example, January).
gg Muestra la cadena de período/era (por ejemplo A.D.,).Displays the period/era string (for example, A.D.).
h Muestra la hora como un número sin ceros a la izquierda utilizando el reloj de 12 horas (por ejemplo 1:15:15 PM,).Displays the hour as a number without leading zeros using the 12-hour clock (for example, 1:15:15 PM). Use %h si es el único carácter de su formato numérico definido por el usuario.Use %h if this is the only character in your user-defined numeric format.
hh Muestra la hora como un número con ceros a la izquierda utilizando el reloj de 12 horas (por ejemplo 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 Muestra la hora como un número sin ceros a la izquierda utilizando el reloj de 24 horas (por ejemplo 1:15:15,).Displays the hour as a number without leading zeros using the 24-hour clock (for example, 1:15:15). Use %H si es el único carácter de su formato numérico definido por el usuario.Use %H if this is the only character in your user-defined numeric format.
HH Muestra la hora como un número con ceros a la izquierda utilizando el reloj de 24 horas (por ejemplo 01:15:15,).Displays the hour as a number with leading zeros using the 24-hour clock (for example, 01:15:15).
m Muestra el minuto como un número sin ceros a la izquierda (por ejemplo 12:1:15,).Displays the minute as a number without leading zeros (for example, 12:1:15). Use %m si es el único carácter de su formato numérico definido por el usuario.Use %m if this is the only character in your user-defined numeric format.
mm Muestra el minuto como un número con ceros a la izquierda (por ejemplo 12:01:15,).Displays the minute as a number with leading zeros (for example, 12:01:15).
s Muestra el segundo como un número sin ceros a la izquierda (por ejemplo 12:15:5,).Displays the second as a number without leading zeros (for example, 12:15:5). Use %s si es el único carácter de su formato numérico definido por el usuario.Use %s if this is the only character in your user-defined numeric format.
ss Muestra el segundo como un número con ceros a la izquierda (por ejemplo 12:15:05,).Displays the second as a number with leading zeros (for example, 12:15:05).
f Muestra fracciones de segundos.Displays fractions of seconds. Por ejemplo ff , muestra las centésimas de segundo ffff , mientras que muestra las diezmilésimas de segundo.For example ff displays hundredths of seconds, whereas ffff displays ten-thousandths of seconds. Puede usar hasta siete f símbolos en el formato definido por el usuario.You may use up to seven f symbols in your user-defined format. Use %f si es el único carácter de su formato numérico definido por el usuario.Use %f if this is the only character in your user-defined numeric format.
t Usa el reloj de 12 horas y muestra un mayúscula A para cualquier hora antes del mediodía; muestra una P letra mayúscula para cualquier hora entre el mediodía y la 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. Use %t si es el único carácter de su formato numérico definido por el usuario.Use %t if this is the only character in your user-defined numeric format.
tt En el caso de las configuraciones regionales que usan un reloj de 12 horas AM , muestra mayúsculas con cualquier hora antes del PM mediodía; muestra las mayúsculas con cualquier hora entre el mediodía y las 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.

En el caso de las configuraciones regionales que utilizan un reloj de 24 horas, no muestra nada.For locales that use a 24-hour clock, displays nothing.
y Muestra el número de año (0-9) sin ceros a la izquierda.Displays the year number (0-9) without leading zeros. Use %y si es el único carácter de su formato numérico definido por el usuario.Use %y if this is the only character in your user-defined numeric format.
yy Muestra el año en formato numérico de dos dígitos con un cero a la izquierda, si procede.Displays the year in two-digit numeric format with a leading zero, if applicable.
yyy Muestra el año en formato numérico de cuatro dígitos.Displays the year in four-digit numeric format.
yyyy Muestra el año en formato numérico de cuatro dígitos.Displays the year in four-digit numeric format.
z Muestra el desplazamiento de zona horaria sin un cero a la izquierda -8(por ejemplo,).Displays the timezone offset without a leading zero (for example, -8). Use %z si es el único carácter de su formato numérico definido por el usuario.Use %z if this is the only character in your user-defined numeric format.
zz Muestra el desplazamiento de zona horaria con un cero a la izquierda -08(por ejemplo,).Displays the timezone offset with a leading zero (for example, -08)
zzz Muestra el desplazamiento de zona horaria completo (por -08:00ejemplo,)Displays the full timezone offset (for example, -08:00)

Ejemplo de código heredadoLegacy Code Example

A continuación se muestran ejemplos de formatos de fecha y hora definidos por December 7, 1958, 8:50 PM, 35 secondsel usuario para:The following are examples of user-defined date and time formats for December 7, 1958, 8:50 PM, 35 seconds:

FormatoFormat MuestraDisplays
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

Notas para desarrolladores de Smart DeviceSmart Device Developer Notes

La resolución de tiempo mínima para un dispositivo viene determinada por el fabricante del dispositivo.The minimum time resolution for a device is determined by the manufacturer of the device. Si la resolución de tiempo para el dispositivo es lo suficientemente gruesa f , el carácter de formato devuelve 0 cuando se ejecuta en ese dispositivo.If the time resolution for the device is coarse enough, the f format character returns 0 when run on that device.

Se aplica a

Consulte también: