Função Format

Observação: Desejamos fornecer o conteúdo da Ajuda mais recente no seu idioma da forma mais rápida possível. Esta página foi traduzida de forma automatizada e pode conter imprecisões ou erros gramaticais. Nosso objetivo é que este conteúdo seja útil para você. As informações foram úteis? Dê sua opinião no final desta página. Aqui está o artigo em inglês para facilitar a referência.

Retorna uma variante (cadeia) que contém um expressão formatada de acordo com as instruções contidas em uma expressão de formato.

Veja alguns exemplos

Sintaxe

Formato ( expressão [formato ] [, primeirodiadasemana ] [, primeirasemanadoano ] )

A sintaxe da função formato possui os seguintes argumentos:

Argumento

Descrição

expressão

Necessário. Qualquer expressão válida.

formato

Opcional. Uma expressão de formato nomeada ou definida pelo usuário válida.

primeirodiadasemana

Opcional. Um constante que especifica o primeiro dia da semana.

primeirasemanadoano

Opcional. Uma constante que especifica a primeira semana do ano.


Configurações

O formatoargumento pode usar uma variedade de configurações, dependendo do tipo de dados do argumento de expressão . Consulte os artigos listados na tabela a seguir para obter mais informações sobre expressões de formato válido.

Para expressões que use esse tipo de dados...

Consulte o artigo

Qualquer tipo

Propriedade Format

Data/hora

Propriedade Format - tipo de dados Data/Hora

Numérico

Propriedade Format - tipos de dados Número e Moeda

Texto e Memorando

Propriedade Format - tipo de dados Texto e Memorando

Sim/Não

Propriedade Format - tipo de dado Yes/No


O argumento primeirodiadasemana possui estas configurações:

Constante

Valor

Descrição

vbUseSystem

0

Use a configuração de API NLS.

VbSunday

1

Domingo (padrão)

vbMonday

2

Segunda-feira

vbTuesday

3

Terça-feira

vbWednesday

4

Quarta-feira

vbThursday

5

Quinta-feira

vbFriday

6

Sexta-feira

vbSaturday

7

Sábado


O argumento primeirasemanadoano possui estas configurações:

Constante

Valor

Descrição

vbUseSystem

0

Use a configuração de API NLS.

vbFirstJan1

1

Comece com a semana na qual 1º de janeiro ocorre (padrão).

vbFirstFourDays

2

Comece com a primeira semana que tenha pelo menos quatro dias no ano.

vbFirstFullWeek

3

Comece com a primeira semana completa do ano.


Comentários

Para formatar

Faça isto

Números

Use formatos numéricos nomeados predefinidos ou crie formatos numéricos definidos pelo usuário.

Datas e horas

Use formatos de data/hora nomeados predefinidos ou crie formatos de data/hora definidos pelo usuário.

Números de série de data e hora

Use formatos de data e hora ou formatos numéricos.

Cadeias de caracteres

Crie seus próprios formatos de cadeia de caracteres definidos pelo usuário.


Se você tentar formatar um número sem especificar o formato, o formato fornece funcionalidade semelhante à função Str , embora seja conhecimento internacional. No entanto, números positivos formatados como cadeias de caracteres usando o formato não incluem um espaço à esquerda reservado para o sinal do valor; os convertidos usando Str mantêm o espaço à esquerda.

Se você estiver formatando uma sequência numérica não-localizada, você deve usar um formato numérico definidas pelo usuário para garantir que você obtenha a aparência desejada.

Observação: Se a configuração de propriedade de calendário for Gregoriano e formato Especifica a formatação de data, fornecida expressão deve ser gregoriano. Se a configuração da propriedade do Visual Basic calendário for Islâmico, fornecida expressão deve ser islâmico.

Se o calendário for Gregoriano, o significado dos símbolos de expressão de formato é inalterado. Se o calendário for Islâmico, todos os símbolos de formato de data (por exemplo, dddd, mmmm, AAAA) têm o mesmo significado, mas se aplicam ao calendário islâmico. Símbolos de formato permanecem em inglês; símbolos que resultam na exibição de texto (por exemplo, AM e PM) exibem a cadeia de caracteres (inglês ou árabe) associada ao símbolo. O intervalo de alguns símbolos é alterado quando o calendário é Islâmico.

Símbolo

Intervalo

d

1-30

dd

1-30

ss

1-51

mmm

