{"canonical_url":"https://engineer.company/uk/glossary/localization/","content_markdown":"# Локалізація\n\n## Що це таке\n\nЛокалізація — це робота з пристосування продукту до одного конкретного ринку: до\nйого мови, а разом із нею до норм, яких читачі очікують від дат, чисел, цін,\nімен, адрес і порядку в списку. W3C визначає її як адаптацію продукту,\nзастосунку чи вмісту документа до мовних, культурних та інших вимог певного\nцільового ринку, а сам такий ринок називає локаллю. Англійською слово пишуть\nlocalization або localisation і скорочують до l10n, бо між першою l та останньою\nn стоїть 10 літер.\n\nW3C додає, що локалізацію часто вважають лише синонімом перекладу інтерфейсу й\nдокументації, хоча насправді це часто значно складніше завдання. Перелік того,\nщо може потребувати адаптації, охоплює формати чисел, дат і часу; валюту;\nрозкладку клавіатури та її використання; сортування; символи, піктограми й\nкольори; текст і графіку, які в певній культурі можуть хибно витлумачити або\nсприйняти як образливі; юридичні вимоги; формати адрес, поштових індексів і\nтелефонних номерів та порядок імен; а також вимоги до читабельності кожної\nписемності. Там, де відрізняється спосіб вести справи, а прикладом W3C наводить\nбухгалтерію, адаптація може вимагати переосмислити логіку, візуальний дизайн або\nподання продукту.\n\nЛокалізація спирається на інтернаціоналізацію і йде після неї.\nІнтернаціоналізацію роблять один раз, у коді, щоб жодна особливість окремого\nринку не була в ньому зашита. Локалізацію роблять для кожної локалі, у даних,\nякі читає код: це перекладені повідомлення й норми, за якими збережена дата чи\nсума перетворюється на текст, якого очікує читач. Добре інтернаціоналізований\nпродукт може отримати нову локаль без змін у коді; погано інтернаціоналізований\nдоводиться змінювати заново для кожного ринку, на який він виходить.\n\nБільшість цих норм команді не доводиться записувати самій. Проєкт CLDR\nКонсорціуму Unicode збирає їх для понад 100 мов, а перевіряють їх носії мов і\nмовознавці. Власний приклад проєкту — список файлів у телефоні: формат дат,\nчисел, одиниць розміру файлів і алфавітний порядок залежать від мови і зазвичай\nнадходять із CLDR. Проєкт стверджує, що його дані вбудовано в усі сучасні\nопераційні системи й браузери, а також у такі мови програмування, як Java, C#,\nSwift і JavaScript. Отже, більшість форматів продукт отримує від платформи, якщо\nкод просить їх у платформи, а не задає сам.\n\n## Чому це важливо\n\nПерекладений, але не локалізований продукт здається чужим. Усі написи\nперекладено українською, але дата досі починається з місяця, ціна досі стоїть зі\nзнаком долара, а список міст, відсортований за кодами символів, ставить Ізмаїл\nперед Вінницею. Читачі помічають кожну таку деталь одразу, і кожна з них\nпідказує, що продукт робили для когось іншого.\n\nДеякі розбіжності змінюють те, що читач розуміє. Рядок 10/11/2026 для\nамериканського читача означає 11 жовтня, а для британського 10 листопада; обидві\nдати коректні, тож нічого не ламається, і один із двох читачів діє не того дня.\nРядок 1,234 англійською означає тисячу двісті тридцять чотири, а українською\nодну цілу двісті тридцять чотири тисячних, тобто різниця в тисячу разів у\nкількості чи ціні. Помилку в перекладі видно одразу. Помилкова норма виглядає\nправильною, і її хибно прочитують.\n\nПерелік W3C виходить і за межі екрана. Юридичні вимоги на різних ринках різні,\nяк і способи вести бізнес, тож локаль може вимагати інших умов, інших реквізитів\nу рахунку чи іншого порядку оформлення покупки. Це рішення для бізнесу, і їм\nмісце в плані локалі ще до того, як перекладуть перше повідомлення.\n\nВитрати рахуються на кожну локаль і ніколи не закінчуються. Кожне нове\nповідомлення треба перекласти всіма мовами продукту, кожен реліз треба\nперечитати в кожній локалі перед виходом, і кожен ринок приносить власні норми,\nякі треба перевірити. Команда, що додає мову, додає цю роботу до кожного\nнаступного релізу, тому рішення вийти на ринок водночас є рішенням про процес\nрелізів.\n\n## Як це виглядає на практиці\n\nБільшу частину роботи виконує платформа, якщо код передає їй значення й локаль.\nУ JavaScript об'єкти форматування з `Intl` приймають і значення, і локаль та\nповертають текст:\n\n```js\nconst when = new Date(\"2026-10-27T12:00:00Z\");\nconst money = { style: \"currency\", currency: \"DKK\" };\nfor (const locale of [\"en-US\", \"en-GB\", \"da\", \"nb\", \"sv\", \"uk\"]) {\n  const date = new Intl.DateTimeFormat(locale, { dateStyle: \"short\" });\n  const price = new Intl.NumberFormat(locale, money);\n  console.log(locale, date.format(when), price.format(800));\n}\n```\n\nУ Node.js 25, що містить дані CLDR 47, код виводить одну дату й одну ціну\nв 800 данських крон шістьма способами:\n\n```text\nen-US 10/27/26 DKK 800.00\nen-GB 27/10/2026 DKK 800.00\nda 27.10.2026 800,00 kr.\nnb 27.10.2026 800,00 DKK\nsv 2026-10-27 800,00 Dkr\nuk 27.10.26 800,00 DKK\n```\n\nНічого з цього код не обирав. Данський читач бачить kr., шведський Dkr, бо kr у\nШвеції означає шведську крону, а норвезький та український читачі бачать код\nвалюти. Порядок дня й місяця, роздільники, десяткова кома й місце валюти\nберуться з даних локалі. У справжньому виводі між сумою та валютою стоїть\nнерозривний пробіл, U+00A0, який тримає їх на одному рядку.\n\nСортування працює так само. Шість данських назв місцевостей, відсортованих для\nтрьох локалей:\n\n```js\nconst towns = [\"Aabenraa\", \"Ærø\", \"Åkirkeby\", \"Odense\", \"Østerbro\", \"Vejle\"];\nfor (const locale of [\"en\", \"da\", \"sv\"]) {\n  const order = new Intl.Collator(locale).compare;\n  console.log(locale, towns.toSorted(order).join(\", \"));\n}\n```\n\n```text\nen Aabenraa, Ærø, Åkirkeby, Odense, Østerbro, Vejle\nda Odense, Vejle, Ærø, Østerbro, Aabenraa, Åkirkeby\nsv Aabenraa, Odense, Vejle, Åkirkeby, Ærø, Østerbro\n```\n\nАнглійська трактує æ, ø і å як різновиди a та o. Данська ставить Æ, Ø і Å після\nZ і сортує старе написання Aa як Å, тож Aabenraa переміщується з першого місця\nна передостаннє. Шведська ставить власні Å, Ä і Ö після Z, сортує Æ разом з Ä, а\nØ разом з Ö, але Aa вважає двома a, тож і для шведського читача Aabenraa стоїть\nпершим. Кожен порядок правильний для своїх читачів, а данський читач, який\nшукатиме Aabenraa ближче до кінця списку, відсортованого для англійської, має\nвсі підстави вирішити, що міста там немає.\n\nСайт на Hugo має ті самі інструменти у своїх шаблонах. Документація Hugo\nпропускає одну суму через `lang.FormatCurrency`:\n\n```text\n{{ 512.5032 | lang.FormatCurrency 2 \"USD\" }}\n```\n\nАнглійська сторінка показує її як $512.50, французька як 512,50 $US, німецька як\n512,50 $, а `lang.FormatNumber` і `lang.FormatPercent` роблять те саме для\nзвичайних чисел і відсотків.\n\nЛокалізація входить до однієї з послуг цього сайту. Послуга\n[Інтернаціоналізація та локалізація](/uk/services/i18n-localization/)\nописує мету як програму, що природно читається на кожному ринку, де продає\nклієнт, з правильними датами, валютами й сортуванням імен. Серед її результатів\nє міжмовна перевірка контенту, яка падає, коли переклад губить число, вказане\nанглійською, або коли мова вживає не притаманну їй нотацію, і яка знайшла два\nданські описи, у яких було втрачено показник з англійського тексту, та\nшістнадцять українських фрагментів, що цитували на англійський лад.\n\n## Де виникають проблеми\n\n**Локалізацію бюджетують як переклад.** План виходу на новий ринок охоплює файли\nповідомлень і нічого більше, тож продукт запускають новою мовою з датами,\nцінами, адресами й порядком сортування старого ринку, а прогалини знаходять\nклієнти. Плануйте кожну локаль за повним переліком W3C, вирішіть, які пункти\nстосуються саме цього ринку, і дайте носієві мови переглянути готовий продукт, а\nне файли повідомлень.\n\n**Мову плутають із локаллю.** `en` не каже, чи 27 жовтня записується як\n`10/27/26`, чи як `27/10/2026`, і результат вище показує, що дві англійські\nлокалі розходяться і в порядку, і в записі року. Продукт, який зберігає лише\nмову, мусить угадувати решту, і норми одного ринку він нав'язує всім іншим.\nЗберігайте для кожного користувача повний тег, як-от `en-GB` чи `uk-UA`, беріть\nйого з явного налаштування, де воно є, і передавайте в кожен виклик\nформатування.\n\n**Валюту вгадують за локаллю.** Специфікація CLDR каже про це прямо: суму ніколи\nне можна передавати між системами без відомого коду валюти, інакше один\nкористувач прочитає число 3,5 як 3,50 долара, а інший — як 3,50 євро. Вона\nдодає, що код валюти суми не залежить від мови читача і що лише в погано\nспроєктованих програмах коду немає, тож програмі доводиться вгадувати валюту за\nлокаллю. У Скандинавії така здогадка помиляється непомітно, бо данці, норвежці й\nшведи однаково скорочують назву своєї крони до kr, тож ціна, збережена як 800,\nдля одного читача означатиме 800 данських крон, а для наступного 800 норвезьких.\nЗберігайте кожну суму з її кодом ISO 4217 і форматуйте її для читача;\nукраїнський читач тоді побачить данську ціну як 800,00 DKK, що й видно з\nрезультату вище.\n\n**Списки сортують за кодовими точками.** Стандартне сортування в JavaScript,\n`sort` без функції порівняння, порівнює кодові одиниці UTF-16, тож Є та І\nопиняються перед рештою української абетки, а Ґ після Я, бо їхні кодові точки\nлежать поза діапазоном від А до я. Відсортований так список Ялта, Ґанок, Гора,\nЄнот, Іван, Дуб стає Єнот, Іван, Гора, Дуб, Ялта, Ґанок; з `new\nIntl.Collator(\"uk\").compare` виходить Гора, Ґанок, Дуб, Єнот, Іван, Ялта, тобто\nпорядок української абетки. Сортуйте текст для показу за локаллю читача, через\n`Intl.Collator` у коді або через правила сортування в базі даних, а порядок\nкодових точок лишайте для ключів, яких не бачить жоден читач.\n\n**Тести порівнюють із відформатованим текстом, набраним уручну.** Тест, який\nочікує `800,00 ₴` зі звичайним пробілом, падає на результаті форматування, бо\nтам стоїть U+00A0, і той самий нерозривний пробіл розділяє групи тисяч у\nнорвезькій, шведській та українській. До того ж дані локалей переглядають від\nодного випуску CLDR до наступного, тож рядок, який збігався до оновлення\nплатформи, після нього може вже не збігатися. Будуйте очікуваний текст тим самим\nзасобом форматування і з тією самою локаллю, що й код, або перевіряйте збережене\nзначення й передану локаль, а не готовий рядок.\n\n**Макет розраховано на англійську.** Кнопка, у яку вміщається Save, має вмістити\nй Зберегти, удвічі довше слово, а меню, де поміщається Settings, має вмістити й\nНалаштування. Фіксована ширина обрізає довше слово або переносить його на другий\nрядок, і часто першим це помічає читач саме на тому ринку. Дайте елементам рости\nразом із текстом, уникайте фіксованої ширини навколо перекладених слів і\nпереглядайте кожну локаль на найвужчому екрані, який підтримує продукт.\n\n## Що почитати далі\n\n- [Localization vs. Internationalization](https://www.w3.org/International/questions/qa-i18n#l10n)\n  — робоче визначення локалізації від W3C, перелік того, що в локалі може\n  потребувати адаптації, і зв'язок локалізації з інтернаціоналізацією.\n- [Hugo: Multilingual mode](https://gohugo.io/content-management/multilingual/)\n  — локалізовані дати, валюти, числа й відсотки в шаблонах Hugo, а також\n  таблиці перекладів і URL для кожної мови.\n- [UTS #35, Part 3: Numbers](https://www.unicode.org/reports/tr35/tr35-numbers.html)\n  — формати чисел і валют у CLDR, зокрема правило, що сума завжди\n  супроводжується кодом валюти.\n- [Unicode CLDR Project](https://cldr.unicode.org/) — проєкт, що збирає дані\n  локалей для понад 100 мов і постачає їх операційним системам, браузерам і\n  мовам програмування.\n\n\u003chttps://engineer.company/uk/glossary/localization/\u003e\n","date_modified":"2026-10-29T11:17:41Z","description":"Що локалізація змінює, крім перекладу, звідки беруться формати дат і цін та порядок сортування, і шість способів схибити на ринку, де продають продукт.","formats":{"gemtext":"https://engineer.company/uk/glossary/localization/index.gmi","gopher":"https://engineer.company/uk/glossary/localization/gophermap","html":"https://engineer.company/uk/glossary/localization/","json":"https://engineer.company/uk/glossary/localization/index.json","markdown":"https://engineer.company/uk/glossary/localization/index.md","pdf":"https://engineer.company/uk/glossary/localization/index.pdf"},"kind":"page","language":"uk","title":"Що таке локалізація?","url":"https://engineer.company/uk/glossary/localization/","version":1}