Hongkong ISO-koder: HK, HKG och 344 förklarade

Att söka efter Hongkongs ISO-kod kan ge flera olika svar eftersom länder, telefoni, valutor, idrott och internet använder separata identifierare. Hongkongs ISO 3166-1-koder är HK, HKG och 344. Den här guiden förklarar vad varje format betyder, varför HKG också kan förekomma i olympiska data och hur man håller isär ISO-koder från +852, HKD, .hk och .香港 i formulär, programvara och ekonomiska register.

Hongkong ISO-koder: snabbt svar

Hongkong har tre ISO 3166-1-representationer: en tvåbokstavskod alpha-2, en trebokstavskod alpha-3 och en numerisk kod. Det korrekta värdet beror på vilket fält eller system som tar emot uppgifterna.

De tre ISO 3166-1-koderna i en översikt

En alternativ ISO-landlista från Docebo Help & Support identifierar också Hongkong med alpha-2-värdet HK. Den internationella telefonkoden, valutakoden, den olympiska koden och internetdomänerna är inte ytterligare ISO 3166-1-format. De tillhör andra standarder eller organisationer.

De tre ISO 3166-1-koderna för Hongkong förklarade

De tre ISO-formaten representerar samma geografiska post på olika sätt. De kan inte bytas mot varandra i alla tillämpningar, så det mottagande systemets dokumentation bör avgöra vilket värde du skickar eller lagrar.

ISO alpha-2-koden: HK

HK är Hongkongs tvåbokstavsidentifierare enligt ISO 3166-1 alpha-2. Det är det kompakta format som oftast efterfrågas när ett allmänt landsfält ber om ett ISO alpha-2-värde. En databas som är utformad för denna standard kan till exempel lagra country_alpha2 = HK.

HK är inte samma sak som det internationella telefonprefixet +852. Det är inte heller identiskt med domänsuffixet .hk, även om bokstäverna hänger samman. Det första är ett ISO-landsvärde, det andra används i telefonnumrering och det tredje är en DNS-identifierare.

Använd HK när formuläret, API:et eller datainstruktionen tydligt anger att ISO 3166-1 alpha-2 förväntas. Utgå inte från att varje fält som heter landskod använder detta format. Vissa tjänster kräver ett fullständigt namn, ett alpha-3-värde, ett numeriskt värde eller en leverantörsspecifik kod.

ISO alpha-3-koden: HKG

HKG är Hongkongs trebokstavskod enligt ISO 3166-1 alpha-3. Ett trebokstavsformat kan vara användbart i internationella datauppsättningar där en längre och mer igenkännbar förkortning föredras eller där gränssnittet uttryckligen kräver alpha-3-värden.

Ett API kan till exempel definiera separata fält för country_alpha2 och country_alpha3. I så fall hör HK hemma i det första fältet och HKG i det andra. HKG ska inte automatiskt ersätta HK i ett system som endast validerar tvåbokstavsvärden.

HKG används också i olympiska sammanhang. De överensstämmande bokstäverna kan underlätta datautbyte, men en olympisk kod och en ISO-kod styrs av olika organisationer. När du mappar poster bör du behålla fältnamnet eller källstandarden så att betydelsen av HKG förblir tydlig.

Den numeriska ISO-koden: 344

344 är Hongkongs numeriska kod enligt ISO 3166-1. Numeriska identifierare är användbara i statistiska system, äldre databaser och gränssnitt som behöver ett språkneutralt värde utan alfabetiska förkortningar.

Ett fält med namnet country_numeric eller iso_numeric kan därför innehålla 344 när det definieras som ett geografiskt ISO 3166-1-värde. Om programmet lagrar värdet som text eller som ett tal beror på leverantörens schema. Bevara fältdefinitionen och standardnamnet vid datautbyte.

Talet 344 kan också förekomma i andra system, bland annat valutadata. Det gör inte posterna utbytbara. Använd uttrycket geografisk numerisk kod när ISO-landsvärdet jämförs med ett numeriskt valutavärde, och håll de båda betydelserna i separata typade fält.

Så skiljer sig andra Hongkong-identifierare från ISO-koder

Hongkongs andra välkända koder är användbara, men de besvarar andra frågor. Ett telefonsystem behöver en landskod för samtal, ett betalningssystem behöver en valutakod, en idrottsdatabas kan behöva en olympisk kod och internet behöver en domänetikett.

Den internationella landskoden för samtal: +852

+852 är Hongkongs internationella telefonkod. Den ingår i telekommunikationens numreringssystem och är inte en ISO 3166-1-landsidentifierare. En telefonapplikation kan använda den för att dirigera eller visa ett internationellt nummer, medan ett landsfält i samma kundpost kan använda HK.

En anslutningspost kan till exempel innehålla country_iso_alpha2 = HK och telephone_calling_code = +852. Dessa värden beskriver relaterad platsinformation, men bör inte lagras i ett enda odifferentierat landskodfält. Den Office of the Communications Authority tillhandahåller information om Hongkongs nummerplan för telekommunikationsändamål.

