Função Format

Retorna uma Variant (Cadeiade Caracteres ) que contém um expressão formatado de acordo com as instruções contidas em uma expressão de formato.

Aviso    Há um problema com o uso dessa função. A última segunda-feira em alguns anos de calendário pode ser retornada como a semana 53 quando deve ser a semana 1. Para obter mais informações e uma solução alternativa, consulte Format or DatePart functions canreturn wrong week number for last Monday in Year .

Veja alguns exemplos

Sintaxe

Format( expression [, format ] [, firstdayofweek ] [, firstweekofyear ] )

A sintaxe da função Format tem estes argumentos:

Argumento

Descrição

expressão

Obrigatório. Qualquer expressão válida.

formato

Opcional. Uma expressão de formato nomeado ou definido pelo usuário válido.

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 argumento format pode usar uma variedade de configurações, dependendo do tipo de dados do argumento expression. Consulte os artigos listados na tabela a seguir para obter mais informações sobre expressões de formato válido.

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

Consulte o artigo

Qualquer tipo

Propriedade Format

Data/hora

Formatar um campo de data e hora

Numérico

Formatar um número ou campo de moeda

Texto e memorando

Formatar um campo de texto

Sim/Não

Propriedade Format - tipo de dados sim/não


O argumento firstdayofweek tem estas configurações:

Constante

Valor

Descrição

vbUseSystem

0

Use a configuração da 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 firstweekofyear tem estas configurações:

Constante

Valor

Descrição

vbUseSystem

0

Use a configuração da API NLS.

vbFirstJan1

1

Comece com a semana em que 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 oformato, Format fornece funcionalidade semelhante à função Str, embora seja internacionalmente ciente. No entanto, números positivos formatados como cadeias de caracteres usando Format não incluem um espaço à frente reservado para o sinal do valor; aqueles convertidos usando Str retêm o espaço à frente.

Se você estiver formatando uma cadeia de caracteres numérica não localizada, use um formato numérico definido pelo usuário para garantir que você receba a aparência que deseja.

Observação: Se a configuração da propriedade Calendar for gregoriana e o formato especificar a formatação de data, a expressão fornecida deverá ser gregoriana. Se a Visual Basic da propriedade Calendar for Hijri, a expressão fornecida deverá ser Hijri.

Se o calendário for gregoriano, o significado dos símbolos de expressão de formato não será alterado. Se o calendário for Hijri, todos os símbolos de formato de data (por exemplo, dddd, mmmm, yyyy) têm o mesmo significado, mas se aplicam ao calendário Hijri. Símbolos de formato permanecem em inglês; símbolos que resultam em exibição de texto (por exemplo, AM e PM) exibem a cadeia de caracteres (inglês ou árabe) associada a esse símbolo. O intervalo de determinados símbolos muda quando o calendário é Hijri.

Símbolo

Intervalo

d

1-30

dd

1-30

ss

1-51

mmm

Exibe nomes de mês completos (nomes de mês Hijri não têm abreviações).

y

1-355

aaaa

100-9666

Exemplos

Usar a função Format em uma expressão    Você pode usar Format onde quer que possa usar expressões. Por exemplo, você pode usá-lo em uma consulta como parte de um alias de campo ou na propriedade Fonte de Controle de uma caixa de texto em um formulário ou relatório. Os exemplos a seguir mostram uma expressão que você pode usar na propriedade Filter de um relatório para limitar a saída aos registros da semana anterior.

Format([Date],"ww")=Format(Now(),"ww")-1

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

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

Observação: Exemplos a seguir demonstram o uso dessa função em um módulo Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Desenvolvedor na listada ao lado de Pesquisar 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 nomeados e formatos definidos pelo usuário. Para o separador de datas (/), separador de hora (:), e literal AM/PM, a saída formatada real exibida pelo seu sistema depende das configurações de localidade do computador no qual o código está sendo executado. Quando as horas e as datas são exibidas no ambiente de desenvolvimento, o formato de tempo curto e o formato de data curta da localidade do código são usados. Quando exibido por código em execução, o formato de tempo curto e o formato de data curta da localidade do sistema são usados, o que pode diferir da localidade do código. Para este exemplo, a localidade em inglês dos EUA é assumida.

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

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 Format com cadeias de caracteres de comprimento zero

No Microsoft Access versão 2.0 e anterior, você poderia 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 seguinte com a função Format para retornar o valor de cadeia de caracteres apropriado 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")

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

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

Essa alteração só se aplica quando você usa a função Format para formatar uma cadeia de caracteres dependente de uma cadeia de caracteres de comprimento zero ou um valor Null. Outras expressões de formato usadas com a função Format continuam a funcionar como nas versões anteriores.

Se você converter um banco de dados do Microsoft Access versão 2.0 e anterior para o Microsoft Access 2002 ou posterior, deverá alterar o código para testar separadamente o caso Null.

Consulte Também

As funções de cadeia de caracteres e como usá-las

Precisa de mais ajuda?

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.

×