lang • format

Format$

String = Format$ ( Expressao [ , Formato ] ) String = Format ( Expressao [ , Formato ] )

Converte a Expressao em uma string usando um formato que depende do tipo da Expressao.

Esta função pode formatar datas, horas, números e valores monetários.

Formato pode ser um formato predefinido (uma constante Integer) ou um formato definido pelo usuário (uma string que descreve o formato) ou pode ser omitido.

Veja Constantes Pré-definidas para uma lista de formatos pré-definidos.

Se Formato não é especificado, gb.Standard será usado.

Esta função usa configurações regionais

Formatos definidos pelo usuário para expressões numéricas

Um formato definido pelo usuário é descrito pela seqüência de caracteres especiais.

Caracteres arbitrários especificados antes e depois da string de formatação serão impressos assim como são.

Caracteres para formatos definidos pelo usuário

+ Imprime o sinal do número
- Imprime o sinal de um número somente se ele é negativo.
# Imprime um dígito somente se necessário.
0 Sempre imprime um dígito, completando com um zero se necessário.
. Imprime o separador decimal.
, Imprime o separador de milhares.
% Multiplica o número por 100 e imprime um sinal de percentagem.
E Antecede a parte exponencial de um número Float. O sinal do expoente é sempre impresso.

Examples

Print Format$(Pi, "-#.###")
3.142
PRINT Format$(Pi, "+0#.###0")
+03.1416
PRINT Format$(Pi / 10, "###.# %")
31.4 %
PRINT Format$(-11 ^ 11, "#.##E##")
-2.85E+11

Formatos definidos pelo usuário para valores monetários

$ Imprime o símbolo nacional da moeda.
$$ Quando o $$ é duplicado, o símbolo internacional da moeda é impresso no lugar.
( Imprime a representação de valores monetários negativos. Ele deve ser o primeiro caracter do formato. Você pode especificar um parêntes fechado ) no final do formato.

Examples

Print Format$(1972.06, "$#.###")
$1972.06
PRINT Format$(-1972.06, "$,#.###")
-$1,972.06
PRINT Format$(-1972.06, "($,#.###)")
$1,972.06
or
1.972,06 €

Formatos definidos pelo usuário para datas

yy Imprime o ano em dois dígitos.
yyyy Imprime o ano em 4 dígitos.
m Imprime o mês.
mm Imprime o mês em dois dígitos (completa com zero).
mmm Imprime o mês em uma forma abreviada.
mmmm Imprime o mês em formato string completo.
d Imprime o dia.
dd Imprime o dia em dois dígitos (completa com zero).
ddd Imprime o dia da semana em uma forma abreviada.
dddd Imprime o dia da semana na forma completa.
/ Imprime o separador de data.
h Imprime a hora.
hh Imprime a hora em dois dígitos (completa com zero).
n Imprime os minutos.
nn Imprime os minutos em dois dígitos (completa com zero).
s Imprime os segundos.
ss Imprime os segundos em dois dígitos (completa com zero).
: Imprime o separador de hora.
u Imprime os milissegundos, se eles são diferentes de zero.

Examples

Print Format$(Now, "mm/dd/yyyy hh:nn:ssu")
04/15/2002 09:05:36.26
PRINT Format$(Now, "m/d/yy h:n:s")
4/15/02 9:5:36
PRINT Format$(Now, "ddd dd mmm yyyy")
Mon 15 Apr 2002
PRINT Format$(Now, "dddd dd mmmm yyyy")
Monday 15 April 2002
PRINT Format$(Now, "yyyy-mm-dd hh-nn-ss")
PRINT Format$(Now, "yyyy/mm/dd hh:nn:ss")
2006-04-29 07-41-11
2006.04.29 07:41:11

Veja também