När ett formulär anger Hongkongs landskod bör du läsa de omgivande fältetiketterna noggrant. Om fältet hör till ett telefonnummer kan +852 förväntas. Om det står ISO alpha-2 är HK det relevanta värdet. Lagra +852 i ett telefonkodfält och inte i ett ISO-landskodfält.

Valutakoden: HKD

HKD är den alfabetiska ISO 4217-koden för Hongkongdollarn. Den identifierar en valuta, inte en geografisk plats. Därför skiljer sig HKD från både HK och HKG, även om alla tre innehåller bokstäver som förknippas med Hongkong.

Ett kassasystem, en faktura eller en bokföringspost kan separera värdena på följande sätt:

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

Den geografiska numeriska ISO-koden är 344. En valuta datauppsättning kan också koppla 344 till Hongkongdollarn som numerisk valutakod. Det upprepade talet kan orsaka datafel, särskilt när lands- och valutatabeller automatiskt kopplas samman. Håll HKD och den geografiska numeriska koden 344 i separata typade fält även när båda systemen använder talet 344.

HKD är alltså inte ett alternativ till en ISO 3166-1-landskod. Använd den finansiella leverantörens dokumenterade valutafält för HKD och det relevanta geografiska fältet för HK, HKG eller 344.

Den olympiska koden: HKG

Internationella olympiska kommittén använder HKG i sitt idrottskodsystem för Hongkong. Det är användbart när man läser olympiska resultat, medaljtabeller, laglistor eller idrottsflöden som använder IOK-förkortningar.

Cheung Ka Long gör en OTROLIG comeback i världsmästerskapet

Värdet överensstämmer med Hongkongs ISO alpha-3-kod, men det betyder inte att varje idrottskod är en ISO-kod. Betydelsen kommer från datauppsättningen och organisationen som definierar den. En allmän landsdatabas kan tolka HKG som ISO 3166-1 alpha-3, medan en fil med olympiska resultat kan tolka det som en IOK-idrottskod.

När idrottsdata mappas till en allmän landsdatabas bör du behålla källsystemet eller standardnamnet. Se det överensstämmande värdet som en praktisk interoperabilitetslösning, inte som ett bevis på att de två kodsystemen är identiska.

Internetdomänerna: .hk och .香港

.hk är Hongkongs landskodstoppdomän med latinska tecken. Den används i DNS och internetadresser, inte som värde i ett ISO-landfält. Dess relation till ISO alpha-2-värdet HK hjälper till att identifiera det område som domänen representerar, men de två identifierarna har fortfarande olika tekniska funktioner.

Ändra DNS för HKDNR-domäner (.com.hk och .hk)

.香港 .香港 är den internationaliserade landskodstoppdomänen med kinesiska tecken som representerar Hongkong. Delegeringsrapporten från IANA dokumenterar delegeringen till Hong Kong Internet Registration Corporation Limited.

IANA:s IANA delegeringsdata för .hk identifierar Hong Kong Internet Registration Corporation som ansvarig för landskodstoppdomänen. I praktiken kan domänregistrering och DNS-validering omfattas av regler som skiljer sig från validering av ISO-landskoder.

I domänprogramvara är .香港 en internationaliserad etikett. En webbläsare eller ett DNS-bibliotek kan visa den användarsynliga formen med kinesiska tecken samtidigt som den internt behandlar en ASCII-kompatibel representation. Använd det format som krävs av det specifika domän-API:et. Innan du implementerar validerings- eller registreringsregler för .hk eller .香港 bör du kontrollera aktuell IANA-information och Hong Kong Internet Registration Corporations aktuella krav.

Använda Hongkong-koder i formulär, programvara och data

Kodfel uppstår vanligtvis när ett fält har fått ett alltför brett namn. En tillförlitlig integration identifierar först standarden och formatet och validerar sedan värdet mot den definitionen.

Formulär, databaser och API:er

Använd HK endast när ett formulär-, API- eller databasfält uttryckligen förväntar sig ISO 3166-1 alpha-2. Om specifikationen anger alpha-3 använder du HKG. Om den anger ISO numerisk använder du 344. En tjänst som accepterar ett format kan avvisa de andra eller tolka dem felaktigt utan att meddela det.

Demo | Hej korsreferens – del 1

En applikation som utbyter flera format kan lagra separata attribut eller använda en kontrollerad uppslagstabell. Ett översättningsvänligt exempel är:

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

Separata attribut gör omvandlingar tydliga. De hindrar också en utvecklare från att placera ett trebokstavsvärde i ett tvåbokstavsfält bara för att båda beskriver Hongkong. Om en leverantör använder ett enda fält som heter country bör du läsa dokumentationen för att avgöra om den accepterar en ISO-kod, ett visningsnamn eller någon annan identifierare.

