Função Format

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Retorna uma variante (cadeia) que contém um expression 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 constant que especifica o primeiro dia da semana.

primeirasemanadoano

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


Configurações

O formatoargument 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 - data/hora tipo de dados

Numérico

Propriedade Format - tipos de dados de moeda e número

Texto e Memorando

Propriedade Format - texto e tipos de dados Memorando

Sim/Não

Propriedade Format - tipo de dados Sim/não


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 zero-length string 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.

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
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.

×