IBM Lotus Symphony
|
Converte um número em uma sequência e formata-o de acordo com o formato que você especificar.
Format (Number [, Format As String])
Sequência
Number: Expressão numérica que você deseja converter em uma sequência formatada.
Format: Sequência que especifica o código do formato do número. Se Format for omitido, a função Format funcionará como a função Str.
A lista a seguir descreve os códigos que é possível usar para formatar um número:
0: Se Number tiver um dígito na posição do 0 no código de formato, o dígito será exibido, caso contrário será exibido um zero.
Se Number tiver menos dígitos que o número de zeros no código de formato, (em qualquer lado do decimal), os zeros à esquerda ou à direita serão exibidos. Se o número tiver mais dígitos à esquerda do separador decimal que a quantidade de zeros no código de formato, os dígitos adicionais serão exibidos sem formatação.
As casas decimais no número são arredondadas de acordo com o número de zeros que aparecem após o separador decimal no código Format.
#: Se Number contiver um dígito na posição do marcador # no código Format, o dígito será exibido, caso contrário, nada será exibido nessa posição.
Esse símbolo funciona como o 0, exceto que os zeros à esquerda e à direita não serão exibidos se houver mais caracteres # no código de formato que os dígitos no número. Somente os dígitos relevantes do número são exibidos.
.: O separador decimal determina o número de casas decimais à esquerda e à direita do separador decimal.
Se o código de formato contiver somente os marcadores # à esquerda desse símbolo, os números menores que 1 começarão com um separador decimal. Para exibir sempre um zero à esquerda com números fracionários, use 0 como um marcador para o primeiro dígito à esquerda do separador decimal.
%: Multiplica o número por 100 e insere o símbolo de porcentagem (%) onde o número aparece no código de formato.
E- E+ e- e+ : Se o código de formato contiver pelo menos um marcador de dígito (0 ou #) à direita do símbolo E-, E+, e- ou e+, o número será formatado no formato científico ou exponencial. A letra E ou e é inserida entre o número e o expoente. O número de marcadores para dígitos à direita do símbolo determina o número de dígitos no expoente.
Se o expoente for negativo, um sinal de menos será exibido diretamente antes de um expoente com E-, E+, e-, e+. Se o expoente for positivo, um sinal de mais será exibido somente antes dos expoentes com E+ ou e+.
O delimitador de milhares será exibido se o código de formato contiver o delimitador entre os marcadores de dígitos (0 ou #).
O uso de um ponto como um separador de milhares e decimal depende da configuração regional. Ao inserir um número diretamente no código de origem do Basic, sempre use um ponto como delimitador decimal. O caractere real exibido como um separador decimal depende do formato numérico em suas configurações do sistema.
- + $ ( ) espaço: Um sinal de mais (+), menos (-), cifrão ($), espaço ou colchetes inserido diretamente no código de formato é exibido como um caractere literal.
Para exibir caracteres que não sejam os listados aqui, eles devem ser precedidos por uma barra invertida (\) ou colocados entre aspas " ").
\ : A barra invertida exibe o próximo caractere no código de formato.
Os caracteres no código de formato que possuem um significado especial somente poderão ser exibidos como caracteres literais se forem precedidos por uma barra invertida. A própria barra invertida não será invertida, a não ser que você insira duas barras invertidas (\\) no código de formato.
Os caracteres que devem ser precedidos por uma barra invertida no código de formato para serem exibidos como caracteres literais são caracteres de formatação de data e hora (a, c, d, h, m, n, p, q, s, t, w, y, /, :, ), caracteres de formatação numérica (#, 0, %, E, e, vírgula, ponto) e caracteres de formatação de sequência (@, &, <, >, !).
Você também pode usar os seguintes formatos numéricos predefinidos. Exceto para "General Number", todos os códigos de formato predefinidos retornam o número como um número decimal com duas casas decimais.
Se você usar formatos predefinidos, o nome do formato deverá ser colocado entre aspas.
Números Gerais: Os números são exibidos à medida que são inseridos.
Moeda: Insere um cifrão na frente do número e coloca os números negativos entre colchetes.
Fixo: Exibe no mínimo um dígito na frente do separador decimal.
Padrão: Exibe números com um separador de milhares.
Porcentagem: Multiplica o número por 100 e coloca um sinal de porcentagem no número.
Científico: Exibe números em formato científico (por exemplo, 1.00E+03 para 1000).
Um código de formato pode ser dividido em três seções separadas por ponto-e-vírgula. A primeira parte define o formato para valores positivos, a segunda parte para valores negativos e a terceira parte para zero. Se você especificar apenas um código de formato, ele se aplicará a todos os números.
É possível definir o código do idioma para controlar os números, datas e moedas de formatação no Lotus® Symphony™ Basic em Ferramentas - Opções - Definições de Idioma - Idiomas. Em códigos de formatação Basic, o ponto decimal (.) é sempre usado como marcador para o separador de decimal definido no local e será substituído pelo caractere correspondente.
O mesmo se aplica às definições do local para formatos de data, hora e moeda. O código de formatação Basic será interpretado e exibido de acordo com a definição do local.
Sub ExampleFormat
MsgBox Format(6328.2, "##,##0.00")
REM use sempre um ponto como delimitador decimal quando inserir números no código de origem do Basic.
REM exibe, por exemplo, 6.328,20 em código do idioma inglês, 6.328,20 em código do idioma alemão.
End Sub