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 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 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 é omitidogaps
separa grupos de dígitos de value com com lacunas estreitasnone
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}}
- {{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=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[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 tn
a6,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"{{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. Por favor adicione categorias à subpágina /doc. Subpáginas desta predefinição. |