Kody ISO Hongkongu: HK, HKG i 344 — wyjaśnienie

Wyszukiwanie kodu ISO Hongkongu może prowadzić do kilku różnych odpowiedzi, ponieważ systemy krajowe, telefoniczne, walutowe, sportowe i internetowe używają odrębnych identyfikatorów. Kody ISO 3166-1 Hongkongu to HK, HKG i 344. Ten przewodnik wyjaśnia znaczenie każdego formatu, dlaczego HKG może pojawiać się również w danych olimpijskich oraz jak odróżniać kody ISO od +852, HKD, .hk i .香港 w formularzach, oprogramowaniu i dokumentacji finansowej.

Kody ISO Hongkongu: szybka odpowiedź

Hongkong ma trzy reprezentacje ISO 3166-1: dwuliterowy kod alfa-2, trzyliterowy kod alfa-3 oraz kod numeryczny. Właściwa wartość zależy od pola lub systemu, do którego dane są przekazywane.

Trzy kody ISO 3166-1 w jednym zestawieniu

Dodatkowa lista krajów ISO z serwisu Docebo Help & Support również identyfikuje Hongkong za pomocą wartości alfa-2 HK. Międzynarodowy kod telefoniczny, kod waluty, kod olimpijski i domeny internetowe nie są dodatkowymi formatami ISO 3166-1. Należą do innych standardów lub organizacji.

Wyjaśnienie trzech kodów ISO 3166-1 Hongkongu

Trzy formaty ISO reprezentują ten sam wpis geograficzny na różne sposoby. Nie są wymienne w każdej aplikacji, dlatego dokumentacja systemu odbierającego powinna określać, którą wartość należy przesłać lub przechowywać.

Kod ISO alfa-2: HK

HK to dwuliterowy identyfikator ISO 3166-1 alfa-2 Hongkongu. Jest to zwięzła forma najczęściej wymagana, gdy ogólne pole kraju oczekuje wartości ISO alfa-2. Na przykład baza danych zaprojektowana zgodnie z tym standardem może przechowywać country_alpha2 = HK.

HK nie jest tym samym co międzynarodowy prefiks telefoniczny +852. Nie jest również identyczny z końcówką domeny .hk, mimo że litery są ze sobą powiązane. Pierwsza wartość jest kodem kraju ISO, druga służy do numeracji telefonicznej, a trzecia jest identyfikatorem DNS.

Używaj HK, gdy formularz, API lub specyfikacja danych wyraźnie wskazuje, że oczekuje ISO 3166-1 alfa-2. Nie zakładaj, że każde pole oznaczone jako kod kraju używa tego formatu. Niektóre usługi wymagają pełnej nazwy, wartości alfa-3, wartości numerycznej lub kodu właściwego dla danego dostawcy.

Kod ISO alfa-3: HKG

HKG to trzyliterowy kod ISO 3166-1 alfa-3 Hongkongu. Format trzyliterowy może być przydatny w międzynarodowych zestawach danych, w których preferowany jest dłuższy, łatwiej rozpoznawalny skrót albo interfejs wyraźnie wymaga wartości alfa-3.

Na przykład API może definiować osobne pola dla country_alpha2 i country_alpha3. W takiej sytuacji HK należy umieścić w pierwszym polu, a HKG w drugim. HKG nie powinien automatycznie zastępować HK w systemie, który sprawdza wyłącznie wartości dwuliterowe.

HKG jest również używany w kontekście olimpijskim. Zbieżność liter może ułatwiać wymianę danych, ale kod olimpijski i kod ISO są zarządzane przez różne organizacje. Podczas mapowania rekordów zachowaj nazwę pola lub standard źródłowy, aby znaczenie HKG pozostało jasne.

Kod ISO numeryczny: 344

344 to numeryczny kod ISO 3166-1 Hongkongu. Identyfikatory numeryczne są przydatne w systemach statystycznych, starszych bazach danych oraz interfejsach, które potrzebują wartości niezależnej od języka i pozbawionej skrótów literowych.

Pole o nazwie country_numeric lub iso_numeric może zatem zawierać 344, gdy jest zdefiniowane jako geograficzna wartość ISO 3166-1. To, czy aplikacja przechowuje tę wartość jako tekst czy liczbę, zależy od schematu dostawcy. Podczas wymiany danych zachowaj definicję pola i nazwę standardu.

