Códigos ISO de Hong Kong: HK, HKG e 344 explicados
Pesquisar o código ISO de Hong Kong pode produzir várias respostas diferentes, porque os sistemas de países, telefonia, moeda, esportes e internet usam identificadores separados. Os códigos ISO 3166-1 de Hong Kong são HK, HKG e 344. Este guia explica o significado de cada formato, por que HKG também pode aparecer em dados olímpicos e como manter os códigos ISO separados de +852, HKD, .hk e .香港 em formulários, softwares e registros financeiros.
Códigos ISO de Hong Kong: resposta rápida
Hong Kong tem três representações ISO 3166-1: um código alfa-2 de duas letras, um código alfa-3 de três letras e um código numérico. O valor correto depende do campo ou sistema que recebe os dados.
Os três códigos ISO 3166-1 em uma única visão
| Tipo de código ISO | Valor de Hong Kong | Finalidade típica |
|---|---|---|
| Alfa-2 | HK | Campos curtos de país e intercâmbio geral de dados |
| Alfa-3 | HKG | Conjuntos de dados de países com três letras e alguns dados esportivos |
| Numérico | 344 | Sistemas estatísticos, legados e somente numéricos |
Uma lista secundária de países ISO de Ajuda e suporte da Docebo também identifica Hong Kong com o valor alfa-2 HK. O código de chamada telefônica, o código de moeda, o código olímpico e os domínios de internet não são formatos ISO 3166-1 adicionais. Eles pertencem a normas ou organizações diferentes.
Os três códigos ISO 3166-1 de Hong Kong explicados
Os três formatos ISO representam a mesma entrada geográfica de maneiras diferentes. Eles não são intercambiáveis em todas as aplicações, portanto a documentação do sistema receptor deve determinar qual valor você deve enviar ou armazenar.
O código alfa-2 ISO: HK
HK é o identificador alfa-2 ISO 3166-1 de duas letras de Hong Kong. É o formato compacto mais solicitado quando um campo geral de país pede um valor alfa-2 ISO. Por exemplo, um banco de dados criado para essa norma poderia armazenar country_alpha2 = HK.
HK não é igual ao prefixo telefônico internacional +852. Também não é idêntico ao sufixo de domínio .hk, embora as letras estejam relacionadas. O primeiro é um valor de país ISO, o segundo é usado na numeração telefônica e o terceiro é um identificador DNS.
Use HK quando o formulário, a API ou a especificação de dados disser claramente que espera o alfa-2 ISO 3166-1. Não presuma que todo campo denominado código do país usa esse formato. Alguns serviços exigem o nome completo, um valor alfa-3, um valor numérico ou um código específico do provedor.
O código alfa-3 ISO: HKG
HKG é o código alfa-3 ISO 3166-1 de três letras de Hong Kong. Um formato de três letras pode ser útil em conjuntos de dados internacionais nos quais se prefere uma abreviação mais longa e reconhecível ou quando a interface exige explicitamente valores alfa-3.
Por exemplo, uma API pode definir campos separados para country_alpha2 e country_alpha3. Nessa situação, HK pertence ao primeiro campo e HKG ao segundo. HKG não deve substituir automaticamente HK em um sistema que valide apenas valores de duas letras.
HKG também é usado em contextos olímpicos. A correspondência entre as letras pode facilitar o intercâmbio de dados, mas um código olímpico e um código ISO são regidos por organizações diferentes. Ao mapear registros, mantenha o nome do campo ou da norma de origem para que o significado de HKG permaneça claro.
O código numérico ISO: 344
344 é o código numérico ISO 3166-1 de Hong Kong. Identificadores numéricos são úteis para sistemas estatísticos, bancos de dados antigos e interfaces que precisam de um valor independente de idioma, sem abreviações alfabéticas.
Um campo chamado country_numeric ou iso_numeric pode, portanto, conter 344 quando estiver definido como um valor geográfico ISO 3166-1. O fato de a aplicação armazenar o valor como texto ou número depende do esquema do provedor. Preserve a definição do campo e o nome da norma ao trocar dados.
O número 344 também pode ocorrer em outros sistemas, inclusive em dados monetários. Isso não torna os registros intercambiáveis. Use a expressão código numérico geográfico ao comparar o valor de país ISO com um valor numérico monetário, e mantenha os dois significados em campos tipados separados.
Como outros identificadores de Hong Kong diferem dos códigos ISO
Os outros códigos conhecidos de Hong Kong são úteis, mas respondem a perguntas diferentes. Um sistema telefônico precisa de um código de chamada, um sistema de pagamentos precisa de um código de moeda, um banco de dados esportivo pode precisar de um código olímpico e a internet precisa de um rótulo de domínio.
O código de chamada internacional: +852
+852 é o código de chamada telefônica internacional de Hong Kong. Ele faz parte do sistema de numeração de telecomunicações, não de um identificador de país ISO 3166-1. Um aplicativo telefônico pode usá-lo para encaminhar ou exibir um número internacional, enquanto um campo de país no mesmo registro de cliente pode usar HK.
Por exemplo, um registro de conectividade poderia conter country_iso_alpha2 = HK e telephone_calling_code = +852. Esses valores descrevem informações de localização relacionadas, mas não devem ser armazenados em um único campo indiferenciado de código de país. O Escritório da Autoridade de Comunicações fornece informações sobre o plano de numeração de Hong Kong para uso em telecomunicações.
Quando um formulário diz código do país de Hong Kong, leia cuidadosamente os rótulos dos campos ao redor. Se o campo pertencer a um número de telefone, pode ser esperado +852. Se disser alfa-2 ISO, o valor relevante é HK. Armazene +852 em um campo de código de chamada telefônica, e não em um campo de código de país ISO.
O código de moeda: HKD
HKD é o código alfabético ISO 4217 do dólar de Hong Kong. Ele identifica uma moeda, não uma localização geográfica. Isso torna HKD diferente de HK e HKG, embora os três contenham letras associadas a Hong Kong.
Um registro de checkout, fatura ou contabilidade poderia separar os valores desta forma:
- country_alpha2: HK
- currency: HKD
- amount: 1,250.00
O código numérico geográfico ISO é 344. Um conjunto de dados monetários também pode associar 344 ao dólar de Hong Kong como código numérico de moeda. A repetição do número é uma possível fonte de erros de dados, especialmente quando tabelas de países e moedas são unidas automaticamente. Mantenha HKD e o código numérico geográfico 344 em campos tipados separados, mesmo quando os dois sistemas usam o número 344.
Portanto, HKD não é uma alternativa a um código de país ISO 3166-1. Use o campo de moeda documentado pelo provedor financeiro para HKD e o campo geográfico relevante para HK, HKG ou 344.
O código olímpico: HKG
O Comitê Olímpico Internacional usa HKG em seu sistema de códigos esportivos para Hong Kong. Isso é útil ao ler resultados olímpicos, tabelas de medalhas, listas de equipes ou feeds esportivos que usam abreviações do COI.
O valor coincide com o código alfa-3 ISO de Hong Kong, mas essa coincidência não significa que todo código esportivo seja um código ISO. O significado vem do conjunto de dados e da organização que o define. Um banco de dados geral de países pode interpretar HKG como alfa-3 ISO 3166-1, enquanto um arquivo de resultados olímpicos pode interpretá-lo como código esportivo do COI.
Ao mapear dados esportivos para um banco de dados geral de países, mantenha o sistema de origem ou o nome da norma. Trate o valor coincidente como uma conveniência de interoperabilidade, não como prova de que os dois sistemas de códigos são idênticos.
Os domínios de internet: .hk e .香港
.hk é o domínio de primeiro nível com código de país de Hong Kong em alfabeto latino. Ele é usado no DNS e em endereços de internet, não como valor para um campo de país ISO. Sua relação com o valor alfa-2 ISO HK ajuda a identificar o território representado pelo domínio, mas os dois identificadores ainda têm finalidades técnicas diferentes.
.香港 é o domínio internacionalizado de primeiro nível com código de país em escrita chinesa que representa Hong Kong. O relatório de delegação da IANA documenta sua delegação à Hong Kong Internet Registration Corporation Limited.
Os dados de delegação da IANA para .hk identificam a Hong Kong Internet Registration Corporation como administradora do domínio de primeiro nível com código de país. Na prática, o registro de domínios e a validação do DNS podem envolver regras separadas da validação de códigos de país ISO.
Em softwares de domínio, .香港 é um rótulo internacionalizado. Um navegador ou uma biblioteca DNS pode exibir a forma visível em escrita chinesa enquanto processa internamente uma representação compatível com ASCII. Use o formato exigido pela API de domínio específica. Antes de implementar regras de validação ou registro para .hk ou .香港, consulte as informações atuais da IANA e os requisitos atuais da Hong Kong Internet Registration Corporation.
Usando códigos de Hong Kong em formulários, softwares e dados
Erros de código geralmente acontecem quando um campo recebe um nome amplo demais. Uma integração confiável identifica primeiro a norma e o formato e, em seguida, valida o valor de acordo com essa definição.
Formulários, bancos de dados e APIs
Use HK somente quando um campo de formulário, API ou banco de dados esperar explicitamente o alfa-2 ISO 3166-1. Se a especificação disser alfa-3, use HKG. Se disser ISO numérico, use 344. Um serviço que aceita um formato pode rejeitar os outros ou interpretá-los incorretamente sem avisar.
Uma aplicação que troca vários formatos pode armazenar atributos separados ou usar uma tabela de consulta controlada. Um exemplo adequado para tradução é:
- country_alpha2: HK
- country_alpha3: HKG
- country_numeric: 344
Atributos separados tornam as transformações explícitas. Eles também impedem que um desenvolvedor coloque um valor de três letras em um campo de duas letras simplesmente porque ambos descrevem Hong Kong. Se um provedor usa um único campo chamado country, leia a documentação para determinar se ele aceita um código ISO, um nome de exibição ou outro identificador.
Use a capitalização e o tipo de dados definidos pelo serviço receptor. Os códigos alfabéticos ISO são geralmente exibidos em maiúsculas, mas uma API pode aplicar suas próprias regras de validação. O número 344 pode ser representado como texto ou inteiro. Uma tabela de consulta controlada deve registrar o tipo de código, a norma de origem, o formato aceito e qualquer informação de versão ou data de vigência necessária à integração.
Antes de enviar um valor de Hong Kong, confirme se o formulário ou a API externa espera o formato ISO alfa-2, alfa-3 ou numérico. Não deduza a representação necessária apenas pelas palavras código do país.
Pagamentos e relatórios financeiros
Os sistemas de pagamento e relatórios frequentemente precisam de informações geográficas e monetárias. Mantenha-as separadas: um cliente ou uma transação pode usar HK como valor de país alfa-2 ISO e HKD como valor monetário. Outro sistema pode solicitar HKG ou o valor numérico geográfico 344.
Por exemplo, um registro de transação poderia conter billing_country = HK, settlement_currency = HKD, e currency_amount = 500.00. Os nomes exatos dos campos e os códigos aceitos dependem do serviço de pagamento, banco, plataforma contábil ou especificação de relatórios.
O número 344 exige atenção especial quando conjuntos de dados de países, estatísticos e monetários são combinados. Mantenha a norma de origem no mapeamento, como ISO 3166-1 numérico geográfico ou ISO 4217 numérico monetário. Isso evita que um valor repetido crie uma correspondência semântica falsa e ajuda a explicar o resultado durante a reconciliação ou auditoria.
Mantendo separados os campos de telefone, domínio, país e moeda
Um perfil de conectividade de Hong Kong pode conter vários identificadores válidos ao mesmo tempo:
- iso_country_alpha2: HK
- iso_country_alpha3: HKG
- iso_country_numeric: 344
- telephone_calling_code: +852
- currency_code: HKD
- country_code_top_level_domain: .hk
Esses valores não são versões intercambiáveis de um único código. Eles dão suporte a tarefas diferentes: identificação de país, roteamento telefônico, processamento monetário e nomeação de domínios. Separá-los melhora a validação, a pesquisa, os rótulos da interface do usuário e a interoperabilidade de APIs.
Uma etapa final de validação deve verificar cada campo de acordo com a norma esperada pelo serviço receptor. Por exemplo, valide HK com uma regra de alfa-2 ISO, +852 com uma regra telefônica, HKD com uma regra monetária e .hk com uma regra de domínio. Essa abordagem campo a campo é mais confiável do que aplicar um único validador genérico de código de país a todos os valores.
Hong Kong, China e o contexto da nomenclatura oficial
Diferentes normas internacionais, organizações e provedores de software podem usar diferentes rótulos em inglês para a mesma entrada pretendida de Hong Kong. Um conjunto de dados pode mostrar Hong Kong, Hong Kong, China, ou uma formulação que identifica Hong Kong como uma Região Administrativa Especial da China.
Use o conjunto de códigos e o rótulo oficial em conjunto
As diferenças de nomenclatura devem ser interpretadas no contexto do sistema de origem. O rótulo informa como essa origem descreve a entrada, enquanto HK, HKG ou 344 identifica o valor e o formato do código usados nesse sistema. Uma variação de nome não transforma um código alfa-2 em alfa-3 e não torna um código geográfico um código monetário ou telefônico.
Ao combinar conjuntos de dados, preserve o rótulo de origem, o tipo de código e a regra de agregação. Isso é importante para bancos de dados de endereços, estatísticas, pagamentos, remessas e sistemas de relatórios. Não substitua a entrada de Hong Kong da origem por um rótulo genérico de país nem a combine automaticamente com outra entrada apenas porque o nome de exibição parece semelhante.
Para integrações atuais, os valores relevantes da ISO 3166-1 são HK, HKG, e 344. Um nome anterior ou código retirado deve ser usado somente quando um conjunto de dados histórico documentado exigir isso especificamente. Para formulários e APIs atuais comuns, use o formato solicitado pelo sistema e preserve o rótulo de origem quando os registros forem trocados.
Principais conclusões sobre os códigos ISO de Hong Kong
- HK é o código alfa-2 ISO 3166-1 de Hong Kong.
- HKG é o código alfa-3 ISO 3166-1 de Hong Kong e também aparece em dados esportivos olímpicos.
- 344 é o código numérico geográfico ISO 3166-1 de Hong Kong.
- +852 é o código de chamada telefônica internacional.
- HKD é o código monetário do dólar de Hong Kong.
- .hk e .香港 são domínios de primeiro nível com código de país de Hong Kong.
Escolha o valor de acordo com a norma documentada do campo, não pela expressão genérica código do país de Hong Kong. Manter os identificadores de país, telefone, moeda, esportes e domínio em campos separados facilita a validação e o intercâmbio preciso de dados de Hong Kong.
Selecionar área
Crie uma postagem
A postagem é gratuita e não é necessário registro.