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

Определение

Возвращает строку, отформатированную в соответствии с инструкциями, содержащимися в формате выражения String.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

Параметры

Expression
Object Object Object

Обязательный.Required. Любое допустимое выражение.Any valid expression.

Style
String String String

Необязательный параметр.Optional. Правильно именованное или определенное пользователем выражение формата String.A valid named or user-defined format String expression.

Возвраты

Строка, отформатированная в соответствии с инструкциями, содержащимися в формате выражения String.A string formatted according to instructions contained in a format String expression.

Примеры

В данном примере показаны различные способы использования функции Format для форматирования значений с применением как форматов String, так и определенных пользователем форматов.This example shows various uses of the Format function to format values using both String formats and user-defined formats. Фактическое отображение системой разделителя даты (/), разделителя времени (: и индикаторов AM/PM (t и tt) зависит от региональных параметров, применяемых кодом.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. При отображении времени и даты в среде разработки используется короткий формат времени и даты региональных установок кода.When times and dates are displayed in the development environment, the short time format and short date format of the code locale are used.

Примечание

Для языков, использующих 24-часовой формат, индикаторы AM/PM (t и tt) не отображаются.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%")

Комментарии

String.Format Метод также предоставляет аналогичные функции.The String.Format method also provides similar functionality.

При форматировании нелокализованной числовой строки следует использовать определенный пользователем числовой формат, чтобы убедиться, что вы хотите получить нужный вид.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.

Если вы попытаетесь отформатировать число Styleбез указания Format функции, функция Str предоставляет функциональные возможности, аналогичные функции, хотя это Международная осведомленность.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. Однако положительные числа, отформатированные как строки Format с помощью функции, не включают в себя начальное пространство, зарезервированное для знака значения Str ; преобразования, преобразованные с помощью функции, содержат начальное пространство.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.

Различные форматы для различных числовых значенийDifferent Formats for Different Numeric Values

Определяемое пользователем выражение формата для чисел может содержать от одного до трех разделов, разделенных точкой с запятой.A user-defined format expression for numbers can have from one to three sections separated by semicolons. Style Если аргумент Format функции содержит один из стандартных числовых форматов, допускается только один раздел.If the Style argument of the Format function contains one of the predefined numeric formats, only one section is allowed.

При использованииIf you use Это результатThis is the result
Только один разделOne section only Выражение формата применяется ко всем значениям.The format expression applies to all values.
Две секцииTwo sections Первый раздел применяется к положительным и нулевым значениям; второй применяется к отрицательным значениям.The first section applies to positive values and zeros; the second applies to negative values.
Три секцииThree sections Первый раздел применяется к положительным значениям, а второй применяется к отрицательным значениям, а третья — к нулю.The first section applies to positive values, the second applies to negative values, and the third applies to zeros.

Следующий пример содержит два раздела: первый определяет формат для положительных и нулевых значений; во втором разделе определяется формат отрицательных значений.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. Style Поскольку аргумент Format функции принимает строку, он заключен в кавычки.Since the Style argument of the Format function takes a string, it is enclosed by quotation marks.

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

Если в символах точки с запятой нет ничего, то раздел Missing будет распечатан с использованием формата положительного значения.If you include semicolons with nothing between them, the missing section is printed using the format of the positive value. Например, следующий формат отображает положительные и отрицательные значения, используя формат в первом разделе, и отображает 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"

Предопределенные числовые форматыPredefined Numeric Formats

В следующей таблице приведены стандартные имена числовых форматов.The following table identifies the predefined numeric format names. Они могут использоваться именем в качестве Style аргумента Format функции:These may be used by name as the Style argument for the Format function:

Название форматаFormat name ОписаниеDescription
General Number, Gили gGeneral Number, G, or g Отображает число без разделителя тысяч.Displays number with no thousand separator.

Например, Format(&H3FA, "g") возвращает 1018.For example, Format(&H3FA, "g") returns 1018.
Currency, Cили cCurrency, C, or c При необходимости отображает число с разделителем тысяч. отображает две цифры справа от десятичного разделителя.Displays number with thousand separator, if appropriate; displays two digits to the right of the decimal separator. Выходные данные основываются на параметрах национальной настройки системы.Output is based on system locale settings.

Например, Format(1234567, "c") возвращает $1,234,567.00.For example, Format(1234567, "c") returns $1,234,567.00.
Fixed, Fили fFixed, F, or f Отображает по крайней мере одну цифру слева и две цифры справа от десятичного разделителя.Displays at least one digit to the left and two digits to the right of the decimal separator.

Например, Format(1234567, "f") возвращает 1234567.00.For example, Format(1234567, "f") returns 1234567.00.
Standard, Nили nStandard, N, or n Отображает число с разделителем тысяч, по крайней мере одну цифру слева и две цифры справа от десятичного разделителя.Displays number with thousand separator, at least one digit to the left and two digits to the right of the decimal separator.

Например, Format(1234567, "n") возвращает 1,234,567.00.For example, Format(1234567, "n") returns 1,234,567.00.
Percent Отображает число, умноженное на 100 со знаком процента (%) немедленное Добавление вправо; всегда отображает две цифры справа от десятичного разделителя.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.

Например, Format(0.4744, "Percent") возвращает 47.44%.For example, Format(0.4744, "Percent") returns 47.44%.
P, илиpP, or p Отображает число с разделителем тысяч, умноженное на 100 со знаком процента (%) добавляется вправо и отделяется одним пробелом; всегда отображает две цифры справа от десятичного разделителя.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.

Например, Format(0.80345, "p") возвращает 80.35 %.For example, Format(0.80345, "p") returns 80.35 %.
Scientific Использует стандартное экспоненциальное представление, предоставляя две значащие цифры.Uses standard scientific notation, providing two significant digits.

Например, Format(1234567, "Scientific") возвращает 1.23E+06.For example, Format(1234567, "Scientific") returns 1.23E+06.
E, илиeE, or e Использует стандартное экспоненциальное представление, предоставляя шесть значащих цифр.Uses standard scientific notation, providing six significant digits.

Например, Format(1234567, "e") возвращает 1.234567e+006.For example, Format(1234567, "e") returns 1.234567e+006.
D, илиdD, or d Отображает число в виде строки, содержащей значение числа в десятичном формате (основание 10).Displays number as a string that contains the value of the number in Decimal (base 10) format. Этот параметр поддерживается только для целочисленных типовByte( Short, Integer, Long,).This option is supported for integral types (Byte, Short, Integer, Long) only.

Например, Format(&H7F, "d") возвращает 127.For example, Format(&H7F, "d") returns 127.
X, илиxX, or x Отображает число в виде строки, содержащей значение числа в шестнадцатеричном (основание 16) формате.Displays number as a string that contains the value of the number in Hexadecimal (base 16) format. Этот параметр поддерживается только для целочисленных типовByte( Short, Integer, Long,).This option is supported for integral types (Byte, Short, Integer, Long) only.

Например, Format(127, "x") возвращает 7f.For example, Format(127, "x") returns 7f.
Yes/No Отображает No , если число равно 0; в противном случае отображает Yes.Displays No if number is 0; otherwise, displays Yes.

Например, Format(0, "Yes/No") возвращает No.For example, Format(0, "Yes/No") returns No.
True/False Отображает False , если число равно 0; в противном случае отображает True.Displays False if number is 0; otherwise, displays True.

Например, Format(1, "True/False") возвращает True.For example, Format(1, "True/False") returns True.
On/Off Отображает Off , если число равно 0; в противном случае отображает On.Displays Off if number is 0; otherwise, displays On.

Например, Format(1, "On/Off") возвращает On.For example, Format(1, "On/Off") returns On.

Примечания для разработчиков смарт-устройствSmart Device Developer Notes

Форматы Yes/No, True/False иOn/Off не поддерживаются.The Yes/No, True/False, and On/Off formats are not supported.

Определяемые пользователем числовые форматыUser-Defined Numeric Formats

В следующей таблице приведены символы, которые можно использовать для создания числовых форматов, определяемых пользователем.The following table identifies characters you can use to create user-defined number formats. Они могут использоваться для создания Style аргумента Format функции:These may be used to build the Style argument for the Format function:

ЗнакCharacter ОписаниеDescription
НетNone Отображает число без форматирования.Displays the number with no formatting.
(0)(0) Заполнитель цифры.Digit placeholder. Отображает цифру или нуль.Displays a digit or a 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.

Если число содержит меньше цифр, чем количество нулей (с обеих сторон десятичного разделителя) в выражении формата, отображает начальные или конечные нули.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. Если число содержит больше цифр справа от десятичного разделителя, чем нулей справа от десятичного разделителя в выражении формата, Округляет число до числа десятичных разрядов, равного нулю.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. Если число содержит больше цифр слева от десятичного разделителя, чем нулей слева от десятичного разделителя в выражении формата, отображает лишние цифры без изменения.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.
(#)(#) Заполнитель цифры.Digit placeholder. Отображает цифру или ничего.Displays a digit or nothing. Если выражение содержит цифру в позиции, где # символ отображается в строке формата, отображает его; в противном случае не отображает ничего в этой позиции.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.

Этот символ работает как 0 заполнитель цифры, за исключением того, что ведущие и замыкающие нули не отображаются, если число содержит меньше цифр, чем # символы с любой стороны десятичного разделителя в выражении формата.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.
(.)(.) Десятичный заполнитель.Decimal placeholder. Десятичный заполнитель определяет, сколько цифр отображается слева и справа от десятичного разделителя.The decimal placeholder determines how many digits are displayed to the left and right of the decimal separator. Если выражение формата содержит только # символы слева от этого символа, числа меньше 1 начинаются с десятичного разделителя.If the format expression contains only # characters to the left of this symbol; numbers smaller than 1 begin with a decimal separator. Чтобы отобразить ведущие нули с дробными числами, используйте ноль в качестве первого заполнителя цифры слева от десятичного разделителя.To display a leading zero displayed with fractional numbers, use zero as the first digit placeholder to the left of the decimal separator. В некоторых языковых стандартах в качестве десятичного разделителя используется запятая.In some locales, a comma is used as the decimal separator. Фактический символ, используемый в качестве десятичного заполнителя в форматированном выводе, зависит от числового формата, распознаваемого системой.The actual character used as a decimal placeholder in the formatted output depends on the number format recognized by your system. Таким образом, следует использовать период в качестве десятичного заполнителя в форматах, даже если вы используете языковой стандарт, в котором используется запятая в качестве десятичного заполнителя.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. Отформатированная строка будет отображаться в формате, правильно соответствующем языковому стандарту.The formatted string will appear in the format correct for the locale.
(%)(%) Заполнитель процентов.Percent placeholder. Умножает выражение на 100.Multiplies the expression by 100. Символ процента (%) вставляется в позицию, где она отображается в строке формата.The percent character (%) is inserted in the position where it appears in the format string.
(,)(,) Разделитель групп разрядов.Thousand separator. Разделитель тысяч разделяет тысячи от сотен в числе с четырьмя или более разрядами слева от десятичного разделителя.The thousand separator separates thousands from hundreds within a number that has four or more places to the left of the decimal separator. Стандартное использование разделителя тысяч указывается, если формат содержит десятичный разделитель, окруженный заполнителями цифр (0 или #).Standard use of the thousand separator is specified if the format contains a thousand separator surrounded by digit placeholders (0 or #).

Разделитель тысяч, расположенный непосредственно слева от десятичного разделителя (указывается, задан ли десятичный знак) или как правый символ в строке означает "масштабировать число, разделив его на 1 000, округляя по мере необходимости".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." Числа меньше 1 000, но больше или равно 500 отображаются в виде 1, а числа меньше 500 отображаются как. 0Numbers smaller than 1,000 but greater or equal to 500 are displayed as 1, and numbers smaller than 500 are displayed as 0. Два смежных разделителя тысяч в этой ячейке масштабируются с коэффициентом 1 000 000 и дополнительным фактором 1 000 для каждого дополнительного разделителя.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.

Несколько разделителей в любой точке, отличной от непосредственно слева от десятичного разделителя или крайней правой точки в строке, обрабатываются просто, как указано использование разделителя тысяч.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 some locales, a period is used as a thousand separator. Фактический символ, используемый в качестве разделителя тысяч в форматированном выводе, зависит от числового формата, распознаваемого системой.The actual character used as the thousand separator in the formatted output depends on the Number Format recognized by your system. Таким образом, следует использовать запятую в качестве разделителя тысяч в форматах, даже если используется языковой стандарт, в котором точка является разделителем тысяч.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. Отформатированная строка будет отображаться в формате, правильно соответствующем языковому стандарту.The formatted string will appear in the format correct for the locale.

Например, рассмотрим три следующие строки формата:For example, consider the three following format strings:

- "#,0.", который использует разделитель тысяч для форматирования числа 100 000 000 в виде строки "100 000 000".- "#,0.", which uses the thousands separator to format the number 100 million as the string "100,000,000".
- "#0,.", который использует масштабирование с коэффициентом 1000, чтобы отформатировать число 100 000 000 как строку "100000".- "#0,.", which uses scaling by a factor of one thousand to format the number 100 million as the string "100000".
- "#,0,.", в котором для форматирования числа 100 000 000 в виде строки "100 000" используется разделитель групп разрядов и масштабирование на 1000.- "#,0,.", which uses the thousands separator and scaling by one thousand to format the number 100 million as the string "100,000".
(:)(:) Разделитель времени.Time separator. В некоторых языковых стандартах для представления разделителя времени могут использоваться другие символы.In some locales, other characters may be used to represent the time separator. Разделитель времени разделяет часы, минуты и секунды при форматировании значений времени.The time separator separates hours, minutes, and seconds when time values are formatted. Фактический символ, используемый в качестве разделителя времени в отформатированном выводе, определяется параметрами системы.The actual character used as the time separator in formatted output is determined by your system settings.
(/)(/) Разделитель компонентов даты.Date separator. В некоторых языковых стандартах для представления разделителя дат могут использоваться другие символы.In some locales, other characters may be used to represent the date separator. Разделитель дат разделяет день, месяц и год при форматировании значений даты.The date separator separates the day, month, and year when date values are formatted. Фактический символ, используемый в качестве разделителя дат в форматированных выходных данных, определяется параметрами системы.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+) Экспоненциальный формат.Scientific format. Если выражение формата содержит по крайней мере одну цифру0 - #заполнитель (или) E-слева E+от e-,, e+или, число отображается в экспоненциальном формате и E или e вставляется между числом и его экспонентой.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. Число заполнителей для цифр слева определяет количество цифр в экспоненте.The number of digit placeholders to the left determines the number of digits in the exponent. Используйте E- илиe- для размещения знака минус рядом с отрицательной экспонентой.Use E- or e- to place a minus sign next to negative exponents. Используйте E+ илиe+ , чтобы поместить знак "минус" рядом с отрицательной экспонентой и знак плюса рядом с положительной экспонентой.Use E+ or e+ to place a minus sign next to negative exponents and a plus sign next to positive exponents. Чтобы получить правильное форматирование, необходимо также включить заполнители цифр справа от этого символа.You must also include digit placeholders to the right of this symbol to get correct formatting.
- + $ ( )- + $ ( ) Литеральные символы.Literal characters. Эти символы отображаются в точности так, как они введены в строке формата.These characters are displayed exactly as typed in the format string. Для вывода символа, отличного от одного из перечисленных выше, перед ним следует указать обратную\косую черту () или заключить его в двойные кавычки ("").To display a character other than one of those listed, precede it with a backslash (\) or enclose it in double quotation marks (" ").
(\) Отображает следующий символ в строке формата.(\)
("``ABC``")("``ABC``") Отображает строку в двойных кавычках ("").Displays the string inside the double quotation marks (" "). Чтобы включить строку в аргумент Style из кода, необходимо использовать Chr(34) для заключения текста (34 это код символа для кавычек (")).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 (")).

Старый пример кодаLegacy Code Example

В следующей таблице приведены некоторые примеры выражений форматирования для чисел.The following table contains some sample format expressions for numbers. (В этих примерах предполагается, что параметр языкового стандарта системы — Английский-U. S.) Первый столбец содержит строки формата для Style аргумента Format функции. остальные столбцы содержат итоговый результат, если форматированные данные имеют значение, заданное в заголовках столбцов.(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.

Format (Style)Format (Style) "5" в формате"5" formatted as "-5" в формате"-5" formatted as "0,5" в формате"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

Стандартные форматы даты и времениPredefined Date/Time Formats

В следующей таблице приведены стандартные имена форматов даты и времени.The following table identifies the predefined date and time format names. Они могут использоваться именем в качестве аргумента Style для Format функции:These may be used by name as the style argument for the Format function:

Название форматаFormat Name ОписаниеDescription
General Date, илиGGeneral Date, or G Отображает дату и/или время.Displays a date and/or time. Например, 3/12/2008 11:07:31 AM.For example, 3/12/2008 11:07:31 AM. Отображение даты определяется текущим значением языка и региональных параметров приложения.Date display is determined by your application's current culture value.
Long Date, Medium Dateили DLong Date, Medium Date, or D Отображает дату в соответствии с длинным форматом даты текущего языка и региональных параметров.Displays a date according to your current culture's long date format. Например, Wednesday, March 12, 2008.For example, Wednesday, March 12, 2008.
Short Date, илиdShort Date, or d Отображает дату, используя краткий формат даты текущего языка и региональных параметров.Displays a date using your current culture's short date format. Например, 3/12/2008.For example, 3/12/2008.

d Символ отображает день в определяемом пользователем формате даты.The d character displays the day in a user-defined date format.
Long Time, Medium Timeили TLong Time, Medium Time, or T Отображает время с использованием длинного формата времени текущего языка и региональных параметров; обычно включает часы, минуты, секунды.Displays a time using your current culture's long time format; typically includes hours, minutes, seconds. Например, 11:07:31 AM.For example, 11:07:31 AM.
Short Time или tShort Time or t Отображает время с использованием краткого формата времени текущего языка и региональных параметров.Displays a time using your current culture's short time format. Например, 11:07 AM.For example, 11:07 AM.

Символ отображает AM илиPM значения для языковых стандартов, которые используют 12-часовой формат времени в определенном пользователем формате. tThe t character displays AM or PM values for locales that use a 12-hour clock in a user-defined time format.
f Отображает длинные и короткие сроки в соответствии с форматом текущего языка и региональных параметров.Displays the long date and short time according to your current culture's format. Например, Wednesday, March 12, 2008 11:07 AM.For example, Wednesday, March 12, 2008 11:07 AM.
F Отображает длинные и длинные даты в соответствии с форматом текущего языка и региональных параметров.Displays the long date and long time according to your current culture's format. Например, Wednesday, March 12, 2008 11:07:31 AM.For example, Wednesday, March 12, 2008 11:07:31 AM.
g Отображение краткой даты и краткого времени в соответствии с форматом текущего языка и региональных параметров.Displays the short date and short time according to your current culture's format. Например, 3/12/2008 11:07 AM.For example, 3/12/2008 11:07 AM.
M, mM, m Отображает месяц и день даты.Displays the month and the day of a date. Например, March 12.For example, March 12.

M Символ отображает месяц в определяемом пользователем формате даты.The M character displays the month in a user-defined date format. m Символ отображает минуты в определенном пользователем формате времени.The m character displays the minutes in a user-defined time format.
R, rR, r Форматирует дату в соответствии RFC1123Pattern со свойством.Formats the date according to the RFC1123Pattern property. Например, Wed, 12 Mar 2008 11:07:31 GMT.For example, Wed, 12 Mar 2008 11:07:31 GMT. Отформатированная Дата не корректирует значение даты и времени.The formatted date does not adjust the value of the date and time. Необходимо изменить значение даты и времени на GMT перед вызовом Format функции.You must adjust the Date/Time value to GMT before calling the Format function.
s Форматирует дату и время в виде индекса, допускающего сортировку.Formats the date and time as a sortable index. Например, 2008-03-12T11:07:31.For example, 2008-03-12T11:07:31.

s Символ отображает секунды в определенном пользователем формате времени.The s character displays the seconds in a user-defined time format.
u Форматирует дату и время в виде индекса, допускающего сортировку по ГРИНВИЧу.Formats the date and time as a GMT sortable index. Например, 2008-03-12 11:07:31Z.For example, 2008-03-12 11:07:31Z.
U Форматирует дату и время с длинными и длинными датами по ГРИНВИЧу.Formats the date and time with the long date and long time as GMT. Например, Wednesday, March 12, 2008 6:07:31 PM.For example, Wednesday, March 12, 2008 6:07:31 PM.
Y, yY, y Форматирует дату как год и месяц.Formats the date as the year and month. Например, March, 2008.For example, March, 2008.

Символы Y иy отображают год в определяемом пользователем формате даты.The Y and y characters display the year in a user-defined date format.

Дополнительные сведения о текущем языке и региональных параметрах приложения см. в разделе влияние языка и региональных параметров на строки в Visual Basic.For more information about the application's current culture information, see How Culture Affects Strings in Visual Basic.

Пользовательские форматы даты и времениUser-Defined Date/Time Formats

В следующей таблице показаны символы, которые можно использовать для создания пользовательских форматов даты и времени.The following table shows characters you can use to create user-defined date/time formats. В отличие от более ранних версий Visual Basic, в этих символах формата учитывается регистр.Unlike in earlier versions of Visual Basic, these format characters are case-sensitive.

ЗнакCharacter ОписаниеDescription
(:)(:) Разделитель времени.Time separator. В некоторых языковых стандартах для представления разделителя времени могут использоваться другие символы.In some locales, other characters may be used to represent the time separator. Разделитель времени разделяет часы, минуты и секунды при форматировании значений времени.The time separator separates hours, minutes, and seconds when time values are formatted. Фактический символ, используемый в качестве разделителя времени в форматированных выходных данных, определяется текущим значением языка и региональных параметров приложения.The actual character that is used as the time separator in formatted output is determined by your application's current culture value.
(/)(/) Разделитель компонентов даты.Date separator. В некоторых языковых стандартах для представления разделителя дат могут использоваться другие символы.In some locales, other characters may be used to represent the date separator. Разделитель дат разделяет день, месяц и год при форматировании значений даты.The date separator separates the day, month, and year when date values are formatted. Фактический символ, используемый в качестве разделителя даты в форматированном выводе, определяется текущим языком и региональными параметрами приложения.The actual character that is used as the date separator in formatted output is determined by your application's current culture.
(%)(%) Используется для обозначения того, что следующий символ должен считаться однобуквенным форматом без учета конечных букв.Used to indicate that the following character should be read as a single-letter format without regard to any trailing letters. Также используется для указания того, что однобуквенный формат читается как пользовательский формат.Also used to indicate that a single-letter format is read as a user-defined format. Дополнительные сведения см. в следующем разделе.See what follows for additional details.
d Выводит день в виде числа без нуля в начале (например, 1).Displays the day as a number without a leading zero (for example, 1). Используйте %d , если это единственный символ в определяемом пользователем числовом формате.Use %d if this is the only character in your user-defined numeric format.
dd Выводит день в виде числа с нулем в начале (например, 01).Displays the day as a number with a leading zero (for example, 01).
ddd Выводит день в виде аббревиатуры (например, Sun).Displays the day as an abbreviation (for example, Sun).
dddd Отображает день в виде полного имени (например, Sunday).Displays the day as a full name (for example, Sunday).
M Выводит месяц в виде числа без нуля в начале (например, Январь представлен как 1).Displays the month as a number without a leading zero (for example, January is represented as 1). Используйте %M , если это единственный символ в определяемом пользователем числовом формате.Use %M if this is the only character in your user-defined numeric format.
MM Выводит месяц в виде числа с нулем в начале (например, 01/12/01).Displays the month as a number with a leading zero (for example, 01/12/01).
MMM Выводит месяц в виде аббревиатуры (например, Jan).Displays the month as an abbreviation (for example, Jan).
MMMM Отображает месяц в виде полного названия месяца (например, January).Displays the month as a full month name (for example, January).
gg Отображает строку периода или эры (например, A.D.).Displays the period/era string (for example, A.D.).
h Отображает часы в виде числа без начальных нулей, используя 12-часовой формат (например, 1:15:15 PM).Displays the hour as a number without leading zeros using the 12-hour clock (for example, 1:15:15 PM). Используйте %h , если это единственный символ в определяемом пользователем числовом формате.Use %h if this is the only character in your user-defined numeric format.
hh Отображает час в виде числа с начальными нулями в 12-часовом формате (например, 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 Отображает час в виде числа без начальных нулей, используя 24-часовой формат времени (например, 1:15:15).Displays the hour as a number without leading zeros using the 24-hour clock (for example, 1:15:15). Используйте %H , если это единственный символ в определяемом пользователем числовом формате.Use %H if this is the only character in your user-defined numeric format.
HH Отображает часы в виде числа с начальными нулями, используя 24-часовой формат (например, 01:15:15).Displays the hour as a number with leading zeros using the 24-hour clock (for example, 01:15:15).
m Отображает минуты в виде числа без ведущих нулей (например, 12:1:15).Displays the minute as a number without leading zeros (for example, 12:1:15). Используйте %m , если это единственный символ в определяемом пользователем числовом формате.Use %m if this is the only character in your user-defined numeric format.
mm Отображает минуты в виде числа с нулями в начале (например, 12:01:15).Displays the minute as a number with leading zeros (for example, 12:01:15).
s Отображает секунды в виде числа без ведущих нулей (например, 12:15:5).Displays the second as a number without leading zeros (for example, 12:15:5). Используйте %s , если это единственный символ в определяемом пользователем числовом формате.Use %s if this is the only character in your user-defined numeric format.
ss Отображает секунды в виде числа с нулями в начале (например, 12:15:05).Displays the second as a number with leading zeros (for example, 12:15:05).
f Отображает доли секунды.Displays fractions of seconds. Например ff , выводит сотые доли секунды, ffff тогда как отображает в секундах десять тысяч.For example ff displays hundredths of seconds, whereas ffff displays ten-thousandths of seconds. В пользовательском формате можно использовать до f семи символов.You may use up to seven f symbols in your user-defined format. Используйте %f , если это единственный символ в определяемом пользователем числовом формате.Use %f if this is the only character in your user-defined numeric format.
t Использует 12-часовой формат времени и отображает прописные буквы A для любого часа до полудня; в P верхнем регистре для любого часа в диапазоне от полудня до 11:59 вечера.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. Используйте %t , если это единственный символ в определяемом пользователем числовом формате.Use %t if this is the only character in your user-defined numeric format.
tt Для языковых стандартов, использующих 12-часовое время, отображает AM прописные буквы с любыми часами, предшествующие PM полудню и 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.

Для национальных настроек, в которых используется 24-часовой формат времени, не отображает ничего.For locales that use a 24-hour clock, displays nothing.
y Отображает номер года (0-9) без начальных нулей.Displays the year number (0-9) without leading zeros. Используйте %y , если это единственный символ в определяемом пользователем числовом формате.Use %y if this is the only character in your user-defined numeric format.
yy Отображает год в числовом формате из двух цифр с нулем в начале, если применимо.Displays the year in two-digit numeric format with a leading zero, if applicable.
yyy Отображает год в числовом формате из четырех цифр.Displays the year in four-digit numeric format.
yyyy Отображает год в числовом формате из четырех цифр.Displays the year in four-digit numeric format.
z Отображает смещение часового пояса без нуля в начале (например, -8).Displays the timezone offset without a leading zero (for example, -8). Используйте %z , если это единственный символ в определяемом пользователем числовом формате.Use %z if this is the only character in your user-defined numeric format.
zz Отображает смещение часового пояса с нулем в начале (например, -08).Displays the timezone offset with a leading zero (for example, -08)
zzz Отображает полное смещение часового пояса (например, -08:00).Displays the full timezone offset (for example, -08:00)

Старый пример кодаLegacy Code Example

Ниже приведены примеры определяемых пользователем форматов даты и времени для 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:

ФорматFormat ОтображениеDisplays
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

Примечания для разработчиков смарт-устройствSmart Device Developer Notes

Минимальное разрешение времени для устройства определяется производителем устройства.The minimum time resolution for a device is determined by the manufacturer of the device. Если разрешающее время для устройства достаточно велика, f символ форматирования возвращает 0 при запуске на этом устройстве.If the time resolution for the device is coarse enough, the f format character returns 0 when run on that device.

Применяется к

Дополнительно