Liczba 344 może występować również w innych systemach, w tym w danych walutowych. Nie oznacza to, że rekordy są wymienne. Porównując krajową wartość ISO z numeryczną wartością waluty, używaj określenia geograficzny kod numeryczny i przechowuj oba znaczenia w osobnych polach o określonym typie.

Czym inne identyfikatory Hongkongu różnią się od kodów ISO

Inne znane kody Hongkongu są przydatne, ale odpowiadają na inne pytania. System telefoniczny potrzebuje kodu kierunkowego, system płatności — kodu waluty, baza sportowa może potrzebować kodu olimpijskiego, a internet — etykiety domeny.

Międzynarodowy kod kierunkowy: +852

+852 to międzynarodowy kod telefoniczny Hongkongu. Należy do systemu numeracji telekomunikacyjnej, a nie do identyfikatorów krajów ISO 3166-1. Aplikacja telefoniczna może używać go do kierowania połączeniem lub wyświetlania numeru międzynarodowego, podczas gdy pole kraju w tym samym rekordzie klienta może używać HK.

Na przykład rekord połączenia może zawierać country_iso_alpha2 = HK oraz telephone_calling_code = +852. Wartości te opisują powiązane informacje o lokalizacji, ale nie powinny być przechowywane w jednym, nieokreślonym polu kodu kraju. Organizacja Office of the Communications Authority udostępnia informacje o planie numeracji Hongkongu do zastosowań telekomunikacyjnych.

Gdy formularz mówi o kodzie kraju Hongkongu, uważnie odczytaj etykiety sąsiednich pól. Jeśli pole dotyczy numeru telefonu, może być oczekiwane +852. Jeśli wskazuje ISO alfa-2, właściwą wartością jest HK. Przechowuj +852 w polu kodu telefonicznego, a nie w polu kodu kraju ISO.

Kod waluty: HKD

HKD to alfabetyczny kod ISO 4217 dolara hongkońskiego. Identyfikuje walutę, a nie lokalizację geograficzną. Z tego powodu HKD różni się zarówno od HK, jak i od HKG, mimo że wszystkie trzy wartości zawierają litery kojarzone z Hongkongiem.

Wartości w zamówieniu, fakturze lub dokumencie księgowym mogą być rozdzielone w następujący sposób:

• country_alpha2: HK
• currency: HKD
• amount: 1,250.00

Geograficzny kod numeryczny ISO to 344. Zestaw danych walutowych może również przypisywać 344 dolarowi hongkońskiemu jako numeryczny kod waluty. Powtarzająca się liczba może powodować błędy danych, zwłaszcza gdy tabele krajów i walut są automatycznie łączone. Przechowuj HKD i geograficzny kod numeryczny 344 w osobnych polach o określonym typie, nawet jeśli oba systemy używają liczby 344.

HKD nie jest zatem alternatywą dla kodu kraju ISO 3166-1. Używaj udokumentowanego pola waluty dostawcy finansowego dla HKD, a odpowiedniego pola geograficznego dla HK, HKG lub 344.

Kod olimpijski: HKG

Międzynarodowy Komitet Olimpijski używa wartości HKG w swoim systemie kodów sportowych dla Hongkongu. Jest to przydatne podczas odczytywania wyników olimpijskich, tabel medalowych, list drużyn lub kanałów sportowych korzystających ze skrótów MKOl.

Cheung Ka Long dokonuje NIESAMOWITEGO POWROTU na mistrzostwach świata

Wartość odpowiada kodowi ISO alfa-3 Hongkongu, ale nie oznacza to, że każdy kod sportowy jest kodem ISO. Znaczenie wynika z zestawu danych i organizacji, która go definiuje. Ogólna baza krajów może interpretować HKG jako ISO 3166-1 alfa-3, podczas gdy plik wyników olimpijskich może interpretować go jako kod sportowy MKOl.

Podczas mapowania danych sportowych do ogólnej bazy krajów zachowaj nazwę systemu źródłowego lub standardu. Traktuj zgodność wartości jako udogodnienie interoperacyjności, a nie dowód, że oba systemy kodów są identyczne.

Domeny internetowe: .hk i .香港

