Predefinição:Moeda

Documentação da predefinição[ver] [editar] [histórico] [purgar]

Formata um valor de moeda com o símbolo apropriado que está ligado ao artigo sobre a moeda. Se nenhuma moeda for especificada, o modelo mostrará o valor em Dólares dos Estados Unidos.

Uso

Utilizando parâmetros não nomeados:

{{moeda|value|code|first=|linked=|fmt=|passthrough=}}

Utilizando parâmetros nomeados:

{{moeda|amount=value|code=code|first=|linked=|passthrough=}}

onde:

value é um número com ou sem separadores de vírgulas; pode ser seguido por um quantificador opcional: 'mil', 'milhões', 'm', 'bilhão', ' B 'ou'trilhão'

code é um ISO 4217 código de moeda ou um dos códigos não-padrão suportados listados abaixo

|first= quando definido como qualquer valor produz um nome de moeda de formato longo

|linked= quando definido como no desactiva as ligações wiki no símbolo da moeda rendida ou no nome da moeda de formato longo

|fmt= define como grupos de dígitos de value são separados:

vírgulas (padrão) separa grupos de dígitos de value com vírgulas; isso é o padrão, mesmo que quando |fmt= está vazio ou é omitido

gaps separa grupos de dígitos de value com com lacunas estreitas

none mostra value sem grupos de dígitos

Nota: o uso de parâmetros nomeados e não nomeados pode produzir resultados inesperados. Neste exemplo, o modelo espera que o primeiro parâmetro sem nome seja um número de valor:

{{Moeda|amount=1000|GBP}}

|passthrough= especifica se o modelo deve ou não tentar analisar o número de acordo com |fmt= ou apenas colocar qualquer string fornecida em |amount= logo após o sinal da moeda. Deve ter valor de qualquer |passthrough=yes ou |passthrough=no

Quando se utiliza nomes de parâmetros, |amount= e |code= são preferidos. A predefinição também aceita |Amount= e |type= e |Type=.

Códigos monetários não normalizados suportados

Códigos que podem ser traduzidos para moedas ISO 4217

Estes códigos não normalizados são pseudónimos dos códigos normalizados ISO 4217.

• EGE
• EU
• EURO
• FRW
• KSH
• NEP
• POUND
• POUND STERLING
• RMB
• STERLING
• STG
• TSH
• UK
• UNITED STATES
• US
• U.S.
• USA
• USH

Outros código não normalizados

Estes códigos não têm um código monetário ISO 4217 correspondente ou são versões alternativas dos códigos ISO 4217 existentes ou suportam aspectos únicos de uma moeda.

• BITCOIN – sem código igual ISO 4217
• BTC – sem código igual ISO 4217
• DKK2 – versão alternada de DKK
• FRF – histórico
• GRD – histórico
• LSL2 – versão plural de LSL
• LTL – histórico
• NOK2 – versão alternada de NOK
• SEK2 – versão alternada de SEK
• SZL2 – versão plural de SZL
• US$ - caso especial: como os códigos padrão " USD "(e"$"), mas exibe apenas " $ " em vez do "US$" Mais Longo (para artigos em que a exibição de "US$" pode parecer inadequadamente longa, mas o modelo ainda deve vincular a "Dólar dos Estados Unidos" para evitar qualquer ambiguidade)
• XBT – sem código igual ISO 4217

Exemplos

Outras moedas que não o dólar dos Estados Unidos podem ser convertidas utilizando o código monetário apropriado ISO 4217

• {{Moeda|1000|BMD}} gives: BD$1 000 para a Dólar bermudense
• {{Moeda|1000|BDT}} gives: Tk. 1 000 para a taka
• {{Moeda|1000|AMD}} gives: ֏1 000 para a Dram arménio

Algumas das moedas mais conhecidas também permitem utilizar abreviaturas comuns ou nomes completos.

• {{Moeda|1000|US}} mostra: US$1 000
• {{Moeda|1000|United States}} mostra: US$1 000
• {{Moeda|1,000|JPY}} mostra: ¥1 000

Os nomes dos parâmetros também podem ser usados, se preferir:

• {{Moeda|amount=1000|code=US}} mostra: US$1 000
• {{Moeda|1000|code=euro}} mostra: €1 000

Valor negativo:

• {{Moeda|amount=-1000|code=US}} mostra: US$−1 000

Quantificadores de texto:

• {{Moeda|1000 million|code=euro}} mostra:
• {{Moeda|1000M|code=euro}} mostra: €1 000 000 000

O primeiro uso de uma moeda deve mostrar o valor e o nome completo da moeda, portanto, se o parâmetro "primeiro" for definido, é isso que será dado.

• {{Moeda|1000|cve|first=yes}} mostra: 1 000 escudos cabo-verdianos
• {{Moeda|1000|cve}} mostra: $1 000

Uma vez que o símbolo das moedas DKK, NOK e SEK pode ser ambíguo, estas podem ser representadas de duas formas:

• Para DKK:

  {{Moeda|1000|dkk}} mostra: DKr 1 000

  {{Moeda|1000|dkk2}} mostra: 1 000 DKK

