Format

Formata os dados fornecidos de acordo com a string de formato de imagem especificada.

Sintaxe

Format(s1, s2 [, s3 ...])

Parâmetros

Parâmetro

Descrição

s1

A string de formato de imagem, que pode ser um formato de data ou hora com distinção entre localidades.

Consulte Localidades.

s2

Os dados de origem a serem formatados.

Para formatos de imagem de dados, os dados de origem devem ser uma string de data e hora ISO ou uma string de data ISO em um destes dois formatos:

  • YYYY[MM[DD]]

  • YYYY[-MM[-DD]]

  • HH[MM[SS[.FFF][z]]]

  • HH[MM[SS[.FFF][+HH[MM]]]]

  • HH[MM[SS[.FFF][-HH[MM]]]]

  • HH[:MM[:SS[.FFF][z]

  • HH[:MM[:SS[.FFF][-HH[:MM]]]]

  • HH[:MM[:SS[.FFF][+HH[:MM]]]]

Para formatos de imagem de hora, os dados de origem devem ser uma string de data e hora ISO ou uma string de hora ISO em um dos seguintes formatos:

  • HH[MM[SS[.FFF][z]]]

  • HH[MM[SS[.FFF][+HH[MM]]]]

  • HH[MM[SS[.FFF][-HH[MM]]]]

  • HH[:MM[:SS[.FFF][z]

  • HH[:MM[:SS[.FFF][-HH[:MM]]]]

  • HH[:MM[:SS[.FFF][+HH[:MM]]]]

Para formatos de imagem de data e hora, os dados de origem devem ser uma string de data e hora ISO.

Para formatos de imagem numéricos, os dados de origem devem ser numéricos.

Para formatos de imagem de texto, os dados de origem devem ser textuais.

Para formatos de imagem compostos, o número de argumentos de dados de origem deve corresponder ao número de subelementos na imagem.

s3 (opcional)

Os dados de origem adicionais a serem formatados.

Exemplos

As expressões a seguir são exemplos de uso da função Format:

Expressão

Retorna

Format("MMM D, YYYY", "20020901")

Sep 1, 2002

Format("$9,999,999.99", 1234567.89)

$1,234,567.89 nos EUA e 1234567,89 Euros na França.