Função Format

Artigo
08/25/2010

Retorna uma seqüência de caracteres formatada de acordo com as instruções contidas em um formato String expressão.

Public Shared Function Format( _
   ByVal Expression As Object, _
   Optional ByVal Style As String = "" _
) As String

Parâmetros

Expression
Obrigatório.Any valid expression.
Style
Opcional.Um formato válido nomeada ou definida pelo usuário String expressão.

Configurações

Para obter informações sobre como criar o Style argumento, consulte o tópico apropriado abaixo:

Para formatar	Faça isso
Números	Use formatos numéricos predefinidos ou criarformatos numéricos definidos pelo usuário.
Datas e horas	Use formatos de data/time predefinidos ou criarformatos de data/time definidos pelo usuário.
Números de série de data e time	Use formatos de data e time ou formatos numéricos.

Se você tentar formatar um número sem especificar Style, o Format função fornece funcionalidade semelhante do Str funcione, apesar de ser internacionalizada. No entanto, números positivos formatados sistema autônomo seqüências de caracteres usando o Format função não incluem um espaço entrelinhamento reservado para o sinal do valor; sistema autônomo convertidos usando o Str função mantêm o espaço entrelinhamento.

Comentários

Se você estiver formatando uma seqüência numérica nonlocalized, você deve usar um formato numérico definido pelo usuário para garantir que você obtenha a aparência desejada.

The String.Format método também fornece funcionalidade semelhante.

Exemplo

Este exemplo mostra vários usos do Format função para formatar valores usando os dois String os formatos e formatos definidos pelo usuário. Para o separador de data (/), (separador de time:) e o (indicadores de AM/PMt e tt), a saída formatada real exibida pelo seu sistema depende das configurações de localidade o código está usando. Quando vezes e as datas sejam exibidas no ambiente de desenvolvimento, o formato curto período de time e o formato de data abreviada da localidade do código são usados.

Observação:
Para localidades que usam um relógio de 24 horas, o (indicadores de AM/PM t e tt) não exibir nada.

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