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

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

Разделитель групп разрядов слева от десятичного разделителя (ли задано десятичное число) или крайним правым символ в строке, это означает «масштабирование числа путем деления 1000, округления при необходимости.»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." Числа меньше 1000, но меньше 500 отображаются как 1, а числа меньше 500 представляются в милливаттах 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. Два смежных разделителя групп разрядов в этой позиции масштабировать с помощью коэффициентом 1 миллион и дополнительный фактор 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 миллионов как строки «100,000,000».- "#,0.", which uses the thousands separator to format the number 100 million as the string "100,000,000".
- "#0,.", которая использует деление на тысячу для форматирования числа 100 миллионов строки «100000».- "#0,.", which uses scaling by a factor of one thousand to format the number 100 million as the string "100000".
- "#,0,.", который использует разделитель тысяч и деление на тысячу для форматирования числа 100 миллионов как строки «100,000».- "#,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 (" ").
(\)(\) Отображает следующий символ в строке формата.Displays the next character in the format string. Чтобы вывести символ, который имеет особое значение как буквенный символ, укажите перед ним обратную косую черту (\).To display a character that has special meaning as a literal character, precede it with a backslash (\). Сама обратная косая черта не отображается.The backslash itself isn't displayed. Обратная косая черта используется аналогично заключению выводимого символа в двойные кавычки.Using a backslash is the same as enclosing the next character in double quotation marks. Чтобы отобразить обратную косую черту, укажите две черты подряд (\\).To display a backslash, use two backslashes (\\).

Примеры символов, которые не может отображаться как литеральные символы и символы форматирования дат и времени, форматирование (a, c, d, h, m, n, p, q, s, t, w, y, /, и :), символы форматирования чисел (#, 0, %, E, e, точки и запятой), а также символы форматирования строк (@, &, <, >, и !).Examples of characters that can't be displayed as literal characters are the date-formatting and time-formatting characters (a, c, d, h, m, n, p, q, s, t, w, y, /, and :), the numeric-formatting characters (#, 0, %, E, e, comma, and period), and the string-formatting characters (@, &, <, >, and !).
("``ABC``")("``ABC``") Отображает строку, заключенную в двойные кавычки (» «).Displays the string inside the double quotation marks (" "). Чтобы включить строку в аргумент стиля из кода, необходимо использовать 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. (Предполагается, что параметр языкового стандарта системы является английский (США)) Первый столбец содержит строки форматирования для 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.

Формат (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. Их можно использовать по имени в качестве аргумента стиля для 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.

t Символов отображает AM или PM значения для языков, использующих 12-часовом формате в виде определяемых пользователем время.The 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. Перед вызовом необходимо скорректировать значение даты и времени по Гринвичу 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 Форматирует дату и время в виде сортируемого индекса GMT.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 Форматирует дату и время с помощью полный формат даты и время в формате GMT.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 для времени от полудня до 23: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 времени от полудня до 23: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.

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

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