Använd den versalisering och datatyp som definieras av den mottagande tjänsten. Alfabetiska ISO-koder visas vanligtvis med versaler, men ett API kan ha egna valideringsregler. Numeriska 344 kan representeras som text eller som ett heltal. En kontrollerad uppslagstabell bör registrera kodtyp, källstandard, accepterat format samt eventuell versions- eller giltighetsinformation som behövs för integrationen.

Innan du skickar ett Hongkong-värde bör du bekräfta om det externa formuläret eller API:et förväntar sig ISO alpha-2, alpha-3 eller numeriskt format. Dra inte slutsatsen om den nödvändiga representationen enbart från orden landskod.

Betalningar och finansiell rapportering

Betalnings- och rapporteringssystem behöver ofta både geografisk och monetär information. Håll dem åtskilda: en kund eller transaktion kan använda HK som geografiskt ISO alpha-2-värde och HKD som valutavärde. Ett annat system kan i stället begära HKG eller det geografiska numeriska värdet 344.

En transaktionspost kan till exempel innehålla billing_country = HK, settlement_currency = HKD, och currency_amount = 500.00. De exakta fältnamnen och accepterade koderna beror på betaltjänsten, banken, bokföringsplattformen eller rapporteringsspecifikationen.

Numeriska 344 kräver särskild omsorg när geografiska, statistiska och monetära datauppsättningar kombineras. Behåll den ursprungliga standarden i mappningen, exempelvis geografiskt numeriskt ISO 3166-1-värde eller numeriskt ISO 4217-valutavärde. Det hindrar ett upprepat värde från att skapa en falsk semantisk matchning och gör det lättare att förklara resultatet vid avstämning eller revision.

Håll telefon-, domän-, lands- och valutafält åtskilda

En anslutningsprofil för Hongkong kan innehålla flera giltiga identifierare samtidigt:

Node.js-projekt för att hämta en lista över alla länder, delstater och städer i världen via kommandoraden i 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

Dessa värden är inte utbytbara versioner av en enda kod. De stöder olika uppgifter: landsidentifiering, telefonrouting, monetär behandling och domännamngivning. Att separera dem förbättrar validering, sökning, användargränssnittets etiketter och API-interoperabilitet.

Ett sista valideringssteg bör kontrollera varje fält mot den standard som den mottagande tjänsten förväntar sig. Validera exempelvis HK med en ISO alpha-2-regel, +852 med en telefonregel, HKD med en valutaregel och .hk med en domänregel. Detta fältvisa tillvägagångssätt är tillförlitligare än att tillämpa en generell landskodvalidator på alla värden.

Hongkong, Kina och officiell namnkontext

Olika internationella standarder, organisationer och programvaruleverantörer kan använda olika engelska etiketter för samma avsedda Hongkong-post. En datauppsättning kan visa Hongkong, Hongkong, Kina, eller en formulering som identifierar Hongkong som en särskild administrativ region i Kina.

Använd koduppsättningen och den officiella etiketten tillsammans

Namnskillnader bör tolkas i källsystemets sammanhang. Etiketten visar hur källan beskriver posten, medan HK, HKG eller 344 identifierar det kodvärde och format som används i systemet. En namnvariant förvandlar inte en alpha-2-kod till en alpha-3-kod och gör inte heller en geografisk kod till en valuta- eller telefonkod.

När du kombinerar datauppsättningar bör du bevara källans etikett, kodtyp och aggregeringsregel. Detta är viktigt för adressdatabaser, statistik, betalningar, frakt och rapporteringssystem. Ersätt inte källans Hongkong-post med en generell landsbeteckning och slå inte automatiskt samman den med en annan post bara för att visningsnamnet verkar likna det andra.

För aktuella integrationer är de relevanta ISO 3166-1-värdena HK, HKG, och 344. Ett tidigare namn eller en indragen kod bör endast användas när en dokumenterad historisk datauppsättning specifikt kräver det. För vanliga aktuella formulär och API:er ska du använda det format som systemet begär och bevara källans etikett när poster utbyts.

Viktiga slutsatser om Hongkongs ISO-koder

• HK är Hongkongs ISO 3166-1 alpha-2-kod.
• HKG är Hongkongs ISO 3166-1 alpha-3-kod och förekommer även i olympiska idrottsdata.
• 344 är Hongkongs geografiska numeriska kod enligt ISO 3166-1.
• +852 är den internationella telefonkoden.
• HKD är valutakoden för Hongkongdollarn.
• .hk och .香港 är Hongkongs landskodstoppdomäner.

Välj värdet utifrån den dokumenterade standarden för fältet, inte utifrån den allmänna formuleringen Hongkongs landskod. Genom att hålla lands-, telefon-, valuta-, idrotts- och domänidentifierare i separata fält blir Hongkong-data lättare att validera och utbyta korrekt.