Money – função de script e gráfico

Money() formata uma expressão numericamente como um valor de moeda no formato numérico definido nas variáveis de sistema, definido no script de carga dos dados ou no sistema operacional, a não ser que uma string de formato seja fornecida, bem como separadores decimais e de milhar opcionais.

Sintaxe:

Money(number[, format[, dec_sep[, thou_sep]]])

Tipo de dados de retorno: dual

Argumentos
Argumento	Descrição
number	O número a ser formatado.
format	String descrevendo como a string de moeda resultante será formatada. Se for omitido, o valor definido no script de carga de dados para MoneyFormat será usado. A função Money oferece suporte a muitas opções de formato para diferentes estruturas de data, por exemplo: $#,##0.00: adiciona um cifrão e duas casas decimais. € #,##0: adiciona um sinal de euro e nenhuma casa decimal, com um espaço após o sinal de euro. ¥#,##0: adiciona um sinal de iene japonês sem casas decimais. $#,##0;($#,##0): formata valores negativos entre parênteses. ₣ #.##0,00: adiciona um sinal de franco suíço com pontos como separadores de milhar e uma vírgula para decimais (por exemplo, ₣ 1.000,00). R #,##0.00: sinal do rand sul-africano com duas casas decimais e espaço após o sinal do rand. $ #,##0.000: adiciona três casas decimais ao formato do dólar.
dec_sep	String especificando o separador de número decimal. Se omitida, o valor MoneyDecimalSep definido no script de carga de dados será usado. A função Money é compatível com muitos formatos de separadores decimais de números, por exemplo: Vírgula ' , ': por exemplo, $1,000,00 para mil dólares. Ponto ' . ': por exemplo, € 1,000.00. Hífen ' - ': quando usado no lugar do ponto tradicional ou da vírgula como separador decimal, mostra valores como ¥1,000-00.
thou_sep	String especificando o separador de número milhar. Se omitida, o valor MoneyThousandSep definido no script de carga de dados será usado. A função Money oferece suporte a várias opções para o separador de milhares de números: Ponto ' . ': usa um ponto para o separador de milhares (comum em alguns formatos europeus), exibido como $1.000,00 se combinado com um separador decimal com vírgula. Espaço ' ': usa um espaço para o separador de milhares, o que é comum em alguns países europeus. É exibido como € 1 000.00. Sublinhado '_': usa um sublinhado para o separador de milhares, que às vezes é usado em formatos técnicos ou regionais específicos. Exibe valores como $1_000.00.

Se os parâmetros de 2 a 4 forem omitidos, será utilizado o formato de moeda definido no sistema operacional.

Exemplo: expressões de gráfico
Exemplo	Resultados
Money( 35648 )	Retorna kr 35 648,00 quando a configuração de MoneyFormat é kr ##0,00 e o MoneyThousandSep é um ponto ' '.
Money( 35648, '#,##0 ¥', '.' , ',' )	Retorna 3,564,800 ¥ ignorando a configuração de MoneyFormat e a configuração de MoneyThousandSep, pois os parâmetros opcionais Format, dec_sep e thou_sep são fornecidos na função.
Money(35648)	Retorna $ 35,648.00 quando a configuração de MoneyFormat é $ #,##0.00 e o MoneyThousandSep é uma vírgula ','.

Exemplo – Fundamentos de Money

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

Um conjunto de dados que é carregado em uma tabela de dados denominada Example.
Um campo na tabela de dados chamado InputValue.
Os formatos de variável a seguir:
- Variável MoneyFormat, que usa o formato: kr ##0,00
- Variável MoneyThousandSep definida para usar um espaço ' '

Script de carregamento

SET MoneyFormat='kr ##0,00';
SET MoneyThousandSep=' ';
Example:
Load * inline [
InputValue
35648
3564800
];

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:

InputValue

Crie as seguintes medidas:

=Money(InputValue) para visualizar o valor como dinheiro formatado usando a configuração do sistema.
=Money(InputValue, '#,##0 ¥', '.' , ',') para visualizar o valor como dinheiro formatado usando o formato fornecido na função.
=Num(InputValue) para retornar o valor numérico.

Results table
InputValue	Money(InputValue)	Money(InputValue, '#,##0 ¥', '.' , ',')	Num(InputValue)
35648	kr35 648,00	35,648 ¥	35648
3564800	kr3 564 800,00	3,564,800 ¥	3564800

Neste exemplo, você pode ver como a função Money exibe valores e como os valores no parâmetro format podem alterar a saída.

Exemplo – Fundamentos de Money usando uma configuração de formato diferente

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

Um conjunto de dados que é carregado em uma tabela de dados denominada Example.
Um campo na tabela de dados chamado InputValue.
Os formatos de variável a seguir:
- Variável MoneyFormat, que usa o formato: $ #,##0.00
- Variável MoneyThousandSep definida para usar uma vírgula ','

Script de carregamento

SET MoneyFormat='$ #,##0.00';
SET MoneyThousandSep=',';
Example:
Load * inline [
InputValue
35648
3564800
];

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:

InputValue

Crie as seguintes medidas:

=Money(InputValue) para visualizar o valor como dinheiro formatado usando a configuração do sistema.
=Money(InputValue, '#,##0 ¥', '.' , ', ) para visualizar o valor como dinheiro formatado usando o formato fornecido na função.
=Num(InputValue) para retornar o valor numérico.

Results table
InputValue	Money(InputValue)	Money(InputValue, '#,##0 ¥', '.' , ',')	Num(InputValue)
35648	$ 35,648.00	35,648 ¥	35648
3564800	$ 3,564,800.00	3,564,800 ¥	3564800

Neste exemplo, você pode ver como a função Money exibe valores e como os valores no parâmetro format podem alterar a saída.

Exemplo – Cenário de Money

Visão geral

Os dados de vendas dos clientes são recebidos em várias moedas. Você deseja exibir os dados em uma tabela usando o formato de moeda relevante.

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

Um conjunto de dados que é carregado em uma tabela de dados denominada Example.
Os campos a seguir na tabela de dados:
- Customer
- CurrencyCode
- Sales
Os formatos de variável a seguir:
- Variável MoneyFormat, que usa o formato: $ ###0.00;-$ ###0.00
- Variável MoneyThousandSep definida para usar uma vírgula ','
- Variável MoneyDecimalSep definida para usar um ponto ".".

Script de carregamento

SET MoneyThousandSep=',';
SET MoneyDecimalSep='.';
SET MoneyFormat='$ ###0.00;-$ ###0.00';
Example:
Load * inline [
Customer, CurrencyCode, Sales
Customer A, USD, 100008
Customer B, EUR, 12500
Customer C, YEN, 15000
];

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:

Customer

Crie a seguinte medida:

=Money(Sales, If(CurrencyCode = 'USD', '$#,##0.00', If(CurrencyCode = 'EUR', '€ #,##0.00', '¥#,##0'))) para exibir a moeda no formato correto.

Results table
Customer	Money(Sales, If(CurrencyCode = 'USD', '$#,##0.00', If(CurrencyCode = 'EUR', '€ #,##0.00', '¥#,##0')))
Customer A	$100,008.00
Customer B	€ 12,500.00
Customer C	¥15,000

Os dados de vendas agora usam o formato de moeda definido na expressão de medida. Os parâmetros decimal e mil usam as configurações do script de carregamento.

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!

Deixe seu feedback aqui