.hk to domena najwyższego poziomu z kodem kraju Hongkongu zapisana alfabetem łacińskim. Jest używana w DNS i adresach internetowych, a nie jako wartość pola kraju ISO. Jej związek z wartością ISO alfa-2 HK pomaga wskazać terytorium reprezentowane przez domenę, ale oba identyfikatory nadal służą różnym celom technicznym.

Zmiana DNS dla domen HKDNR (.com.hk I .hk)

.香港 to umiędzynarodowiona domena najwyższego poziomu z kodem kraju zapisana pismem chińskim, reprezentująca Hongkong. Raport delegacji IANA dokumentuje jej delegowanie na rzecz Hong Kong Internet Registration Corporation Limited.

Dane delegacji IANA dla .hk wskazują Hong Kong Internet Registration Corporation jako zarządcę domeny najwyższego poziomu z kodem kraju. W praktyce rejestracja domen i walidacja DNS mogą podlegać zasadom odrębnym od walidacji kodów krajów ISO.

W oprogramowaniu domenowym .香港 jest etykietą umiędzynarodowioną. Przeglądarka lub biblioteka DNS może wyświetlać użytkownikowi chińską formę, przetwarzając wewnętrznie reprezentację zgodną z ASCII. Używaj formatu wymaganego przez konkretne API domeny. Przed wdrożeniem zasad walidacji lub rejestracji dla .hk lub .香港 sprawdź aktualne informacje IANA oraz bieżące wymagania Hong Kong Internet Registration Corporation.

Używanie kodów Hongkongu w formularzach, oprogramowaniu i danych

Błędy kodów zwykle pojawiają się wtedy, gdy pole ma zbyt ogólną nazwę. Niezawodna integracja najpierw identyfikuje standard i format, a następnie sprawdza wartość względem tej definicji.

Formularze, bazy danych i API

Używaj HK tylko wtedy, gdy formularz, API lub pole bazy danych wyraźnie oczekuje ISO 3166-1 alfa-2. Jeśli specyfikacja wskazuje alfa-3, użyj HKG. Jeśli wskazuje ISO numeryczny, użyj 344. Usługa akceptująca jeden format może odrzucić pozostałe albo błędnie je zinterpretować.

Demo | Witaj, odwołanie krzyżowe — część 1

Aplikacja wymieniająca kilka formatów może przechowywać osobne atrybuty lub używać kontrolowanej tabeli odnośników. Przykład przyjazny tłumaczeniom:

• country_alpha2: HK
• country_alpha3: HKG
• country_numeric: 344

Osobne atrybuty sprawiają, że transformacje są jednoznaczne. Zapobiegają również umieszczeniu przez programistę wartości trzyliterowej w polu dwuliterowym tylko dlatego, że obie opisują Hongkong. Jeśli dostawca używa pojedynczego pola o nazwie country, zapoznaj się z jego dokumentacją, aby ustalić, czy akceptuje kod ISO, nazwę wyświetlaną czy inny identyfikator.

Używaj wielkości liter i typu danych określonych przez usługę odbierającą. Alfabetyczne kody ISO są zwykle zapisywane wielkimi literami, ale API może stosować własne reguły walidacji. Wartość numeryczna 344 może być reprezentowana jako tekst lub liczba całkowita. Kontrolowana tabela odnośników powinna rejestrować typ kodu, standard źródłowy, akceptowany format oraz informacje o wersji lub dacie obowiązywania potrzebne integracji.

Przed przesłaniem wartości dotyczącej Hongkongu potwierdź, czy zewnętrzny formularz lub API oczekuje formatu ISO alfa-2, alfa-3 czy numerycznego. Nie wyciągaj wniosków o wymaganej reprezentacji wyłącznie z określenia „kod kraju”.

Płatności i sprawozdawczość finansowa

Systemy płatności i raportowania często potrzebują zarówno informacji geograficznych, jak i monetarnych. Trzymaj je oddzielnie: klient lub transakcja może używać HK jako wartości kraju ISO alfa-2 oraz HKD jako wartości waluty. Inny system może zamiast tego wymagać HKG lub geograficznego kodu numerycznego 344.

