Strings.Format(Object, String) Метод

public static string Format (object? Expression, string? Style = "");

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

Параметры

Возвращаемое значение

Строка отформатирована в соответствии с инструкциями, содержащимися в выражении String формата.

Примеры

В этом примере показано использование функции Format для форматирования значений с помощью форматов String и определяемых пользователем форматов. Для разделителя дат (/), разделителя времени (:) и индикаторов AM/PM (t и tt), фактические отформатированные выходные данные, отображаемые системой, зависят от параметров языкового стандарта, которые использует код. Если время и даты отображаются в среде разработки, используется короткий формат времени и короткий формат даты языкового стандарта кода.

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

Если вы форматируете нелокализованную числовую строку, следует использовать определяемый пользователем числовый формат, чтобы обеспечить нужный вид.

Если вы пытаетесь отформатировать число без указания Style, функция Format предоставляет функциональность, аналогичную функции Str, хотя она имеет международное представление. Однако положительные числа, отформатированные как строки с помощью функции Format, не включают в себя начальное пространство, зарезервированное для знака значения; преобразованные с помощью функции Str сохраняют ведущее пространство.

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

Определяемое пользователем выражение формата для чисел может иметь от одного до трех разделов, разделенных точкой с запятой. Если аргумент Style функции Format содержит один из предопределенных числовых форматов, допускается только один раздел.

В следующем примере есть два раздела: первый определяет формат положительных значений и нули; Второй раздел определяет формат отрицательных значений. Так как аргумент Style функции Format принимает строку, она заключена кавычками.

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

Если между ними нет запятой, отсутствующий раздел печатается с использованием формата положительного значения. Например, следующий формат отображает положительные и отрицательные значения с помощью формата в первом разделе и отображает Zero, если значение равно нулю.

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

Стандартные числовые форматы

В следующей таблице указаны предопределенные числовые имена форматов. Они могут использоваться в качестве аргумента Style для функции Format:

Заметки разработчика смарт-устройств

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

числовые форматы User-Defined

В следующей таблице указаны символы, которые можно использовать для создания пользовательских форматов чисел. Их можно использовать для сборки аргумента Style для функции Format:

Пример устаревшего кода

В следующей таблице содержатся некоторые примеры выражений формата для чисел. (В этих примерах предполагается, что параметр языкового стандарта вашей системы — английский-США) Первый столбец содержит строки форматирования для аргумента Style функции Format; Другие столбцы содержат результирующий результат, если отформатированные данные имеют значение, заданное в заголовках столбцов.

Стандартные форматы даты и времени

В следующей таблице указаны предопределенные имена форматов даты и времени. Они могут использоваться в качестве аргумента стиля для функции Format:

Дополнительные сведения о текущем языке и региональных параметрах приложения см. в разделе Влияние строк языка и региональных параметров в Visual Basic.

форматы даты и времени User-Defined

В следующей таблице показаны символы, которые можно использовать для создания пользовательских форматов даты и времени. В отличие от более ранних версий Visual Basic, эти символы формата чувствительны к регистру.

Пример устаревшего кода

Ниже приведены примеры определяемых пользователем форматов даты и времени для December 7, 1958, 8:50 PM, 35 seconds:

Заметки разработчика смарт-устройств

Минимальное разрешение времени для устройства определяется производителем устройства. Если разрешение времени для устройства достаточно грубо, символ формата f возвращает значение 0 при запуске на этом устройстве.

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

См. также раздел

• Format(String, Object)
• Str(Object)
• Сводка