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"

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

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

Заметки для разработчиков интеллектуальных устройств

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

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

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

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

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

Предопределенные форматы даты и времени

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

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

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

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

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

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

Заметки для разработчиков интеллектуальных устройств

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

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

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

• Format(String, Object)
• Str(Object)
• Сводка по работе со строками