Na przykład rekord transakcji może zawierać billing_country = HK, settlement_currency = HKD, oraz currency_amount = 500.00. Dokładne nazwy pól i akceptowane kody zależą od usługi płatniczej, banku, platformy księgowej lub specyfikacji raportowania.

Wartość numeryczna 344 wymaga szczególnej ostrożności podczas łączenia zestawów danych krajowych, statystycznych i walutowych. Zachowaj w mapowaniu standard źródłowy, na przykład ISO 3166-1 geograficzny kod numeryczny lub ISO 4217 numeryczny kod waluty. Zapobiega to powstaniu fałszywej zgodności semantycznej wskutek powtarzającej się wartości i ułatwia wyjaśnienie wyniku podczas uzgadniania lub audytu.

Rozdzielanie pól telefonu, domeny, kraju i waluty

Profil łączności dla Hongkongu może jednocześnie zawierać kilka prawidłowych identyfikatorów:

Projekt Node.js do pobierania listy wszystkich krajów, stanów i miast na świecie z wiersza poleceń w JavaScript

• 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

Wartości te nie są wymiennymi wersjami jednego kodu. Obsługują różne zadania: identyfikację kraju, routing telefoniczny, przetwarzanie wartości pieniężnych i nazewnictwo domen. Ich rozdzielenie usprawnia walidację, wyszukiwanie, etykiety interfejsu użytkownika i interoperacyjność API.

Końcowy etap walidacji powinien sprawdzać każde pole względem standardu oczekiwanego przez usługę odbierającą. Na przykład HK należy sprawdzać regułą ISO alfa-2, +852 regułą telefoniczną, HKD regułą walutową, a .hk regułą domenową. Takie podejście pole po polu jest bardziej niezawodne niż stosowanie jednego ogólnego walidatora kodów kraju do każdej wartości.

Hongkong, Chiny i kontekst oficjalnego nazewnictwa

Różne standardy międzynarodowe, organizacje i dostawcy oprogramowania mogą używać odmiennych angielskich etykiet dla tego samego zamierzonego wpisu Hongkongu. Zestaw danych może wyświetlać Hong Kong, Hong Kong, China, albo sformułowanie wskazujące Hongkong jako Specjalny Region Administracyjny Chin.

Używaj zestawu kodów i oficjalnej etykiety razem

Różnice w nazwach należy interpretować w kontekście systemu źródłowego. Etykieta informuje, jak źródło opisuje wpis, natomiast HK, HKG lub 344 wskazuje wartość kodu i format używany w tym systemie. Różnica w nazwie nie zmienia kodu alfa-2 w alfa-3 ani nie czyni kodu geograficznego kodem waluty lub telefonu.

Podczas łączenia zestawów danych zachowaj etykietę źródłową, typ kodu i regułę agregacji. Jest to ważne dla baz adresowych, statystyk, płatności, wysyłki i systemów raportowania. Nie zastępuj wpisu Hongkongu ze źródła ogólną etykietą kraju ani nie łącz go automatycznie z innym wpisem tylko dlatego, że nazwa wyświetlana wygląda podobnie.

W bieżących integracjach odpowiednie wartości ISO 3166-1 to HK, HKG, oraz 344. Dawna nazwa lub wycofany kod powinny być używane tylko wtedy, gdy wymaga tego udokumentowany historyczny zestaw danych. W zwykłych formularzach i API używaj formatu żądanego przez system oraz zachowuj etykietę źródłową podczas wymiany rekordów.

Najważniejsze informacje o kodach ISO Hongkongu

• HK to kod ISO 3166-1 alfa-2 Hongkongu.
• HKG to kod ISO 3166-1 alfa-3 Hongkongu, występujący również w olimpijskich danych sportowych.
• 344 to geograficzny kod numeryczny ISO 3166-1 Hongkongu.
• +852 to międzynarodowy kod telefoniczny.
• HKD to kod waluty dolara hongkońskiego.
• .hk i .香港 to domeny najwyższego poziomu z kodem kraju Hongkongu.

Wybieraj wartość zgodnie z udokumentowanym standardem pola, a nie na podstawie ogólnego określenia „kod kraju Hongkongu”. Przechowywanie identyfikatorów kraju, telefonu, waluty, sportu i domeny w osobnych polach ułatwia dokładną walidację i wymianę danych dotyczących Hongkongu.