Коди ISO для Гонконгу: пояснення HK, HKG і 344
Пошук коду ISO для Гонконгу може дати кілька різних відповідей, оскільки в системах країн, телефонії, валют, спорту та інтернету використовуються окремі ідентифікатори. Коди Гонконгу за ISO 3166-1 — HK, HKG і 344. У цьому посібнику пояснюється значення кожного формату, чому HKG також може з’являтися в олімпійських даних і як не плутати коди ISO з +852, HKD, .hk та .香港 у формах, програмному забезпеченні й фінансових записах.
Коди ISO для Гонконгу: коротка відповідь
Гонконг має три представлення за ISO 3166-1: дволітерний код alpha-2, трилітерний код alpha-3 і числовий код. Правильне значення залежить від поля або системи, яка отримує дані.
Три коди ISO 3166-1 одним поглядом
| Тип коду ISO | Значення для Гонконгу | Типове призначення |
|---|---|---|
| Alpha-2 | HK | Короткі поля країни та загальний обмін даними |
| Alpha-3 | HKG | Трилітерні набори даних країн і деякі спортивні дані |
| Числовий | 344 | Статистичні, застарілі та системи лише з числовими значеннями |
Вторинний список країн ISO від Довідка та підтримка Docebo також визначає Гонконг за дволітерним значенням HK. Телефонний код, код валюти, олімпійський код і інтернет-домени не є додатковими форматами ISO 3166-1. Вони належать до інших стандартів або організацій.
Пояснення трьох кодів ISO 3166-1 для Гонконгу
Три формати ISO по-різному представляють один і той самий географічний запис. Вони не є взаємозамінними в кожному застосуванні, тому документація системи-одержувача має визначати, яке значення потрібно передати або зберігати.
Код ISO alpha-2: HK
HK — це дволітерний ідентифікатор Гонконгу за ISO 3166-1 alpha-2. Це компактна форма, яку найчастіше запитують, коли загальне поле країни очікує значення ISO alpha-2. Наприклад, база даних, розроблена для цього стандарту, може зберігати country_alpha2 = HK.
HK — це не те саме, що міжнародний телефонний префікс +852. Він також не є ідентичним доменному закінченню .hk, хоча літери пов’язані між собою. Перше є значенням країни ISO, друге використовується в телефонній нумерації, а третє — ідентифікатором DNS.
Використовуйте HK, коли у формі, API або специфікації даних чітко зазначено, що очікується ISO 3166-1 alpha-2. Не припускайте, що кожне поле з назвою «код країни» використовує саме цей формат. Деякі сервіси вимагають повну назву, значення alpha-3, числове значення або специфічний код постачальника.
Код ISO alpha-3: HKG
HKG — це трилітерний код Гонконгу за ISO 3166-1 alpha-3. Трилітерний формат може бути корисним у міжнародних наборах даних, де надається перевага довшому й зрозумілішому скороченню або де інтерфейс прямо вимагає значень alpha-3.
Наприклад, API може визначати окремі поля для country_alpha2 і country_alpha3. У такій ситуації HK належить до першого поля, а HKG — до другого. Не слід автоматично замінювати HK на HKG у системі, яка перевіряє лише дволітерні значення.
HKG також використовується в олімпійському контексті. Збіг літер може спростити обмін даними, але олімпійський код і код ISO регулюються різними організаціями. Під час зіставлення записів зберігайте назву поля або вихідний стандарт, щоб значення HKG залишалося зрозумілим.
Числовий код ISO: 344
344 — це числовий код Гонконгу за ISO 3166-1. Числові ідентифікатори корисні для статистичних систем, старих баз даних та інтерфейсів, яким потрібне незалежне від мови значення без літерних скорочень.
Поле з назвою country_numeric або iso_numeric може, відповідно, містити 344, якщо воно визначене як географічне значення ISO 3166-1. Чи зберігає застосунок це значення як текст або число, залежить від схеми постачальника. Під час обміну даними зберігайте визначення поля та назву стандарту.
Число 344 також може траплятися в інших системах, зокрема у валютних даних. Це не робить записи взаємозамінними. Використовуйте вислів географічний числовий код під час порівняння значення країни ISO з числовим значенням валюти та зберігайте обидва значення в окремих типізованих полях.
Чим інші ідентифікатори Гонконгу відрізняються від кодів ISO
Інші звичні коди Гонконгу корисні, але відповідають на різні запитання. Телефонній системі потрібен код виклику, платіжній системі — код валюти, спортивній базі даних може знадобитися олімпійський код, а інтернету — доменна мітка.
Міжнародний код виклику: +852
+852 — це міжнародний телефонний код виклику Гонконгу. Він є частиною телекомунікаційної системи нумерації, а не ідентифікатором країни за ISO 3166-1. Телефонний застосунок може використовувати його для маршрутизації або відображення міжнародного номера, тоді як поле країни в тому самому записі клієнта може використовувати HK.
Наприклад, запис підключення може містити country_iso_alpha2 = HK і telephone_calling_code = +852. Ці значення описують пов’язану інформацію про місцезнаходження, але їх не слід зберігати в одному невизначеному полі коду країни. Організація Управління комунікаційної адміністрації надає інформацію про план нумерації Гонконгу для телекомунікаційного використання.
Коли у формі зазначено «код країни Гонконгу», уважно прочитайте назви сусідніх полів. Якщо поле належить до номера телефону, очікуваним може бути +852. Якщо зазначено ISO alpha-2, потрібним значенням є HK. Зберігайте +852 у полі телефонного коду виклику, а не в полі коду країни ISO.
Код валюти: HKD
HKD — це літерний код гонконгського долара за ISO 4217. Він ідентифікує валюту, а не географічне місце. Тому HKD відрізняється і від HK, і від HKG, хоча всі три містять літери, пов’язані з Гонконгом.
Замовлення, рахунок-фактура або бухгалтерський запис можуть розділяти значення таким чином:
- country_alpha2: HK
- currency: HKD
- amount: 1,250.00
Географічний числовий код ISO — 344. Набір валютних даних також може пов’язувати 344 із гонконгським доларом як числовим кодом валюти. Повторення числа може спричиняти помилки в даних, особливо коли таблиці країн і валют автоматично об’єднуються. Зберігайте HKD і географічний числовий код 344 в окремих типізованих полях, навіть якщо обидві системи використовують число 344.
Отже, HKD не є альтернативою коду країни за ISO 3166-1. Використовуйте задокументоване постачальником фінансове поле валюти для HKD, а відповідне географічне поле — для HK, HKG або 344.
Олімпійський код: HKG
Міжнародний олімпійський комітет використовує HKG у своїй системі спортивних кодів для Гонконгу. Це корисно під час читання олімпійських результатів, таблиць медалей, списків команд або спортивних каналів даних, що використовують скорочення МОК.
Значення збігається з кодом Гонконгу ISO alpha-3, але це не означає, що кожен спортивний код є кодом ISO. Значення визначається набором даних та організацією, яка його встановлює. Загальна база країн може трактувати HKG як ISO 3166-1 alpha-3, тоді як файл олімпійських результатів — як спортивний код МОК.
Під час перенесення спортивних даних до загальної бази країн зберігайте назву вихідної системи або стандарту. Розглядайте збіг значень як зручність сумісності, а не як доказ ідентичності двох систем кодів.
Інтернет-домени: .hk і .香港
.hk — це домен верхнього рівня з кодом країни Гонконгу в латинському написанні. Він використовується в DNS та інтернет-адресах, а не як значення поля країни ISO. Його зв’язок зі значенням ISO alpha-2 HK допомагає визначити територію, яку представляє домен, але ці два ідентифікатори все одно мають різне технічне призначення.
.香港 — це інтернаціоналізований домен верхнього рівня з кодом країни в китайському написанні, що представляє Гонконг. Звіт про делегування від IANA документує його делегування Hong Kong Internet Registration Corporation Limited.
Дані делегування IANA для .hk визначають Hong Kong Internet Registration Corporation як адміністратора домену верхнього рівня з кодом країни. На практиці реєстрація доменів і перевірка DNS можуть регулюватися правилами, окремими від перевірки кодів країн ISO.
У доменному програмному забезпеченні .香港 є інтернаціоналізованою міткою. Браузер або бібліотека DNS може відображати видиму для користувача форму китайськими ієрогліфами, обробляючи всередині ASCII-сумісне представлення. Використовуйте формат, потрібний конкретному доменному API. Перед реалізацією правил перевірки або реєстрації для .hk чи .香港 перевірте актуальну інформацію IANA та поточні вимоги Hong Kong Internet Registration Corporation.
Використання кодів Гонконгу у формах, програмному забезпеченні та даних
Помилки кодів зазвичай виникають, коли поле має надто загальну назву. Надійна інтеграція спочатку визначає стандарт і формат, а потім перевіряє значення відповідно до цього визначення.
Форми, бази даних і API
Використовуйте HK лише тоді, коли у формі, API або полі бази даних прямо зазначено очікування ISO 3166-1 alpha-2. Якщо специфікація вимагає alpha-3, використовуйте HKG. Якщо зазначено ISO numeric, використовуйте 344. Сервіс, який приймає один формат, може відхилити інші або неправильно інтерпретувати їх без повідомлення.
Застосунок, що обмінюється кількома форматами, може зберігати окремі атрибути або використовувати контрольовану таблицю відповідностей. Приклад, зручний для перекладу:
- country_alpha2: HK
- country_alpha3: HKG
- country_numeric: 344
Окремі атрибути роблять перетворення явними. Вони також не дають розробнику помістити трилітерне значення у дволітерне поле лише тому, що обидва описують Гонконг. Якщо постачальник використовує єдине поле під назвою country, прочитайте його документацію, щоб визначити, чи приймає воно код ISO, відображувану назву або інший ідентифікатор.
Використовуйте регістр і тип даних, визначені сервісом-одержувачем. Літерні коди ISO зазвичай подаються у верхньому регістрі, але API може застосовувати власні правила перевірки. Число 344 може представлятися як текст або ціле число. Контрольована таблиця відповідностей має містити тип коду, вихідний стандарт, прийнятний формат і відомості про версію або дату набуття чинності, потрібні для інтеграції.
Перед передаванням значення Гонконгу підтвердьте, чи очікує зовнішня форма або API формат ISO alpha-2, alpha-3 чи numeric. Не визначайте потрібне представлення лише за словами «код країни».
Платежі та фінансова звітність
Платіжним і звітним системам часто потрібні як географічні, так і грошові дані. Зберігайте їх окремо: клієнт або транзакція можуть використовувати HK як значення країни ISO alpha-2 і HKD як значення валюти. Інша система натомість може вимагати HKG або географічне число 344.
Наприклад, запис транзакції може містити billing_country = HK, settlement_currency = HKD, а також currency_amount = 500.00. Точні назви полів і прийнятні коди залежать від платіжного сервісу, банку, бухгалтерської платформи або специфікації звітності.
Число 344 потребує особливої уваги, коли об’єднуються країнові, статистичні та валютні набори даних. Зберігайте вихідний стандарт у відповідності, наприклад ISO 3166-1 geographic numeric або ISO 4217 currency numeric. Це запобігає хибному семантичному збігу повторюваного значення та допомагає пояснити результат під час звірки або аудиту.
Розділяйте поля телефону, домену, країни та валюти
Профіль підключення для Гонконгу може одночасно містити кілька дійсних ідентифікаторів:
- 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
Ці значення не є взаємозамінними версіями одного коду. Вони підтримують різні завдання: ідентифікацію країни, телефонну маршрутизацію, обробку грошових операцій і найменування доменів. Їх розділення покращує перевірку, пошук, підписи інтерфейсу користувача та сумісність API.
Остаточний етап перевірки має зіставляти кожне поле зі стандартом, якого очікує сервіс-одержувач. Наприклад, перевіряйте HK за правилом ISO alpha-2, +852 — за телефонним правилом, HKD — за валютним, а .hk — за доменним. Такий підхід до кожного поля надійніший, ніж застосування одного універсального перевіряльника кодів країн до всіх значень.
Гонконг, Китай і контекст офіційних назв
Різні міжнародні стандарти, організації та постачальники програмного забезпечення можуть використовувати різні англійські назви для одного й того самого запису Гонконгу. Набір даних може містити Гонконг, Гонконг, Китай, або формулювання, яке визначає Гонконг як спеціальний адміністративний район Китаю.
Використовуйте набір кодів разом з офіційною назвою
Відмінності в назвах слід тлумачити в контексті вихідної системи. Назва показує, як ця система описує запис, тоді як HK, HKG або 344 визначає значення коду та формат, використаний у системі. Варіант назви не перетворює код alpha-2 на alpha-3 і не робить географічний код валютним або телефонним.
Під час об’єднання наборів даних зберігайте вихідну назву, тип коду та правило агрегації. Це важливо для баз адрес, статистики, платежів, доставки та звітних систем. Не замінюйте запис Гонконгу у джерелі загальною назвою країни й не об’єднуйте його автоматично з іншим записом лише тому, що назва для відображення здається схожою.
Для поточних інтеграцій відповідні значення ISO 3166-1 — це HK, HKG, і 344. Колишню назву або вилучений код слід використовувати лише тоді, коли цього прямо вимагає задокументований історичний набір даних. Для звичайних поточних форм і API використовуйте формат, запитаний системою, та зберігайте вихідну назву під час обміну записами.
Основні висновки щодо кодів ISO Гонконгу
- HK — це код Гонконгу ISO 3166-1 alpha-2.
- HKG — це код Гонконгу ISO 3166-1 alpha-3, який також використовується в олімпійських спортивних даних.
- 344 — це географічний числовий код Гонконгу за ISO 3166-1.
- +852 — це міжнародний телефонний код виклику.
- HKD — це код валюти гонконгського долара.
- .hk і .香港 — це домени верхнього рівня Гонконгу з кодом країни.
Обирайте значення за задокументованим стандартом поля, а не за загальною фразою «код країни Гонконгу». Зберігання ідентифікаторів країни, телефону, валюти, спорту та домену в окремих полях полегшує точну перевірку й обмін даними Гонконгу.
Виберіть область
Створіть допис
Публікація безкоштовна, реєстрація не потрібна.