 | Esta predefinição usaLua: |
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 emDólares dos Estados Unidos.
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:
|first= quando definido como qualquer valor produz um nome de moeda de formato longo|linked= quando definido comono 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 devalue são separados:vírgulas (padrão) separa grupos de dígitos devalue com vírgulas; isso é o padrão, mesmo que quando|fmt= está vazio ou é omitidogaps separa grupos de dígitos devalue com com lacunas estreitasnone mostravalue sem grupos de dígitosNota: 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=noQuando se utiliza nomes de parâmetros,|amount= e|code= são preferidos. A predefinição também aceita|Amount= e|type= e|Type=.
Estes códigos não normalizados são pseudónimos dos códigos normalizadosISO 4217.
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.
Outras moedas que não odólar dos Estados Unidos podem ser convertidas utilizando ocódigo monetário apropriado ISO 4217
{{Moeda|1000|BMD}} gives:BD$1 000 para aDólar bermudense{{Moeda|1000|BDT}} gives:Tk. 1 000 para ataka{{Moeda|1000|AMD}} gives:֏1 000 para aDram arménioAlgumas 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 000Os nomes dos parâmetros também podem ser usados, se preferir:
Valor negativo:
{{Moeda|amount=-1000|code=US}} mostra:US$−1 000Quantificadores de texto:
{{Moeda|1000 million|code=euro}} mostra:{{currency}} – valor inválido (ajuda){{Moeda|1000M|code=euro}} mostra:€1 000 000 000O 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 000escudos cabo-verdianos{{Moeda|1000|cve}} mostra:$1 000Uma vez que o símbolo das moedas DKK, NOK e SEK pode ser ambíguo, estas podem ser representadas de duas formas:
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 tn a6,000,000,000,000)|fmt= em vez disso.|passthrough= só deve ser utilizado de forma compatível com MOEDA.{{moeda}} pode produzir vários mensagem de erro. Estes são:
|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.|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.Use este modelo para fornecer um símbolo de moeda vinculado e a quantidade de dinheiro.
| Parâmetro | Descrição | Tipo | Estado | |
|---|---|---|---|---|
| Valor | 1amountAmount | O valor na moeda dada | Linha | obrigatório |
| Moeda | 2codetypeType | 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 |
{{Info/Moeda}}