Predefinição:Moeda
 | Esta predefinição usa Lua: |
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
[editar código-fonte]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 comonodesactiva 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 é omitidogapssepara grupos de dígitos de value com com lacunas estreitasnonemostra 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}}- {{currency}} – valor inválido (ajuda)
|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=yesou|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
[editar código-fonte]Códigos que podem ser traduzidos para moedas ISO 4217
[editar código-fonte]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
[editar código-fonte]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
[editar código-fonte]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:
Valor negativo:
{{Moeda|amount=-1000|code=US}}mostra: US$−1 000
Quantificadores de texto:
{{Moeda|1000 million|code=euro}}mostra: {{currency}} – valor inválido (ajuda){{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:
- Para NOK:
- Para SEK:
Da mesma forma, algumas moedas usam símbolos diferentes para quantidades únicas e plurais:
Agrupamento de dígitos:
|fmt=commas{{Moeda|1000 million|code=euro|fmt=commas}}mostra: {{currency}} – valor inválido (ajuda)
|fmt=gaps{{Moeda|1000 million|code=euro|fmt=gaps}}mostra: {{currency}} – valor inválido (ajuda)
|fmt=none{{Moeda|1000 million|code=euro|fmt=none}}mostra: {{currency}} – valor inválido (ajuda)
Passthrough:
|passthrough=yes|passthrough=no{{Moeda|6 million|PHP|passthrough=no}}mostra: {{currency}} – valor inválido (ajuda){{Moeda|6 trillion|PHP|passthrough=no}}mostra: {{currency}} – valor inválido (ajuda){{Moeda|6 tn|PHP|passthrough=no}}mostra: {{currency}} – valor inválido (ajuda) (erro esperado, pois o modelo não sabe como analisar6 tna6,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
[editar código-fonte]{{moeda}} pode produzir vários mensagem de erro. Estes são:
- {{moeda}} – código inválido – 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. - {{moeda}} – valo inválido – 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. - {{moeda}} – definição com posição em falta – 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.
- {{moeda}} – definição em falta – 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
[editar código-fonte]Use este modelo para fornecer um símbolo de moeda vinculado e a quantidade de dinheiro.
| 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
| 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
| Linha | opcional |
| Formato | fmt | Especifica como os grupos de dígitos de valores são separados: vírgulas, lacunas ou nenhum
| Linha | opcional |
| Passthrough | passthrough | Se "yes", coloque a string em quantidade diretamente após seu símbolo, sem transformá-la em um número.
| Linha | opcional |
Ver também
[editar código-fonte]- 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"
- {{Corrigir inflação}}, um modelo que ajusta os custos históricos ao valor equivalente corrente (ou de outro ano)
{{Info/Moeda}}