{"canonical_url":"https://engineer.company/uk/glossary/cldr/","content_markdown":"# CLDR\n\n## Що це таке\n\nCLDR — це зібрання даних про локалі, що доповнює Unicode. Unicode визначає\nсимволи, якими написано текст, а CLDR фіксує, як читачі певної мови в певному\nрегіоні очікують побачити записаними дату, число, ціну, одиницю виміру чи\nперелік і в якому порядку вони очікують побачити відсортовані імена. І те, і\nінше підтримує Консорціум Unicode. Повна назва CLDR тепер Unicode Common Locale\nData \u0026 Rules. Раніше проєкт називався Common Locale Data Repository, а його\nспецифікацію називали Locale Data Markup Language, або LDML; специфікація\nзазначає, що посилання під старими назвами залишаються чинними.\n\nСайт проєкту називає три складники. Перший складник — це самі дані, відібрані й\nупорядковані так, щоб з ними могли працювати програми. Другий — це специфікація,\nтехнічний стандарт Unicode UTS #35, яка описує, як упорядковано дані і як їх\nвикористовують алгоритми, а також вимоги до відповідності стандарту. Третій — це\nкод, який збирає дані від мовних фахівців, перевіряє їх на коректність і\nузгодженість та перетворює у формати, з якими працюють розробники. Добру карту\nдає підсумок самої специфікації про те, що охоплюють дані: ідентифікатори\nлокалей, одиниць виміру, систем запису чисел і календарів; форматування дат,\nчасу, часових поясів, чисел, валют і вимірювань; а також сортування й пошук.\nПоруч із ними стоять правила форм множини, шаблони списків і назви мов та\nрегіонів.\n\nДані впорядковано за локалями. Локаль — це мова, яку можна уточнити системою\nписьма і регіоном. Кожна локаль містить лише те, чим вона відрізняється від\nбатьківської. Приклад у специфікації — англійська: `en` містить основну частину\nданих, а `en_IE`, англійська мова в Ірландії, лише кілька пунктів, як-от валюту.\nНад усіма мовами стоїть локаль root, а локаль основного регіону мови порожня, бо\nїї батьківська локаль уже містить усе потрібне. Деякі відомості належать лише\nрегіонові, хоч би якою була мова: валюта, система мір і правила календарного\nтижня. Тож якщо окремих даних для французької у Сполучених Штатах немає, запит\nна таку локаль отримає формати з `fr`, а суми в доларах США.\n\nДані в первинному вигляді публікують для кожного випуску як XML у форматі, який\nвизначає специфікація, разом з інструментами, що перетворюють їх у формати JSON\nі POSIX. Випуски виходять за графіком із двох циклів на рік, і CLDR 49\nвийшов 22 жовтня 2026 року. Нові дані надходять через онлайн-інструмент Survey\nTool, який зазвичай відкривають раз на рік, щоб зібрати дані для нових структур\nі виправити вже випущені, а те, що потрапляє до CLDR, перевіряють носії мов і\nмовознавці.\n\n## Чому це важливо\n\nСайт проєкту прямо називає проблему: форматувати дати, числа, валюти й одиниці\nвиміру для різних мов і регіонів набагато складніше, ніж уявляє собі більшість\nлюдей. CLDR існує для того, щоб жодній команді не доводилося опановувати цю\nскладність мова за мовою. Він підтримує понад 100 мов, і його дані\nперевіряють носії мов і мовознавці, а це більше перевірки, ніж\nбудь-яка продуктова команда може дати формату дати на ринку, куди вона щойно\nвийшла.\n\nБільшість команд ніколи не працює з CLDR напряму, і так задумано. Серед тих, хто\nвикористовує його дані, проєкт називає всі сучасні операційні системи й\nбраузери, а також такі мови, як Java, C#, .NET, Swift і JavaScript. Часто це\nвідбувається опосередковано: застосунок просить службу операційної системи\nвідформатувати дату, служба викликає ICU, бібліотеку промислового рівня від\nUnicode для C, C++, Java і Rust, а ICU читає CLDR. Node.js будує свої об'єкти\n`Intl` на ICU і типово постачає повні дані ICU; програми на Python дістаються\nтих самих даних через Babel, а програми на Ruby через TwitterCLDR. Коли команда\nвикликає засіб форматування з урахуванням локалі, відповідь майже завжди\nнадходить із CLDR. Команда ж і далі вирішує, яку локаль запитати і з яким\nвипуском працювати.\n\nІнший шлях — таблиця, написана вручну: дванадцять назв місяців для кожної мови,\nдесятковий розділювач, розділювач тисяч, порядок абетки. У кращому разі така\nтаблиця правильна в день, коли її написали, і відтоді лишається незмінною, тоді\nяк Survey Tool проєкту щороку відкривається знову, щоб виправити вже випущені\nдані. До того ж пише її зазвичай людина, яка знає лише деякі з мов у ній.\nПорядок, у якому данська і шведська сортують ті самі шість назв населених\nпунктів, показаний нижче, не вгадає розробник, який не знає цих мов.\n\n## Як це виглядає на практиці\n\nЗапитайте в середовища виконання, який випуск CLDR воно має, потім дайте цим\nданим відсортувати шість данських і шведських назв населених пунктів, об'єднати\nв список три назви данських міст і визначити перший день тижня для чотирьох\nлокалей:\n\n```js\nconsole.log(\"CLDR\", process.versions.cldr);\n\nconst towns = [\"Ørsted\", \"Odense\", \"Åsa\", \"Aabenraa\", \"Ærø\", \"Ängelholm\"];\nconsole.log(\"code point\", [...towns].sort().join(\", \"));\nfor (const tag of [\"en\", \"da\", \"sv\"]) {\n  const sorted = [...towns].sort(new Intl.Collator(tag).compare);\n  console.log(tag.padEnd(10), sorted.join(\", \"));\n}\n\nconst three = [\"Aarhus\", \"Odense\", \"Aalborg\"];\nfor (const tag of [\"en-GB\", \"en-US\", \"da\", \"uk\"]) {\n  console.log(tag.padEnd(10), new Intl.ListFormat(tag).format(three));\n}\n\nfor (const tag of [\"en\", \"en-GB\", \"en-DK\", \"da\"]) {\n  const locale = new Intl.Locale(tag);\n  const { firstDay } = locale.getWeekInfo();\n  console.log(tag.padEnd(10), locale.maximize().toString(), firstDay);\n}\n```\n\nNode 25.2.1 виводить:\n\n```text\nCLDR 47.0\ncode point Aabenraa, Odense, Ängelholm, Åsa, Ærø, Ørsted\nen         Aabenraa, Ærø, Ängelholm, Åsa, Odense, Ørsted\nda         Odense, Ängelholm, Ærø, Ørsted, Aabenraa, Åsa\nsv         Aabenraa, Odense, Åsa, Ängelholm, Ærø, Ørsted\nen-GB      Aarhus, Odense and Aalborg\nen-US      Aarhus, Odense, and Aalborg\nda         Aarhus, Odense og Aalborg\nuk         Aarhus, Odense і Aalborg\nen         en-Latn-US 7\nen-GB      en-Latn-GB 1\nen-DK      en-Latn-DK 1\nda         da-Latn-DK 1\n```\n\nПерший рядок показує випуск, з яким зібрано це середовище виконання. Це 47.0,\nхоча CLDR 49 уже вийшов: середовище виконання має дані своєї збірки, а не\nнайновіші дані, які існують.\n\nЗвичайний `sort()` без функції порівняння ставить Ä, Å, Æ і Ø після всіх літер\nвід A до Z, у порядку їхніх кодів символів, і це не відповідає жодній із трьох\nмов. Англійська сортує кожну назву за базовою літерою, тож чотири назви на A\nйдуть першими, а Ørsted іде після Odense. Данська закінчує абетку літерами Æ, Ø\nі Å, вважає Ä варіантом Æ і ставить Aabenraa, назву, записану за старим\nправописом через подвійне a, серед назв на Å; частина специфікації про\nсортування називає це данською контракцією «aa». Шведська закінчує абетку\nлітерами Å, Ä і Ö, вважає Æ варіантом Ä, а Ø варіантом Ö, і сортує Aabenraa як\nназву, що починається з двох a. Норвезький букмол, `nb`, дає той самий порядок,\nщо й данська. Нічого з цього в коді немає: кожен порядок береться з правил\nсортування CLDR для відповідної мови.\n\nСписки працюють так само. Кожна локаль має шаблон списку з окремими частинами\nдля початку, середини й кінця списку, а також для списку з двох елементів.\nБританська англійська не ставить кому перед «and», американська ставить, данська\nз'єднує елементи словом «og», а українська словом «і», і все це дає один виклик,\nу якому немає жодного слова з цих мов.\n\nОстанні чотири рядки показують дані, які належать регіонові, а не мові. Кожен\nрядок містить тег, повну форму, яку `maximize()` доповнює з даних CLDR про\nнайімовірніші систему письма й регіон, і перший день тижня як число за ISO 8601,\nде 1 означає понеділок, а 7 неділю. Тег `en` без регіону середовище виконання\nтлумачить як англійську мову латинським письмом у варіанті США, тож тиждень\nпочинається з неділі. Для англійської у Великій Британії чи в Данії тиждень\nпочинається з понеділка, як і для данської: тиждень залежить від регіону, а не\nвід мови.\n\nТі самі норми, що їх фіксує CLDR, доводиться вручну витримувати й у\nперекладеному тексті. Один із проєктів на цьому сайті,\n[міжмовна перевірка чисел](/uk/portfolio/built-a-cross-language-figure-check/),\nвибирає з англійського рядка кожне число, відсоток, множник та одиницю виміру й\nвимагає, щоб кожен із цих елементів був у кожному перекладі. Вона також\nперевіряє кожну мову на норми, яких треба дотримуватися, і на ті, яких\nдотримуватися не можна, зокрема щодо десяткового розділювача, групування\nрозрядів і лапок.\n\n## Де виникають проблеми\n\n**Відформатований текст порівнюють як незмінний рядок.** Тест, що очікує\n`\"1 500\"` від `new Intl.NumberFormat(\"sv\").format(1500)`, падає, хоча результат\nвиглядає саме так, бо шведська, норвезька й українська розділяють тисячі\nсимволом U+00A0 NO-BREAK SPACE, нерозривним пробілом, який редактор показує як\nзвичайний. Той самий тест може зламатися й після оновлення, бо новий випуск CLDR\nможе виправити дані, які постачав попередній. Порівнюйте відформатований\nрезультат із результатом того самого засобу форматування, перевіряйте його\nбудову через `formatToParts`, який позначає кожну частину як integer, group,\ndecimal чи fraction, і ніколи не розбирайте відформатований текст назад у число.\nСпецифікація радить зберігати й передавати дані в мовно-нейтральному вигляді і\nформатувати їх для читача.\n\n**Два середовища виконання мають два різні випуски.** Node 25.2.1 постачається з\nCLDR 47.0, тоді як проєкт уже випустив 49, а браузер має той випуск, з яким його\nзібрали. Сторінка, що форматує дату на сервері, а потім ще раз у браузері, може\nпоказати для одного значення два різні рядки, а знімок, записаний на одній\nмашині, може не пройти на іншій. Форматуйте кожне значення в одному місці,\nзаписуйте `process.versions.cldr` поруч зі знімками тестів і оновлюйте\nсередовище виконання свідомо.\n\n**Відсутня локаль непомітно підмінюється іншою.** `new Intl.NumberFormat(\"tlh\")`\nформатує як американська англійська і не кидає винятку, бо середовище виконання\nне має даних для клінгонської і переходить до своєї типової локалі. Документація\nNode описує ще менш помітний випадок: двійковий файл, зібраний з опцією\nsmall-icu, зазвичай містить лише англійські дані, і там іспанська назва місяця\nвиводиться як «M01» або «January» замість «enero». Перевіряйте\n`resolvedOptions().locale` або `supportedLocalesOf`, перш ніж довіряти локалі, і\nзбирайте з повними даними ICU, які в Node є типовими і які мають офіційні\nдвійкові файли.\n\n**Тег без регіону отримує найімовірніший.** Середовище виконання тлумачить `en`\nяк `en-Latn-US`, тож читач в Ірландії, Великій Британії чи Данії, якому віддали\n`en`, побачить тиждень, що починається з неділі, і дати у вигляді 10/27/2026, з\nмісяцем на першому місці. Специфікація описує дані likely subtags, на яких це\nґрунтується, як виведені евристично й зазначає, що вони можуть змінюватися з\nчасом. Передавайте регіон читача разом із мовою, коли він відомий, а коли відома\nлише мова, викликайте `maximize()`, щоб побачити, який регіон припустить\nсередовище виконання.\n\n**Ідентифікатори CLDR передають в API, що чекає BCP 47.** Файли й приклади CLDR\nзаписують локалі з підкресленням, як-от `en_IE`, і специфікація вважає `_` і `-`\nрівнозначними. `Intl` у JavaScript так не вважає:\n`new Intl.NumberFormat(\"da_DK\")` кидає\n`RangeError: Invalid language tag: da_DK`. Перетворюйте ідентифікатор на межі\nтак само, як це робить власне перетворення специфікації на BCP 47, замінюючи\nкожне `_` на `-`, і пропускайте результат через `Intl.getCanonicalLocales`, який\nповертає `da-DK`.\n\n## Що почитати далі\n\n- [Unicode CLDR Project](https://cldr.unicode.org/) — що таке CLDR, три його\n  складники, хто й як використовує його дані, і графік випусків.\n- [UTS #35, Part 1: Core](https://www.unicode.org/reports/tr35/) —\n  специфікація: ідентифікатори локалей, колишні назви, успадкування між\n  локалями, likely subtags і порада тримати дані мовно-нейтральними.\n- [UTS #35, Part 2: General](https://www.unicode.org/reports/tr35/tr35-general.html)\n  — назви мов і регіонів для показу, системи мір і шаблони списків, використані\n  вище.\n- [UTS #35, Part 5: Collation](https://www.unicode.org/reports/tr35/tr35-collation.html)\n  — як CLDR пристосовує типовий порядок сортування до кожної мови, з данською\n  як прикладом.\n- [Node.js: Internationalization support](https://nodejs.org/api/intl.html) —\n  як Node будує свої об'єкти `Intl` на ICU, параметри збирання і як дізнатися,\n  що підтримує двійковий файл.\n- [ECMAScript Internationalization API Specification](https://tc39.es/ecma402/)\n  — стандарт, на якому стоїть `Intl`, зокрема методи `Locale`, використані\n  вище, і дані CLDR про тиждень та likely subtags, на які вони спираються.\n\n\u003chttps://engineer.company/uk/glossary/cldr/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що містить Unicode CLDR, як локалі успадковують дані, як середовища виконання їх постачають і п'ять помилок із відформатованими значеннями й тегами локалей.","formats":{"gemtext":"https://engineer.company/uk/glossary/cldr/index.gmi","gopher":"https://engineer.company/uk/glossary/cldr/gophermap","html":"https://engineer.company/uk/glossary/cldr/","json":"https://engineer.company/uk/glossary/cldr/index.json","markdown":"https://engineer.company/uk/glossary/cldr/index.md","pdf":"https://engineer.company/uk/glossary/cldr/index.pdf"},"kind":"page","language":"uk","title":"Що таке CLDR?","url":"https://engineer.company/uk/glossary/cldr/","version":1}