Exibe nomes de meses completos (os nomes de meses Islâmico não possuem abreviação).

y

1-355

aaaa

100-9666

Exemplos

Use a função Format em uma expressão    Você pode usar o formato sempre que você pode usar expressões. Por exemplo, você pode usá-lo em uma consulta como parte de um alias de campo ou na propriedade Fonte do controle de uma caixa de texto em um formulário ou relatório. Os exemplos a seguir mostra uma expressão, você pode usar na propriedade de filtro de um relatório para limitar a saída aos registros desde a semana anterior.

Formato ([Data], "ss") = formato (agora (), "ss") -1

Neste exemplo, a fonte de registro do relatório tem um campo chamado data, que contém a data em que cada registro em particular foi modificado, e que é usado no relatório. Quando você executa o relatório, seus resultados são filtrados para mostrar somente aqueles registros onde a semana para o valor no campo de data (Format([Date],"ww")) é igual a semana anterior (Format(Now(),"ww")-1).

Use a função Format no código VBA   

Observação: Exemplos a seguir demonstram o uso dessa função em um Visual Basic para módulo Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione a Referência do desenvolvedor na lista suspensa ao lado de pesquisa e insira um ou mais termos na caixa de pesquisa.

Este exemplo mostra vários usos da função Format para formatar valores usando formatos denominados e formatos definidos pelo usuário. Para o separador de data (/), tempo separador (:) e estou / literal PM, a saída formatada real exibida pelo seu sistema depende das configurações de localidade do computador no qual o código está em execução. Quando horas e as datas são exibidas no ambiente de desenvolvimento, o formato de hora abreviada e data abreviada da localidade do código são usadas. Quando exibido executando código, o formato de hora abreviada e data abreviada da localidade do sistema são usados, que podem diferir do local do código. Neste exemplo, a localidade do inglês dos EUA será considerada.

MyTime e MyDate são exibidos no ambiente de desenvolvimento usando a configuração de hora abreviada atual do sistema e configuração de data abreviada.

Dim MyTime, MyDate, MyStr
MyTime = #17:04:23#
MyDate = #January 27, 1993#
' Returns current system time in the system-defined long time format.
MyStr = Format(Time, "Long Time")
' Returns current system date in the system-defined long date format.
MyStr = Format(Date, "Long Date")
MyStr = Format(MyTime, "h:m:s") ' Returns "17:4:23".
MyStr = Format(MyTime, "hh:mm:ss AMPM") ' Returns "05:04:23 PM".
MyStr = Format(MyDate, "dddd, mmm d yyyy") ' Returns "Wednesday,
' Jan 27 1993".
' If format is not supplied, a string is returned.
MyStr = Format(23) ' Returns "23".
' User-defined formats.
MyStr = Format(5459.4, "##,##0.00") ' Returns "5,459.40".
MyStr = Format(334.9, "###0.00") ' Returns "334.90".
MyStr = Format(5, "0.00%") ' Returns "500.00%".
MyStr = Format("HELLO", "<") ' Returns "hello".
MyStr = Format("This is it", ">") ' Returns "THIS IS IT".


Usando o formato com cadeias de caracteres de comprimento zero

No Microsoft Access version 2.0 e versões anteriores, você pode usar a função Format para retornar um valor para um cadeia de comprimento zero e outro para um valor. Por exemplo, você pode usar uma expressão de formato como a seguir com a função Format para retornar o valor de cadeia de caracteres apropriada do código:

Dim varX As Variant
Dim varStrX As Variant
' Assign some value to varStrX and pass to Format function.
varX = Format(varStrX, "@;ZLS;Null")

Em versões do Microsoft Access 97 e posteriores, você deve testar separadamente para o caso Nulo e retornar o valor adequado com base no resultado. Por exemplo, você pode usar a função IIf em uma expressão com a função Format como estas:

varX = IIf(IsNull(varStrX),"Null", Format(varStrX, "@;ZLS"))

Essa alteração é aplicada somente quando você usar a função Format para formatar uma sequência dependente se ela for uma cadeia de caracteres de comprimento zero ou um valor nulo. Outras expressões de formato usadas com a função Format continuam a trabalhar como faziam em versões anteriores.

Se você converter um banco de dados do Microsoft Access version 2.0 e versões anteriores ao Microsoft Access 2002 ou posterior, você deve alterar o código para testar separadamente para o caso de nulo.

Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×