Hongkongi ISO-koodid: HK, HKG ja 344 selgitatud
Hongkongi ISO-koodi otsimine võib anda mitu erinevat vastust, sest riigi-, telefoni-, valuuta-, spordi- ja internetisüsteemid kasutavad eraldi tunnuseid. Hongkongi ISO 3166-1 koodid on HK, HKG ja 344. Selles juhendis selgitatakse iga vormingu tähendust, miks HKG võib esineda ka olümpiaandmetes ning kuidas hoida ISO-koode vormides, tarkvaras ja finantskirjetes eraldi koodidest +852, HKD, .hk ja .香港.
Hongkongi ISO-koodid: kiire vastus
Hongkongil on kolm ISO 3166-1 esitusviisi: kahetäheline alfa-2-kood, kolmetäheline alfa-3-kood ja numbriline kood. Õige väärtus sõltub seda vastu võtva välja või süsteemi nõuetest.
Kolm ISO 3166-1 koodi ühe pilguga
| ISO-koodi tüüp | Hongkongi väärtus | Tüüpiline kasutus |
|---|---|---|
| Alfa-2 | HK | Lühikesed riigiväljad ja üldine andmevahetus |
| Alfa-3 | HKG | Kolmetähelised riigiandmestikud ja mõned spordiandmed |
| Numbriline | 344 | Statistilised, pärandsüsteemid ja ainult numbreid kasutavad süsteemid |
Teises ISO riikide loendis allikast Docebo abi ja tugi tuvastatakse Hongkong samuti alfa-2-väärtuse HK abil. Telefoni suunakood, valuutakood, olümpiakood ja internetidomeenid ei ole ISO 3166-1 täiendavad vormingud. Need kuuluvad teistele standarditele või organisatsioonidele.
Hongkongi kolm ISO 3166-1 koodi selgitatud
Kolm ISO-vormingut tähistavad sama geograafilist kirjet eri viisidel. Need ei ole igas rakenduses omavahel asendatavad, seega peaks esitatava või salvestatava väärtuse määrama vastuvõtva süsteemi dokumentatsioon.
ISO alfa-2-kood: HK
HK on Hongkongi kahetäheline ISO 3166-1 alfa-2-tunnus. See on kõige kompaktsem vorm, mida üldises riigiväljas ISO alfa-2-väärtusena kõige sagedamini nõutakse. Näiteks võib selle standardi järgi kavandatud andmebaas salvestada country_alpha2 = HK.
HK ei ole sama mis rahvusvaheline telefoniside eesliide +852. Samuti ei ole see identne domeenilõpuga .hk, kuigi tähed on omavahel seotud. Esimene on ISO riigiväärtus, teist kasutatakse telefoninumbrite süsteemis ja kolmas on DNS-tunnus.
Kasuta HK-d, kui vorm, API või andmespetsifikatsioon ütleb selgelt, et oodatakse ISO 3166-1 alfa-2-koodi. Ära eelda, et iga väljaga „riigikood” mõeldakse seda vormingut. Mõni teenus nõuab täisnime, alfa-3-väärtust, numbrilist väärtust või teenusepakkuja enda koodi.
ISO alfa-3-kood: HKG
HKG on Hongkongi kolmetäheline ISO 3166-1 alfa-3-kood. Kolmetäheline vorming võib olla kasulik rahvusvahelistes andmestikes, kus eelistatakse pikemat ja paremini äratuntavat lühendit või kus liides nõuab selgesõnaliselt alfa-3-väärtusi.
Näiteks võib API määratleda eraldi väljad country_alpha2 ja country_alpha3. Sellisel juhul kuulub HK esimesse välja ja HKG teise. HKG ei tohiks automaatselt asendada HK-d süsteemis, mis valideerib ainult kahetähelisi väärtusi.
HKG-d kasutatakse ka olümpiakontekstis. Ühesugused tähed võivad muuta andmevahetuse lihtsamaks, kuid olümpiakoodi ja ISO-koodi haldavad erinevad organisatsioonid. Kirjete vastendamisel säilita välja nimi või lähtestandard, et HKG tähendus jääks selgeks.
ISO numbriline kood: 344
344 on Hongkongi ISO 3166-1 numbriline kood. Numbrilised tunnused on kasulikud statistikasüsteemides, vanemates andmebaasides ja liidestes, mis vajavad keeleliselt neutraalset väärtust ilma tähestikuliste lühenditeta.
Väli nimega country_numeric või iso_numeric võib seega sisaldada väärtust 344, kui see on määratletud ISO 3166-1 geograafilise väärtusena. See, kas rakendus salvestab väärtuse teksti või arvuna, sõltub teenusepakkuja skeemist. Andmevahetusel säilita välja määratlus ja standardi nimi.
Arv 344 võib esineda ka teistes süsteemides, sealhulgas valuutaandmetes. See ei muuda kirjeid omavahel asendatavaks. ISO riigiväärtuse ja valuuta numbrilise väärtuse võrdlemisel kasuta väljendit geograafiline numbrikood ning hoia mõlemat tähendust eraldi tüübistatud väljadel.
Kuidas erinevad teised Hongkongi tunnused ISO-koodidest
Hongkongi teised tuntud koodid on kasulikud, kuid vastavad eri küsimustele. Telefonisüsteem vajab suunakoodi, maksesüsteem valuutakoodi, spordiandmebaas võib vajada olümpiakoodi ja internet domeenisilti.
Rahvusvaheline suunakood: +852
+852 on Hongkongi rahvusvaheline telefoniside suunakood. See kuulub telekommunikatsiooni numeratsioonisüsteemi, mitte ISO 3166-1 riigitunnuste hulka. Telefonirakendus võib seda kasutada rahvusvahelise numbri suunamiseks või kuvamiseks, samal ajal kui sama kliendikirje riigiväljal võidakse kasutada HK-d.
Näiteks võib ühendusekirje sisaldada väärtusi country_iso_alpha2 = HK ja telephone_calling_code = +852. Need väärtused kirjeldavad seotud asukohateavet, kuid neid ei tohiks salvestada ühte eristamata riigikoodi välja. Sideameti teave annab Hongkongi numeratsiooniplaani kohta telekommunikatsioonialast teavet.
Kui vorm ütleb „Hongkongi riigikood”, lugege ümbritsevaid väljasilte hoolikalt. Kui väli kuulub telefoninumbrile, võidakse oodata väärtust +852. Kui seal öeldakse ISO alfa-2, on sobiv väärtus HK. Salvesta +852 telefoni suunakoodi väljale, mitte ISO riigikoodi väljale.
Valuutakood: HKD
HKD on Hongkongi dollari ISO 4217 tähestikuline kood. See tähistab valuutat, mitte geograafilist asukohta. Seetõttu erineb HKD nii HK-st kui ka HKG-st, kuigi kõigis kolmes esinevad Hongkongiga seotud tähed.
Kassa-, arve- või raamatupidamiskirje võib väärtused eraldada järgmiselt:
- country_alpha2: HK
- currency: HKD
- amount: 1,250.00
Geograafiline ISO numbrikood on 344. Valuutandmestik võib seostada arvu 344 Hongkongi dollariga ka numbrilise valuutakoodina. Korduv number võib põhjustada andmevigu, eriti kui riigi- ja valuutatabeleid ühendatakse automaatselt. Hoia HKD ja geograafiline numbrikood 344 eraldi tüübistatud väljadel ka siis, kui mõlemad süsteemid kasutavad arvu 344.
Seega ei ole HKD ISO 3166-1 riigikoodi alternatiiv. Kasuta HKD jaoks finantsteenuse dokumenteeritud valuutavälja ning HK, HKG või 344 jaoks sobivat geograafilist välja.
Olümpiakood: HKG
Rahvusvaheline Olümpiakomitee kasutab oma spordikoodide süsteemis Hongkongi jaoks väärtust HKG . See on kasulik olümpiatulemuste, medalitabelite, võistkondade nimekirjade või ROK-i lühendeid kasutavate spordivoogude lugemisel.
Väärtus vastab Hongkongi ISO alfa-3-koodile, kuid see ei tähenda, et iga spordikood oleks ISO-kood. Tähenduse määravad andmestik ja selle defineerinud organisatsioon. Üldine riigiandmebaas võib tõlgendada HKG-d kui ISO 3166-1 alfa-3-koodi, olümpiatulemuste fail aga ROK-i spordikoodina.
Spordiandmete üldisesse riigiandmebaasi vastendamisel säilita lähtesüsteem või standardi nimi. Käsitle kattuvat väärtust koostalitlusvõimaluse hõlbustajana, mitte tõendina, et kaks koodisüsteemi on identsed.
Internetidomeenid: .hk ja .香港
.hk on Hongkongi ladina kirjas riigikoodi tippdomeen. Seda kasutatakse DNS-is ja internetiaadressides, mitte ISO riigivälja väärtusena. Selle seos ISO alfa-2-väärtusega HK aitab tuvastada domeeniga tähistatud territooriumi, kuid mõlemal tunnusel on siiski erinev tehniline eesmärk.
.香港 on Hongkongi tähistav hiina kirjas rahvusvahelistatud riigikoodi tippdomeen. Delegeerimisraport allikast IANA dokumenteerib selle delegeerimise organisatsioonile Hong Kong Internet Registration Corporation Limited.
The IANA delegeerimisandmed domeeni .hk kohta nimetavad Hong Kong Internet Registration Corporationi selle riigikoodi tippdomeeni halduriks. Praktikas võivad domeeni registreerimine ja DNS-i valideerimine hõlmata reegleid, mis on ISO riigikoodi valideerimisest eraldi.
Domeenitarkvaras on .香港 rahvusvahelistatud silt. Brauser või DNS-teek võib kuvada kasutajale hiinakeelset vormi, töötledes samal ajal sisemiselt ASCII-ga ühilduvat esitust. Kasuta konkreetse domeeni API nõutud vormingut. Enne domeenide .hk või .香港 valideerimis- või registreerimisreeglite rakendamist kontrolli IANA ajakohast teavet ja Hong Kong Internet Registration Corporationi kehtivaid nõudeid.
Hongkongi koodide kasutamine vormides, tarkvaras ja andmetes
Koodivead tekivad tavaliselt siis, kui väli on nimetatud liiga üldiselt. Usaldusväärne integratsioon tuvastab esmalt standardi ja vormingu ning valideerib seejärel väärtuse selle määratluse alusel.
Vormid, andmebaasid ja API-d
Kasuta HK-d ainult siis, kui vormi, API või andmebaasi väli eeldab selgesõnaliselt ISO 3166-1 alfa-2-koodi. Kui spetsifikatsioon ütleb alfa-3, kasuta HKG-d. Kui see ütleb ISO numbriline, kasuta 344. Üht vormingut aktsepteeriv teenus võib teised tagasi lükata või neid vaikimisi valesti tõlgendada.
Mitut vormingut vahetav rakendus võib salvestada eraldi atribuudid või kasutada kontrollitud otsingutabelit. Tõlkesõbralik näide on:
- country_alpha2: HK
- country_alpha3: HKG
- country_numeric: 344
Eraldi atribuudid muudavad teisendused selgesõnaliseks. Samuti takistavad need arendajal paigutada kolmetähelist väärtust kahetähelisse välja lihtsalt seetõttu, et mõlemad kirjeldavad Hongkongi. Kui teenusepakkuja kasutab üht välja nimega country, vaata dokumentatsioonist, kas see aktsepteerib ISO-koodi, kuvatavat nime või muud tunnust.
Kasuta vastuvõtva teenuse määratud suurtähekuju ja andmetüüpi. ISO tähestikulisi koode esitatakse tavaliselt suurtähtedega, kuid API-l võivad olla oma valideerimisreeglid. Numbrilist väärtust 344 võidakse esitada teksti või täisarvuna. Kontrollitud otsingutabel peaks registreerima koodi tüübi, lähtestandardi, aktsepteeritava vormingu ning integratsiooniks vajaliku versiooni või kehtivuskuupäeva teabe.
Enne Hongkongi väärtuse esitamist kontrolli, kas väline vorm või API eeldab ISO alfa-2-, alfa-3- või numbrilist vormingut. Ära tuleta vajalikku esitust üksnes sõnadest „riigikood”.
Maksed ja finantsaruandlus
Makse- ja aruandlussüsteemid vajavad sageli nii geograafilist kui ka rahalist teavet. Hoia need eraldi: klient või tehing võib kasutada HK-d ISO alfa-2-riigiväärtusena ja HKD-d valuutaväärtusena. Mõni teine süsteem võib selle asemel nõuda HKG-d või geograafilist numbrit 344.
Näiteks võib tehingukirje sisaldada väärtusi billing_country = HK, settlement_currency = HKD, ja currency_amount = 500.00. Täpsed väljanimed ja aktsepteeritavad koodid sõltuvad makseteenusest, pangast, raamatupidamisplatvormist või aruandlusspetsifikatsioonist.
Numbriga 344 tuleb olla eriti ettevaatlik riigi-, statistika- ja valuutaandmestike ühendamisel. Säilita vastenduses lähtestandard, näiteks ISO 3166-1 geograafiline number või ISO 4217 valuuta number. See takistab korduval väärtusel tekitada valet semantilist vastet ning aitab tulemust vastavuse kontrolli või auditi käigus selgitada.
Telefoni-, domeeni-, riigi- ja valuutaväljade eraldi hoidmine
Hongkongi ühendusprofiil võib sisaldada korraga mitut kehtivat tunnust:
- 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
Need ei ole ühe koodi omavahel asendatavad versioonid. Need toetavad eri ülesandeid: riigi tuvastamist, telefoniside suunamist, rahalist töötlemist ja domeeninimede kasutamist. Nende eraldamine parandab valideerimist, otsingut, kasutajaliidese silte ja API-de koostalitlusvõimet.
Lõplik valideerimisetapp peaks kontrollima iga välja selle teenuse eeldatava standardi järgi. Näiteks valideeri HK ISO alfa-2-reegli, +852 telefonireegli, HKD valuutareegli ja .hk domeenireegli alusel. Väljade kaupa lähenemine on usaldusväärsem kui ühe üldise riigikoodi valideerija rakendamine igale väärtusele.
Hongkong, Hiina ja ametliku nimetuse kontekst
Erinevad rahvusvahelised standardid, organisatsioonid ja tarkvarapakkujad võivad sama kavandatud Hongkongi kirje kohta kasutada erinevaid ingliskeelseid nimetusi. Andmestikus võib olla Hongkong, Hongkong, Hiina, või sõnastus, mis määratleb Hongkongi Hiina erihalduspiirkonnana.
Kasuta koodistikku ja ametlikku nimetust koos
Nimede erinevusi tuleb tõlgendada lähtesüsteemi kontekstis. Nimetus näitab, kuidas allikas kirjet kirjeldab, samas kui HK, HKG või 344 tähistab selles süsteemis kasutatavat koodiväärtust ja vormingut. Nimevariant ei muuda alfa-2-koodi alfa-3-koodiks ega geograafilist koodi valuuta- või telefonikoodiks.
Andmestike ühendamisel säilita lähtesilt, koodi tüüp ja koondamisreegel. See on oluline aadressiandmebaaside, statistika-, makse-, veo- ja aruandlussüsteemide puhul. Ära asenda allika Hongkongi kirjet üldise riiginimetusega ega ühenda seda automaatselt teise kirjega ainult seetõttu, et kuvatav nimi näib sarnane.
Praeguste integratsioonide jaoks on asjakohased ISO 3166-1 väärtused HK, HKG, ja 344. Varasemat nime või kasutuselt kõrvaldatud koodi tohib kasutada ainult siis, kui dokumenteeritud ajalooline andmestik seda konkreetselt nõuab. Tavalistes praegustes vormides ja API-des kasuta süsteemi nõutud vormingut ning säilita kirjete vahetamisel lähtesilt.
Hongkongi ISO-koodide põhipunktid
- HK on Hongkongi ISO 3166-1 alfa-2-kood.
- HKG on Hongkongi ISO 3166-1 alfa-3-kood ja esineb ka olümpiaandmetes.
- 344 on Hongkongi ISO 3166-1 geograafiline numbrikood.
- +852 on rahvusvaheline telefoniside suunakood.
- HKD on Hongkongi dollari valuutakood.
- .hk ja .香港 on Hongkongi riigikoodi tippdomeenid.
Vali väärtus välja dokumenteeritud standardi, mitte üldise väljendi „Hongkongi riigikood” järgi. Riigi-, telefoni-, valuuta-, spordi- ja domeenitunnuste hoidmine eraldi väljadel muudab Hongkongi andmete valideerimise ja täpse vahetamise lihtsamaks.
Vali piirkond
Loo postitus
Postitamine on tasuta ja registreerimine pole vajalik.