Função Format

Retorna uma variante (cadeia) 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 solucionar um problema, consulte as funções formato ou datepart podem retornar o número de semana incorreto para a última segunda-feira do ano.

Veja alguns exemplos

Sintaxe

Format ( expressão [, formato ] [, FirstDayOfWeek ] [, primeirasemanadoano ] )

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

Argumento

Descrição

expressão

Obrigató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 argumento Format pode usar uma variedade de configurações, dependendo do tipo de dados do argumento da 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 usam esse tipo de dados...

Confira o artigo

Qualquer tipo

Propriedade Format

Data/hora

Formatar um campo de data e hora

Numérico

Formatar um campo número ou moeda

Texto e memorando

Formatar um campo de texto

Sim/Não

Propriedade Format - tipo de dados sim/não


O argumento FirstDayOfWeek tem as seguintes 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 primeirasemanadoano tem as seguintes 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

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

Seqüências

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


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

Se você estiver Formatando uma cadeia de caracteres numérica não traduzida, use um formato numérico definido pelo usuário para garantir que você tenha a aparência desejada.

Observação: Se a configuração da propriedade calendário for Gregoriano e Formatar especificar a formatação de data, a expressão fornecida deve ser gregoriano. Se a configuração da propriedade de calendário do Visual Basic for Hijri, a expressão fornecida deve ser islâmica.

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 islâmico, todos os símbolos de formato de data (por exemplo, dddd, mmmm, yyyy) terão o mesmo significado, mas se aplicam ao calendário islâmico. Os símbolos de formato permanecem em inglês; os símbolos que resultam na 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 certos símbolos muda quando o calendário é islâmico.

Símbolo

Intervalo

d

1-30

dd

1-30

ss

1-51

mmm

Exibe nomes completos em meses (nomes dos meses islâmicos 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 em qualquer lugar para poder 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 mostram uma expressão que você pode usar em uma propriedade de filtro de relatório para limitar a saída aos registros da semana anterior.

Format ([data], "WW") = formato (agora (), "SS")-1

Neste exemplo, a fonte de registro do relatório tem um campo chamado Date, que contém a data em que cada registro específico foi modificado e que é usado no relatório. Quando você executa o relatório, seus resultados são filtrados para mostrar somente os registros nos quais a semana do valor no campo de data (formato ([data], "SS")) é igual à semana anterior (formato (agora (), "SS")-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 do Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione referência do desenvolvedor na lista suspensa 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 data (/), separador de tempo (:) e literal AM/PM, a saída formatada real exibida pelo seu sistema depende das configurações de localidade do computador em que o código está sendo executado. Quando os horários e datas são exibidos no ambiente de desenvolvimento, o formato de hora curto e o formato de data abreviada da localidade de código são usados. Quando exibida por meio do código em execução, o formato de hora curto e o formato de data abreviada da localidade do sistema são usados, o que pode ser diferente da localidade do código. Para este exemplo, pressupõe-se que a localidade do inglês dos EUA esteja presumida.

MyTime e MyDate são exibidos no ambiente de desenvolvimento usando a configuração de hora do sistema atual e a 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 Format com cadeias de comprimento zero

Na versão 2,0 e anterior do Microsoft Access, 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 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 a caixa nula 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 se aplica apenas quando você usa a função Format para formatar uma cadeia de caracteres dependente de se é uma cadeia de comprimento zero ou um valor nulo. Outras expressões de formato usadas com a função Format continuam funcionando 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, será necessário alterar o código para testar separadamente a caixa nula.

Consulte Também

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

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.

×