Referência de códigos de países

O que é uma referência de códigos de países?#

Todos os sistemas internacionais — um gateway de pagamento, um analisador de números de telefone, uma etiqueta de envio, um painel de analítica — mais cedo ou mais tarde precisa transformar “Alemanha” em DE, 840 em “Estados Unidos”, ou +81 em “Japão”. Esses códigos curtos não são abreviações aleatórias; vêm de três padrões coordenados mantidos para que máquinas em países diferentes concordem sobre a mesma entidade:

• ISO 3166-1 define os identificadores de duas letras (alfa-2, por exemplo JP), três letras (alfa-3, por exemplo JPN) e três dígitos (numérico, por exemplo 392) para todos os países e grandes territórios.
• ITU-T E.164 define o prefixo internacional de discagem que você coloca depois do + (Japão é +81, Nigéria +234).
• ISO 4217 define o código de moeda (JPY, NGN).

Esta página põe todos os cinco numa única tabela pesquisável, além da capital e de um emoji de bandeira computado diretamente do código alfa-2. Os nomes localizados de país e moeda são produzidos pelo próprio Intl.DisplayNames do seu navegador, então eles leem naturalmente no seu idioma em vez de virem de uma lista traduzida à mão que envelhece e fica desatualizada.

Como usar#

1. Comece a digitar na caixa de Pesquisa no topo. Uma única caixa corresponde a tudo: nome do país (no seu idioma ou em inglês), alfa-2, alfa-3, o código numérico, o código de chamada, a capital, ou o código de moeda. Digite DE, Germany, 276, 49, Berlin, ou EUR — todos pousam na mesma linha.
2. Consultas de puros dígitos fazem duplo dever. 840 corresponde ao numérico ONU M49 dos Estados Unidos; 1 ou +1 corresponde a todos os países do Plano de Numeração Norte-Americano (EUA, Canadá, Jamaica, Porto Rico…) por prefixo de código de chamada.
3. O chip de contagem ao lado da caixa de pesquisa mostra quantas linhas sobreviveram ao filtro.
4. Clique em qualquer linha (ou toque numa célula) para copiar aquele valor exato para a área de transferência — útil quando você precisa colar alfa-2 num formulário.
5. A coluna de bandeira mostra o emoji indicador regional. Alguns territórios (Antártida AQ) são Unicode válidos que algumas plataformas renderizam como letras nuas AQ em vez de uma bandeira; o código em si continua correto.

Principais funcionalidades#

• 249 entradas, uma tabela — todos os países ISO 3166-1 além de territórios e dependências importantes (Gronelândia, Porto Rico, Hong Kong, Åland…), cada um com todos os cinco códigos.
• Localizado pelo navegador. Os nomes de exibição de país e moeda vêm do Intl.DisplayNames, então um espectador em português vê Alemanha e Euro sem nenhuma tabela de tradução enviada.
• Correspondência de dígitos inteligente. Uma consulta numérica atinge tanto o número ONU M49 (exato ou prefixo) quanto o código de chamada (prefixo de dígitos), então 1 revela de forma confiável o bloco NANP.
• Inclui códigos atribuídos pelo usuário. O Kosovo (XK / XKX / 983) está presente embora ainda não seja uma entrada oficial da ISO 3166-1 — muitos sistemas reais o usam.
• 100% do lado do cliente. O conjunto de dados vem na página; nada é enviado para lugar nenhum.

Exemplo prático#

Suponha que você está integrando um checkout e um cliente informa o número de chamada com o código do país +234. Você quer saber de quem é esse número e para qual moeda definir o formulário por padrão.

Digite 234 na caixa de pesquisa. Exatamente uma linha sobrevive:

Então +234 → Nigéria, moeda NGN (a naira nigeriana), capital Abuja. Agora compare com um membro do NANP. Limpe a caixa e digite 1-787 — Porto Rico (PR / PRI / 630), capital San Juan, moeda USD, porque ele compartilha o plano de discagem dos EUA através do código de área 787. O sufixo -xxx é como este conjunto de dados distingue códigos de área NANP que, de outra forma, colidiriam sob um 1 nu.

FAQ#

Qual é a diferença entre alfa-2 e alfa-3?#

Alfa-2 (US, DE, JP) é a forma compacta usada em todo lugar onde um humano possa lê-lo: domínios de topo (example.de), formulários de endereço, tags de idioma (zh-CN). Alfa-3 (USA, DEU, JPN) é mais legível e menos ambíguo, então aparece em passaportes, campos SWIFT/IBAN e documentos alfandegários. Use alfa-2 quando armazenamento ou espaço na tela importa; alfa-3 quando a clareza importa.

Por que 840 significa Estados Unidos?#

Esse é o código numérico ONU M49 / ISO 3166-1 — um número de três dígitos preenchido com zeros, atribuído independentemente dos códigos alfabéticos. É valioso quando caracteres fora do ASCII são um problema e quando você ordena ou compara códigos de sistemas que discordam na ortografia. O código numérico é o identificador mais estável: raramente muda mesmo quando um país é renomeado.

Os códigos de chamada são únicos por país?#

Não. O Plano de Numeração Norte-Americano (+1) cobre cerca de 20 países e territórios; +7 é compartilhado por Rússia e Cazaquistão. É por isso que este conjunto de dados registra códigos de área como 1-787 para Porto Rico, para que uma pesquisa pela string completa de dígitos continue a desambiguar.

O Kosovo é um código de país real?#

O Kosovo usa o código atribuído pelo usuário XK (transitório, ainda não na ISO 3166-1). Muitos sistemas de pagamento e telecom aceitam-no hoje; esta tabela inclui-o exatamente por esse motivo, e marca-o claramente para que não o confunda com um código oficialmente atribuído.