• Para NOK:

  {{Moeda|1000|NOK}} mostra: NKr 1 000

  {{Moeda|1000|NOK2}} mostra: 1 000 NOK

• Para SEK:

  {{Moeda|1000|SEK}} mostra: SKr 1 000

  {{Moeda|1000|SEK2}} mostra: 1 000 SEK

Da mesma forma, algumas moedas usam símbolos diferentes para quantidades únicas e plurais:

• {{Moeda|1|LSL}} mostra: L 1

  {{Moeda|1000|LSL2}} mostra: M 1 000

  No momento, o modelo não faz essa distinção automaticamente, portanto, é responsabilidade do editor usar esses tipos de códigos para acertar o código.

Agrupamento de dígitos:

• |fmt=commas

  {{Moeda|1000 million|code=euro|fmt=commas}} mostra:

• |fmt=gaps

  {{Moeda|1000 million|code=euro|fmt=gaps}} mostra:

• |fmt=none

  {{Moeda|1000 million|code=euro|fmt=none}} mostra:

Passthrough:

• |passthrough=yes

  {{Moeda|6 million|PHP|passthrough=yes}} mostra: ₱6 million

  {{Moeda|6 trillion|PHP|passthrough=yes}} mostra: ₱6 trillion

  {{Moeda|6 tn|PHP|passthrough=yes}} mostra: ₱6 tn

• |passthrough=no

  {{Moeda|6 million|PHP|passthrough=no}} mostra:

  {{Moeda|6 trillion|PHP|passthrough=no}} mostra:

  {{Moeda|6 tn|PHP|passthrough=no}} mostra: (erro esperado, pois o modelo não sabe como analisar 6 tn a 6,000,000,000,000)

• Use com moderação! Normalmente você quer |fmt= em vez disso. |passthrough= só deve ser utilizado de forma compatível com MOEDA.

Mensagens de erro

{{moeda}} pode produzir vários mensagem de erro. Estes são:

• – o valor no segundo parâmetro sem nome ou atribuído a |code= não pode ser encontrado na lista de códigos do modelo. Certifique-se de que o código atribuído é um código ISO 4217 moeda correto ou um dos códigos não padronizados suportados listados acima.
• – o valor no primeiro parâmetro sem nome ou atribuído a |amount= contém um ou mais caracteres que não é um sinal de menos, um dígito, vírgula ou ponto decimal, ou tem algum texto que não é um dos quantificadores permitidos. Certifique-se de que os separadores de vírgulas agrupam três dígitos e que o número tem apenas um ponto decimal. Certifique-se de que os parâmetros de quantidade e Código sejam nomeados (|amount= e |code=) ou ambos sem nome.
• – um erro interno que só deve ocorrer quando um editor Módule:Moeda/dados. Isso indica que Módulo:Moeda não sabe onde colocar o símbolo monetário em relação ao seu valor.
• – um erro interno que só deve ocorrer quando um editor Módule:Moeda/dados. Indica que o módulo: Moeda não tem uma página que possa usar para vincular o símbolo ou o nome da moeda.

TemplateData

Use este modelo para fornecer um símbolo de moeda vinculado e a quantidade de dinheiro.

Parâmetros da predefinição[Editar dados da predefinição]

Esta predefinição prefere a formatação em linha dos parâmetros.

Parâmetro		Descrição	Tipo	Estado
Valor	1 amount Amount	O valor na moeda dada	Linha	obrigatório
Moeda	2 code type Type	A moeda representada. Deve ser um código ISO 4217 válido ou um dos códigos especiais listados na página do modelo Padrão USD Exemplo USD	Linha	recomendado
Forma longa	first	Quando definido como qualquer valor, produz um nome de moeda de formato longo. Isto deve ser utilizado para a primeira menção de uma moeda no artigo	Linha	opcional
Link moeda	linked	Se deve ligar para o artigo sobre essa moeda. “no” suprime o link, qualquer outro valor o exibe Padrão yes Exemplo no	Linha	opcional
Formato	fmt	Especifica como os grupos de dígitos de valores são separados: vírgulas, lacunas ou nenhum Padrão commas Exemplo gaps	Linha	opcional
Passthrough	passthrough	Se "yes", coloque a string em quantidade diretamente após seu símbolo, sem transformá-la em um número. Padrão no Exemplo yes	Linha	opcional

Ver também

• en:Wikipedia:Manual of Style (dates and numbers)#Currencies para obter instruções importantes sobre o padrão de Utilização.
• {{Format price}}, um modelo que lida com arredondamento e formatação de "grande número"
• {{Inflação}}, um modelo que ajusta os custos históricos ao valor equivalente corrente (ou de outro ano)
• {{Info/Moeda}}

A documentação acima é transcluída de Predefinição:Moeda/doc. (editar | histórico)
Editores podem experimentar nas páginas de teste (criar | espelhar) e de exemplos para testes (criar) desta predefinição.
Adicione categorias à subpágina /doc. Subpáginas desta predefinição.