IBM Lotus Symphony
|
Converte um número numa cadeia e formata-o de acordo com o formato que especificar.
Format (Number [, Format As String])
String
Number: Expressão numérica que pretende converter numa cadeia formatada.
Format: Cadeia que especifica o código de formato para o número. Se Format for omitida, a função Format funciona como a função Str.
A seguinte lista descreve os códigos que pode utilizar para formatar um número:
0: Se Number tem um dígito na posição do 0 no código do formato o dígito é apresentado, caso contrário, é apresentado um zero.
Se Number tem menos dígitos que o número de zeros no código do formato, (em qualquer um dos lados da casa decimal), são apresentados os zeros à esquerda ou à direita. Se o número tem mais dígitos à esquerda do separador decimal do que zeros no código do formato, os dígitos adicionais são apresentados sem formatação.
As casas decimais do número são arredondadas de acordo com o número de zeros apresentados após o separador decimal no código Format.
#: Se Number contém um dígito na posição do marcador de posição # no código Format, o dígito é apresentado, caso contrário nada é apresentado nesta posição.
Este símbolo funciona como o 0, excepto o facto de que os zeros à esquerda ou à direita não são apresentados se existirem mais caracteres # no código do formato do que dígitos no número. Só são apresentados os dígitos relevantes do número.
.: O marcador de posição decimal determina o número de casas decimais à esquerda e direita do separador decimal.
Se o código do formato contiver marcadores de posição # apenas à esquerda deste símbolo, os números inferiores a 1 começam com um separador decimal. Para apresentar sempre um zero à esquerda nos números fraccionais, utilize o 0 como marcador de posição para o primeiro dígito à esquerda do separador decimal.
%: Multiplica o número por 100 e insere o sinal de Percentagem (%) onde o número é apresentado no código do formato.
E- E+ e- e+ : Se o código do formato contém pelo menos um marcador de posição de dígitos (0 ou #) à direita do símbolo E-, E+, e-, ou e+, o número é formatado de acordo com o formato científico ou exponencial. A letra E ou e é inserida entre o número e o expoente. O número de marcadores de posição de dígitos à direita do símbolo determina o número de dígitos no expoente.
Se o expoente for negativo, é apresentado um sinal de Menos directamente antes de um expoente com E-, E+, e-, e+. Se o expoente for positivo, só é apresentado um sinal de adição antes dos expoentes com E+ ou e+.
O delimitador dos milhares é apresentado se o código do formato contiver o delimitador entre marcadores de posição de dígitos (0 ou #).
A utilização do ponto como separador dos milhares e das décimas depende da definição regional. Sempre que introduz um número directamente em código-fonte do Basic, utilize sempre um ponto final como delimitador decimal. O verdadeiro carácter apresentado como separador decimal depende do formato numérico nas definições de sistema.
- + $ ( ) espaço: O sinal mais (+), menos (-), dólar ($), espaço ou parênteses rectos inserido directamente no código do formato é apresentado como um carácter literal.
Para apresentar mais caracteres do que aqueles aqui listados, terão de ser precedidos por uma barra invertida (\), ou colocados entre aspas (" ").
\ : A barra invertida apresenta o carácter seguinte no código do formato.
Os caracteres no código do formato que tenham um significado especial só podem ser apresentados como caracteres literais se forem precedidos por uma barra invertida. A barra em si não é apresentada, a menos que introduza uma dupla barra invertida (\\) no código do formato.
Os caracteres que têm de ser precedidos de uma barra invertida no código do formato, de forma a serem apresentados como caracteres literais são os caracteres formatadores da data e da hora (a, c, d, h, m, n, p, q, s, t, w, y, /, :, ), caracteres formatadores de número (#, 0, %, E, e, vírgula, ponto final) e caracteres formatadores de cadeias (@, &, <, >, !).
É também possível utilizar os seguintes formatos de números predefinidos. Excepto o "General Number", todos os códigos de formato predefinido devolvem o número como um número decimal com duas casas decimais.
Se utilizar formatos predefinidos, o nome do formato terá de estar entre aspas.
General Number: Os números são apresentados tal como são inseridos.
Currency: Introduz um símbolo de dólar à frente do número e coloca os números negativos entre parênteses rectos.
Fixed: Apresenta pelo menos um dígito à frente do separador decimal.
Standard: Apresenta os números com o separador dos milhares.
Percent: Multiplica o número por 100 e anexa um sinal de Percentagem ao número.
Scientific: Apresenta números em formato científico (por exemplo, 1.00E+03 para 1000).
Um código de formato pode ser dividido em três secções separadas por ponto e vírgulas. A primeira parte define o formato dos valores positivos, a segunda dos negativos e a terceira do zero. Se só especificar um código do formato, este aplica-se a todos os números.
Pode definir a configuração regional utilizada para controlar os números de formatação, datas e unidades monetárias do Lotus® Symphony™ Basic em Ferramentas - Opções - Definições de idioma - Idiomas. Nos códigos de formatação do Basic, a vírgula decimal (,) é sempre utilizada como marcador de posição do separador decimal definido na configuração regional e será substituída pelo carácter correspondente.
O mesmo se aplica às definições de configuração regional para os formatos da data, hora e moeda. O código de formatação do Basic será interpretado e apresentado de acordo com a configuração regional.
Sub ExampleFormat
MsgBox Format(6328.2, "##,##0.00")
REM utiliza sempre um ponto final como delimitador decimal quando introduzir números em código-fonte do Basic.
REM apresenta, por exemplo, 6,328.20 na configuração regional de inglês e 6.328,20 na configuração regional de alemão.
End Sub