Коды 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 от 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 помогает определить территорию, представленную доменом, однако эти два идентификатора по-прежнему выполняют разные технические функции.

Изменение DNS для доменов HKDNR (.com.hk и .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. Сервис, принимающий один формат, может отклонить остальные или незаметно интерпретировать их неправильно.

Демонстрация | Привет, перекрёстная ссылка — часть 1

Приложение, обменивающееся несколькими форматами, может хранить отдельные атрибуты или использовать контролируемую таблицу соответствий. Пример, удобный для перевода:

• 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 или цифровое значение валюты ISO 4217. Это предотвращает ложное смысловое совпадение повторяющегося значения и помогает объяснить результат при сверке или аудите.

Разделяйте поля телефона, домена, страны и валюты

Профиль подключения для Гонконга может одновременно содержать несколько корректных идентификаторов:

Проект на Node.js для получения списка всех стран, штатов и городов мира в командной строке на 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

Эти значения не являются взаимозаменяемыми версиями одного кода. Они поддерживают разные задачи: идентификацию страны, телефонную маршрутизацию, денежные операции и именование доменов. Их разделение улучшает проверку, поиск, подписи элементов интерфейса и совместимость 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 и .香港 — домены верхнего уровня Гонконга с национальным кодом.

Выбирайте значение по документированному стандарту поля, а не по общей фразе «код страны Гонконга». Хранение идентификаторов страны, телефона, валюты, спорта и домена в отдельных полях упрощает точную проверку и обмен данными о Гонконге.