11cb0ef41Sopenharmony_ci<!DOCTYPE html>
21cb0ef41Sopenharmony_ci<html lang="en">
31cb0ef41Sopenharmony_ci<head>
41cb0ef41Sopenharmony_ci  <meta charset="utf-8">
51cb0ef41Sopenharmony_ci  <meta name="viewport" content="width=device-width">
61cb0ef41Sopenharmony_ci  <meta name="nodejs.org:node-version" content="v18.20.1">
71cb0ef41Sopenharmony_ci  <title>Internationalization support | Node.js v18.20.1 Documentation</title>
81cb0ef41Sopenharmony_ci  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700,400italic&display=fallback">
91cb0ef41Sopenharmony_ci  <link rel="stylesheet" href="assets/style.css">
101cb0ef41Sopenharmony_ci  <link rel="stylesheet" href="assets/hljs.css">
111cb0ef41Sopenharmony_ci  <link rel="canonical" href="https://nodejs.org/api/intl.html">
121cb0ef41Sopenharmony_ci  <script async defer src="assets/api.js" type="text/javascript"></script>
131cb0ef41Sopenharmony_ci  
141cb0ef41Sopenharmony_ci</head>
151cb0ef41Sopenharmony_ci<body class="alt apidoc" id="api-section-intl">
161cb0ef41Sopenharmony_ci  <div id="content" class="clearfix">
171cb0ef41Sopenharmony_ci    <div id="column2" class="interior">
181cb0ef41Sopenharmony_ci      <div id="intro" class="interior">
191cb0ef41Sopenharmony_ci        <a href="/" title="Go back to the home page">
201cb0ef41Sopenharmony_ci          Node.js
211cb0ef41Sopenharmony_ci        </a>
221cb0ef41Sopenharmony_ci      </div>
231cb0ef41Sopenharmony_ci      <ul>
241cb0ef41Sopenharmony_ci<li><a href="documentation.html" class="nav-documentation">About this documentation</a></li>
251cb0ef41Sopenharmony_ci<li><a href="synopsis.html" class="nav-synopsis">Usage and example</a></li>
261cb0ef41Sopenharmony_ci</ul>
271cb0ef41Sopenharmony_ci<hr class="line">
281cb0ef41Sopenharmony_ci<ul>
291cb0ef41Sopenharmony_ci<li><a href="assert.html" class="nav-assert">Assertion testing</a></li>
301cb0ef41Sopenharmony_ci<li><a href="async_context.html" class="nav-async_context">Asynchronous context tracking</a></li>
311cb0ef41Sopenharmony_ci<li><a href="async_hooks.html" class="nav-async_hooks">Async hooks</a></li>
321cb0ef41Sopenharmony_ci<li><a href="buffer.html" class="nav-buffer">Buffer</a></li>
331cb0ef41Sopenharmony_ci<li><a href="addons.html" class="nav-addons">C++ addons</a></li>
341cb0ef41Sopenharmony_ci<li><a href="n-api.html" class="nav-n-api">C/C++ addons with Node-API</a></li>
351cb0ef41Sopenharmony_ci<li><a href="embedding.html" class="nav-embedding">C++ embedder API</a></li>
361cb0ef41Sopenharmony_ci<li><a href="child_process.html" class="nav-child_process">Child processes</a></li>
371cb0ef41Sopenharmony_ci<li><a href="cluster.html" class="nav-cluster">Cluster</a></li>
381cb0ef41Sopenharmony_ci<li><a href="cli.html" class="nav-cli">Command-line options</a></li>
391cb0ef41Sopenharmony_ci<li><a href="console.html" class="nav-console">Console</a></li>
401cb0ef41Sopenharmony_ci<li><a href="corepack.html" class="nav-corepack">Corepack</a></li>
411cb0ef41Sopenharmony_ci<li><a href="crypto.html" class="nav-crypto">Crypto</a></li>
421cb0ef41Sopenharmony_ci<li><a href="debugger.html" class="nav-debugger">Debugger</a></li>
431cb0ef41Sopenharmony_ci<li><a href="deprecations.html" class="nav-deprecations">Deprecated APIs</a></li>
441cb0ef41Sopenharmony_ci<li><a href="diagnostics_channel.html" class="nav-diagnostics_channel">Diagnostics Channel</a></li>
451cb0ef41Sopenharmony_ci<li><a href="dns.html" class="nav-dns">DNS</a></li>
461cb0ef41Sopenharmony_ci<li><a href="domain.html" class="nav-domain">Domain</a></li>
471cb0ef41Sopenharmony_ci<li><a href="errors.html" class="nav-errors">Errors</a></li>
481cb0ef41Sopenharmony_ci<li><a href="events.html" class="nav-events">Events</a></li>
491cb0ef41Sopenharmony_ci<li><a href="fs.html" class="nav-fs">File system</a></li>
501cb0ef41Sopenharmony_ci<li><a href="globals.html" class="nav-globals">Globals</a></li>
511cb0ef41Sopenharmony_ci<li><a href="http.html" class="nav-http">HTTP</a></li>
521cb0ef41Sopenharmony_ci<li><a href="http2.html" class="nav-http2">HTTP/2</a></li>
531cb0ef41Sopenharmony_ci<li><a href="https.html" class="nav-https">HTTPS</a></li>
541cb0ef41Sopenharmony_ci<li><a href="inspector.html" class="nav-inspector">Inspector</a></li>
551cb0ef41Sopenharmony_ci<li><a href="intl.html" class="nav-intl active">Internationalization</a></li>
561cb0ef41Sopenharmony_ci<li><a href="modules.html" class="nav-modules">Modules: CommonJS modules</a></li>
571cb0ef41Sopenharmony_ci<li><a href="esm.html" class="nav-esm">Modules: ECMAScript modules</a></li>
581cb0ef41Sopenharmony_ci<li><a href="module.html" class="nav-module">Modules: <code>node:module</code> API</a></li>
591cb0ef41Sopenharmony_ci<li><a href="packages.html" class="nav-packages">Modules: Packages</a></li>
601cb0ef41Sopenharmony_ci<li><a href="net.html" class="nav-net">Net</a></li>
611cb0ef41Sopenharmony_ci<li><a href="os.html" class="nav-os">OS</a></li>
621cb0ef41Sopenharmony_ci<li><a href="path.html" class="nav-path">Path</a></li>
631cb0ef41Sopenharmony_ci<li><a href="perf_hooks.html" class="nav-perf_hooks">Performance hooks</a></li>
641cb0ef41Sopenharmony_ci<li><a href="permissions.html" class="nav-permissions">Permissions</a></li>
651cb0ef41Sopenharmony_ci<li><a href="process.html" class="nav-process">Process</a></li>
661cb0ef41Sopenharmony_ci<li><a href="punycode.html" class="nav-punycode">Punycode</a></li>
671cb0ef41Sopenharmony_ci<li><a href="querystring.html" class="nav-querystring">Query strings</a></li>
681cb0ef41Sopenharmony_ci<li><a href="readline.html" class="nav-readline">Readline</a></li>
691cb0ef41Sopenharmony_ci<li><a href="repl.html" class="nav-repl">REPL</a></li>
701cb0ef41Sopenharmony_ci<li><a href="report.html" class="nav-report">Report</a></li>
711cb0ef41Sopenharmony_ci<li><a href="single-executable-applications.html" class="nav-single-executable-applications">Single executable applications</a></li>
721cb0ef41Sopenharmony_ci<li><a href="stream.html" class="nav-stream">Stream</a></li>
731cb0ef41Sopenharmony_ci<li><a href="string_decoder.html" class="nav-string_decoder">String decoder</a></li>
741cb0ef41Sopenharmony_ci<li><a href="test.html" class="nav-test">Test runner</a></li>
751cb0ef41Sopenharmony_ci<li><a href="timers.html" class="nav-timers">Timers</a></li>
761cb0ef41Sopenharmony_ci<li><a href="tls.html" class="nav-tls">TLS/SSL</a></li>
771cb0ef41Sopenharmony_ci<li><a href="tracing.html" class="nav-tracing">Trace events</a></li>
781cb0ef41Sopenharmony_ci<li><a href="tty.html" class="nav-tty">TTY</a></li>
791cb0ef41Sopenharmony_ci<li><a href="dgram.html" class="nav-dgram">UDP/datagram</a></li>
801cb0ef41Sopenharmony_ci<li><a href="url.html" class="nav-url">URL</a></li>
811cb0ef41Sopenharmony_ci<li><a href="util.html" class="nav-util">Utilities</a></li>
821cb0ef41Sopenharmony_ci<li><a href="v8.html" class="nav-v8">V8</a></li>
831cb0ef41Sopenharmony_ci<li><a href="vm.html" class="nav-vm">VM</a></li>
841cb0ef41Sopenharmony_ci<li><a href="wasi.html" class="nav-wasi">WASI</a></li>
851cb0ef41Sopenharmony_ci<li><a href="webcrypto.html" class="nav-webcrypto">Web Crypto API</a></li>
861cb0ef41Sopenharmony_ci<li><a href="webstreams.html" class="nav-webstreams">Web Streams API</a></li>
871cb0ef41Sopenharmony_ci<li><a href="worker_threads.html" class="nav-worker_threads">Worker threads</a></li>
881cb0ef41Sopenharmony_ci<li><a href="zlib.html" class="nav-zlib">Zlib</a></li>
891cb0ef41Sopenharmony_ci</ul>
901cb0ef41Sopenharmony_ci<hr class="line">
911cb0ef41Sopenharmony_ci<ul>
921cb0ef41Sopenharmony_ci<li><a href="https://github.com/nodejs/node" class="nav-https-github-com-nodejs-node">Code repository and issue tracker</a></li>
931cb0ef41Sopenharmony_ci</ul>
941cb0ef41Sopenharmony_ci    </div>
951cb0ef41Sopenharmony_ci
961cb0ef41Sopenharmony_ci    <div id="column1" data-id="intl" class="interior">
971cb0ef41Sopenharmony_ci      <header class="header">
981cb0ef41Sopenharmony_ci        <div class="header-container">
991cb0ef41Sopenharmony_ci          <h1>Node.js v18.20.1 documentation</h1>
1001cb0ef41Sopenharmony_ci          <button class="theme-toggle-btn" id="theme-toggle-btn" title="Toggle dark mode/light mode" aria-label="Toggle dark mode/light mode" hidden>
1011cb0ef41Sopenharmony_ci            <svg xmlns="http://www.w3.org/2000/svg" class="icon dark-icon" height="24" width="24">
1021cb0ef41Sopenharmony_ci              <path fill="none" d="M0 0h24v24H0z" />
1031cb0ef41Sopenharmony_ci              <path d="M11.1 12.08c-2.33-4.51-.5-8.48.53-10.07C6.27 2.2 1.98 6.59 1.98 12c0 .14.02.28.02.42.62-.27 1.29-.42 2-.42 1.66 0 3.18.83 4.1 2.15A4.01 4.01 0 0111 18c0 1.52-.87 2.83-2.12 3.51.98.32 2.03.5 3.11.5 3.5 0 6.58-1.8 8.37-4.52-2.36.23-6.98-.97-9.26-5.41z"/>
1041cb0ef41Sopenharmony_ci              <path d="M7 16h-.18C6.4 14.84 5.3 14 4 14c-1.66 0-3 1.34-3 3s1.34 3 3 3h3c1.1 0 2-.9 2-2s-.9-2-2-2z"/>
1051cb0ef41Sopenharmony_ci            </svg>
1061cb0ef41Sopenharmony_ci            <svg xmlns="http://www.w3.org/2000/svg" class="icon light-icon" height="24" width="24">
1071cb0ef41Sopenharmony_ci              <path d="M0 0h24v24H0z" fill="none" />
1081cb0ef41Sopenharmony_ci              <path d="M6.76 4.84l-1.8-1.79-1.41 1.41 1.79 1.79 1.42-1.41zM4 10.5H1v2h3v-2zm9-9.95h-2V3.5h2V.55zm7.45 3.91l-1.41-1.41-1.79 1.79 1.41 1.41 1.79-1.79zm-3.21 13.7l1.79 1.8 1.41-1.41-1.8-1.79-1.4 1.4zM20 10.5v2h3v-2h-3zm-8-5c-3.31 0-6 2.69-6 6s2.69 6 6 6 6-2.69 6-6-2.69-6-6-6zm-1 16.95h2V19.5h-2v2.95zm-7.45-3.91l1.41 1.41 1.79-1.8-1.41-1.41-1.79 1.8z"/>
1091cb0ef41Sopenharmony_ci            </svg>
1101cb0ef41Sopenharmony_ci          </button>
1111cb0ef41Sopenharmony_ci        </div>
1121cb0ef41Sopenharmony_ci        <div id="gtoc">
1131cb0ef41Sopenharmony_ci          <ul>
1141cb0ef41Sopenharmony_ci            <li class="pinned-header">Node.js v18.20.1</li>
1151cb0ef41Sopenharmony_ci            
1161cb0ef41Sopenharmony_ci    <li class="picker-header">
1171cb0ef41Sopenharmony_ci      <a href="#">
1181cb0ef41Sopenharmony_ci        <span class="collapsed-arrow">&#x25ba;</span><span class="expanded-arrow">&#x25bc;</span>
1191cb0ef41Sopenharmony_ci        Table of contents
1201cb0ef41Sopenharmony_ci      </a>
1211cb0ef41Sopenharmony_ci
1221cb0ef41Sopenharmony_ci      <div class="picker"><div class="toc"><ul>
1231cb0ef41Sopenharmony_ci<li><a href="#internationalization-support">Internationalization support</a>
1241cb0ef41Sopenharmony_ci<ul>
1251cb0ef41Sopenharmony_ci<li><a href="#options-for-building-nodejs">Options for building Node.js</a>
1261cb0ef41Sopenharmony_ci<ul>
1271cb0ef41Sopenharmony_ci<li><a href="#disable-all-internationalization-features-none">Disable all internationalization features (<code>none</code>)</a></li>
1281cb0ef41Sopenharmony_ci<li><a href="#build-with-a-pre-installed-icu-system-icu">Build with a pre-installed ICU (<code>system-icu</code>)</a></li>
1291cb0ef41Sopenharmony_ci<li><a href="#embed-a-limited-set-of-icu-data-small-icu">Embed a limited set of ICU data (<code>small-icu</code>)</a>
1301cb0ef41Sopenharmony_ci<ul>
1311cb0ef41Sopenharmony_ci<li><a href="#providing-icu-data-at-runtime">Providing ICU data at runtime</a></li>
1321cb0ef41Sopenharmony_ci</ul>
1331cb0ef41Sopenharmony_ci</li>
1341cb0ef41Sopenharmony_ci<li><a href="#embed-the-entire-icu-full-icu">Embed the entire ICU (<code>full-icu</code>)</a></li>
1351cb0ef41Sopenharmony_ci</ul>
1361cb0ef41Sopenharmony_ci</li>
1371cb0ef41Sopenharmony_ci<li><a href="#detecting-internationalization-support">Detecting internationalization support</a></li>
1381cb0ef41Sopenharmony_ci</ul>
1391cb0ef41Sopenharmony_ci</li>
1401cb0ef41Sopenharmony_ci</ul></div></div>
1411cb0ef41Sopenharmony_ci    </li>
1421cb0ef41Sopenharmony_ci  
1431cb0ef41Sopenharmony_ci            
1441cb0ef41Sopenharmony_ci    <li class="picker-header">
1451cb0ef41Sopenharmony_ci      <a href="#">
1461cb0ef41Sopenharmony_ci        <span class="collapsed-arrow">&#x25ba;</span><span class="expanded-arrow">&#x25bc;</span>
1471cb0ef41Sopenharmony_ci        Index
1481cb0ef41Sopenharmony_ci      </a>
1491cb0ef41Sopenharmony_ci
1501cb0ef41Sopenharmony_ci      <div class="picker"><ul>
1511cb0ef41Sopenharmony_ci<li><a href="documentation.html" class="nav-documentation">About this documentation</a></li>
1521cb0ef41Sopenharmony_ci<li><a href="synopsis.html" class="nav-synopsis">Usage and example</a></li>
1531cb0ef41Sopenharmony_ci
1541cb0ef41Sopenharmony_ci      <li>
1551cb0ef41Sopenharmony_ci        <a href="index.html">Index</a>
1561cb0ef41Sopenharmony_ci      </li>
1571cb0ef41Sopenharmony_ci    </ul>
1581cb0ef41Sopenharmony_ci  
1591cb0ef41Sopenharmony_ci<hr class="line">
1601cb0ef41Sopenharmony_ci<ul>
1611cb0ef41Sopenharmony_ci<li><a href="assert.html" class="nav-assert">Assertion testing</a></li>
1621cb0ef41Sopenharmony_ci<li><a href="async_context.html" class="nav-async_context">Asynchronous context tracking</a></li>
1631cb0ef41Sopenharmony_ci<li><a href="async_hooks.html" class="nav-async_hooks">Async hooks</a></li>
1641cb0ef41Sopenharmony_ci<li><a href="buffer.html" class="nav-buffer">Buffer</a></li>
1651cb0ef41Sopenharmony_ci<li><a href="addons.html" class="nav-addons">C++ addons</a></li>
1661cb0ef41Sopenharmony_ci<li><a href="n-api.html" class="nav-n-api">C/C++ addons with Node-API</a></li>
1671cb0ef41Sopenharmony_ci<li><a href="embedding.html" class="nav-embedding">C++ embedder API</a></li>
1681cb0ef41Sopenharmony_ci<li><a href="child_process.html" class="nav-child_process">Child processes</a></li>
1691cb0ef41Sopenharmony_ci<li><a href="cluster.html" class="nav-cluster">Cluster</a></li>
1701cb0ef41Sopenharmony_ci<li><a href="cli.html" class="nav-cli">Command-line options</a></li>
1711cb0ef41Sopenharmony_ci<li><a href="console.html" class="nav-console">Console</a></li>
1721cb0ef41Sopenharmony_ci<li><a href="corepack.html" class="nav-corepack">Corepack</a></li>
1731cb0ef41Sopenharmony_ci<li><a href="crypto.html" class="nav-crypto">Crypto</a></li>
1741cb0ef41Sopenharmony_ci<li><a href="debugger.html" class="nav-debugger">Debugger</a></li>
1751cb0ef41Sopenharmony_ci<li><a href="deprecations.html" class="nav-deprecations">Deprecated APIs</a></li>
1761cb0ef41Sopenharmony_ci<li><a href="diagnostics_channel.html" class="nav-diagnostics_channel">Diagnostics Channel</a></li>
1771cb0ef41Sopenharmony_ci<li><a href="dns.html" class="nav-dns">DNS</a></li>
1781cb0ef41Sopenharmony_ci<li><a href="domain.html" class="nav-domain">Domain</a></li>
1791cb0ef41Sopenharmony_ci<li><a href="errors.html" class="nav-errors">Errors</a></li>
1801cb0ef41Sopenharmony_ci<li><a href="events.html" class="nav-events">Events</a></li>
1811cb0ef41Sopenharmony_ci<li><a href="fs.html" class="nav-fs">File system</a></li>
1821cb0ef41Sopenharmony_ci<li><a href="globals.html" class="nav-globals">Globals</a></li>
1831cb0ef41Sopenharmony_ci<li><a href="http.html" class="nav-http">HTTP</a></li>
1841cb0ef41Sopenharmony_ci<li><a href="http2.html" class="nav-http2">HTTP/2</a></li>
1851cb0ef41Sopenharmony_ci<li><a href="https.html" class="nav-https">HTTPS</a></li>
1861cb0ef41Sopenharmony_ci<li><a href="inspector.html" class="nav-inspector">Inspector</a></li>
1871cb0ef41Sopenharmony_ci<li><a href="intl.html" class="nav-intl active">Internationalization</a></li>
1881cb0ef41Sopenharmony_ci<li><a href="modules.html" class="nav-modules">Modules: CommonJS modules</a></li>
1891cb0ef41Sopenharmony_ci<li><a href="esm.html" class="nav-esm">Modules: ECMAScript modules</a></li>
1901cb0ef41Sopenharmony_ci<li><a href="module.html" class="nav-module">Modules: <code>node:module</code> API</a></li>
1911cb0ef41Sopenharmony_ci<li><a href="packages.html" class="nav-packages">Modules: Packages</a></li>
1921cb0ef41Sopenharmony_ci<li><a href="net.html" class="nav-net">Net</a></li>
1931cb0ef41Sopenharmony_ci<li><a href="os.html" class="nav-os">OS</a></li>
1941cb0ef41Sopenharmony_ci<li><a href="path.html" class="nav-path">Path</a></li>
1951cb0ef41Sopenharmony_ci<li><a href="perf_hooks.html" class="nav-perf_hooks">Performance hooks</a></li>
1961cb0ef41Sopenharmony_ci<li><a href="permissions.html" class="nav-permissions">Permissions</a></li>
1971cb0ef41Sopenharmony_ci<li><a href="process.html" class="nav-process">Process</a></li>
1981cb0ef41Sopenharmony_ci<li><a href="punycode.html" class="nav-punycode">Punycode</a></li>
1991cb0ef41Sopenharmony_ci<li><a href="querystring.html" class="nav-querystring">Query strings</a></li>
2001cb0ef41Sopenharmony_ci<li><a href="readline.html" class="nav-readline">Readline</a></li>
2011cb0ef41Sopenharmony_ci<li><a href="repl.html" class="nav-repl">REPL</a></li>
2021cb0ef41Sopenharmony_ci<li><a href="report.html" class="nav-report">Report</a></li>
2031cb0ef41Sopenharmony_ci<li><a href="single-executable-applications.html" class="nav-single-executable-applications">Single executable applications</a></li>
2041cb0ef41Sopenharmony_ci<li><a href="stream.html" class="nav-stream">Stream</a></li>
2051cb0ef41Sopenharmony_ci<li><a href="string_decoder.html" class="nav-string_decoder">String decoder</a></li>
2061cb0ef41Sopenharmony_ci<li><a href="test.html" class="nav-test">Test runner</a></li>
2071cb0ef41Sopenharmony_ci<li><a href="timers.html" class="nav-timers">Timers</a></li>
2081cb0ef41Sopenharmony_ci<li><a href="tls.html" class="nav-tls">TLS/SSL</a></li>
2091cb0ef41Sopenharmony_ci<li><a href="tracing.html" class="nav-tracing">Trace events</a></li>
2101cb0ef41Sopenharmony_ci<li><a href="tty.html" class="nav-tty">TTY</a></li>
2111cb0ef41Sopenharmony_ci<li><a href="dgram.html" class="nav-dgram">UDP/datagram</a></li>
2121cb0ef41Sopenharmony_ci<li><a href="url.html" class="nav-url">URL</a></li>
2131cb0ef41Sopenharmony_ci<li><a href="util.html" class="nav-util">Utilities</a></li>
2141cb0ef41Sopenharmony_ci<li><a href="v8.html" class="nav-v8">V8</a></li>
2151cb0ef41Sopenharmony_ci<li><a href="vm.html" class="nav-vm">VM</a></li>
2161cb0ef41Sopenharmony_ci<li><a href="wasi.html" class="nav-wasi">WASI</a></li>
2171cb0ef41Sopenharmony_ci<li><a href="webcrypto.html" class="nav-webcrypto">Web Crypto API</a></li>
2181cb0ef41Sopenharmony_ci<li><a href="webstreams.html" class="nav-webstreams">Web Streams API</a></li>
2191cb0ef41Sopenharmony_ci<li><a href="worker_threads.html" class="nav-worker_threads">Worker threads</a></li>
2201cb0ef41Sopenharmony_ci<li><a href="zlib.html" class="nav-zlib">Zlib</a></li>
2211cb0ef41Sopenharmony_ci</ul>
2221cb0ef41Sopenharmony_ci<hr class="line">
2231cb0ef41Sopenharmony_ci<ul>
2241cb0ef41Sopenharmony_ci<li><a href="https://github.com/nodejs/node" class="nav-https-github-com-nodejs-node">Code repository and issue tracker</a></li>
2251cb0ef41Sopenharmony_ci</ul></div>
2261cb0ef41Sopenharmony_ci    </li>
2271cb0ef41Sopenharmony_ci  
2281cb0ef41Sopenharmony_ci            
2291cb0ef41Sopenharmony_ci    <li class="picker-header">
2301cb0ef41Sopenharmony_ci      <a href="#">
2311cb0ef41Sopenharmony_ci        <span class="collapsed-arrow">&#x25ba;</span><span class="expanded-arrow">&#x25bc;</span>
2321cb0ef41Sopenharmony_ci        Other versions
2331cb0ef41Sopenharmony_ci      </a>
2341cb0ef41Sopenharmony_ci      <div class="picker"><ol id="alt-docs"><li><a href="https://nodejs.org/docs/latest-v21.x/api/intl.html">21.x</a></li>
2351cb0ef41Sopenharmony_ci<li><a href="https://nodejs.org/docs/latest-v20.x/api/intl.html">20.x <b>LTS</b></a></li>
2361cb0ef41Sopenharmony_ci<li><a href="https://nodejs.org/docs/latest-v19.x/api/intl.html">19.x</a></li>
2371cb0ef41Sopenharmony_ci<li><a href="https://nodejs.org/docs/latest-v18.x/api/intl.html">18.x <b>LTS</b></a></li>
2381cb0ef41Sopenharmony_ci<li><a href="https://nodejs.org/docs/latest-v17.x/api/intl.html">17.x</a></li>
2391cb0ef41Sopenharmony_ci<li><a href="https://nodejs.org/docs/latest-v16.x/api/intl.html">16.x</a></li>
2401cb0ef41Sopenharmony_ci<li><a href="https://nodejs.org/docs/latest-v15.x/api/intl.html">15.x</a></li>
2411cb0ef41Sopenharmony_ci<li><a href="https://nodejs.org/docs/latest-v14.x/api/intl.html">14.x</a></li>
2421cb0ef41Sopenharmony_ci<li><a href="https://nodejs.org/docs/latest-v13.x/api/intl.html">13.x</a></li>
2431cb0ef41Sopenharmony_ci<li><a href="https://nodejs.org/docs/latest-v12.x/api/intl.html">12.x</a></li>
2441cb0ef41Sopenharmony_ci<li><a href="https://nodejs.org/docs/latest-v11.x/api/intl.html">11.x</a></li>
2451cb0ef41Sopenharmony_ci<li><a href="https://nodejs.org/docs/latest-v10.x/api/intl.html">10.x</a></li>
2461cb0ef41Sopenharmony_ci<li><a href="https://nodejs.org/docs/latest-v9.x/api/intl.html">9.x</a></li>
2471cb0ef41Sopenharmony_ci<li><a href="https://nodejs.org/docs/latest-v8.x/api/intl.html">8.x</a></li></ol></div>
2481cb0ef41Sopenharmony_ci    </li>
2491cb0ef41Sopenharmony_ci  
2501cb0ef41Sopenharmony_ci            <li class="picker-header">
2511cb0ef41Sopenharmony_ci              <a href="#">
2521cb0ef41Sopenharmony_ci                <span class="collapsed-arrow">&#x25ba;</span><span class="expanded-arrow">&#x25bc;</span>
2531cb0ef41Sopenharmony_ci                Options
2541cb0ef41Sopenharmony_ci              </a>
2551cb0ef41Sopenharmony_ci        
2561cb0ef41Sopenharmony_ci              <div class="picker">
2571cb0ef41Sopenharmony_ci                <ul>
2581cb0ef41Sopenharmony_ci                  <li>
2591cb0ef41Sopenharmony_ci                    <a href="all.html">View on single page</a>
2601cb0ef41Sopenharmony_ci                  </li>
2611cb0ef41Sopenharmony_ci                  <li>
2621cb0ef41Sopenharmony_ci                    <a href="intl.json">View as JSON</a>
2631cb0ef41Sopenharmony_ci                  </li>
2641cb0ef41Sopenharmony_ci                  <li class="edit_on_github"><a href="https://github.com/nodejs/node/edit/main/doc/api/intl.md">Edit on GitHub</a></li>    
2651cb0ef41Sopenharmony_ci                </ul>
2661cb0ef41Sopenharmony_ci              </div>
2671cb0ef41Sopenharmony_ci            </li>
2681cb0ef41Sopenharmony_ci          </ul>
2691cb0ef41Sopenharmony_ci        </div>
2701cb0ef41Sopenharmony_ci        <hr>
2711cb0ef41Sopenharmony_ci      </header>
2721cb0ef41Sopenharmony_ci
2731cb0ef41Sopenharmony_ci      <details id="toc" open><summary>Table of contents</summary><ul>
2741cb0ef41Sopenharmony_ci<li><a href="#internationalization-support">Internationalization support</a>
2751cb0ef41Sopenharmony_ci<ul>
2761cb0ef41Sopenharmony_ci<li><a href="#options-for-building-nodejs">Options for building Node.js</a>
2771cb0ef41Sopenharmony_ci<ul>
2781cb0ef41Sopenharmony_ci<li><a href="#disable-all-internationalization-features-none">Disable all internationalization features (<code>none</code>)</a></li>
2791cb0ef41Sopenharmony_ci<li><a href="#build-with-a-pre-installed-icu-system-icu">Build with a pre-installed ICU (<code>system-icu</code>)</a></li>
2801cb0ef41Sopenharmony_ci<li><a href="#embed-a-limited-set-of-icu-data-small-icu">Embed a limited set of ICU data (<code>small-icu</code>)</a>
2811cb0ef41Sopenharmony_ci<ul>
2821cb0ef41Sopenharmony_ci<li><a href="#providing-icu-data-at-runtime">Providing ICU data at runtime</a></li>
2831cb0ef41Sopenharmony_ci</ul>
2841cb0ef41Sopenharmony_ci</li>
2851cb0ef41Sopenharmony_ci<li><a href="#embed-the-entire-icu-full-icu">Embed the entire ICU (<code>full-icu</code>)</a></li>
2861cb0ef41Sopenharmony_ci</ul>
2871cb0ef41Sopenharmony_ci</li>
2881cb0ef41Sopenharmony_ci<li><a href="#detecting-internationalization-support">Detecting internationalization support</a></li>
2891cb0ef41Sopenharmony_ci</ul>
2901cb0ef41Sopenharmony_ci</li>
2911cb0ef41Sopenharmony_ci</ul></details>
2921cb0ef41Sopenharmony_ci
2931cb0ef41Sopenharmony_ci      <div id="apicontent">
2941cb0ef41Sopenharmony_ci        <h2>Internationalization support<span><a class="mark" href="#internationalization-support" id="internationalization-support">#</a></span><a aria-hidden="true" class="legacy" id="intl_internationalization_support"></a></h2>
2951cb0ef41Sopenharmony_ci
2961cb0ef41Sopenharmony_ci
2971cb0ef41Sopenharmony_ci<p>Node.js has many features that make it easier to write internationalized
2981cb0ef41Sopenharmony_ciprograms. Some of them are:</p>
2991cb0ef41Sopenharmony_ci<ul>
3001cb0ef41Sopenharmony_ci<li>Locale-sensitive or Unicode-aware functions in the <a href="https://tc39.github.io/ecma262/">ECMAScript Language
3011cb0ef41Sopenharmony_ciSpecification</a>:
3021cb0ef41Sopenharmony_ci<ul>
3031cb0ef41Sopenharmony_ci<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/normalize"><code>String.prototype.normalize()</code></a></li>
3041cb0ef41Sopenharmony_ci<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toLowerCase"><code>String.prototype.toLowerCase()</code></a></li>
3051cb0ef41Sopenharmony_ci<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toUpperCase"><code>String.prototype.toUpperCase()</code></a></li>
3061cb0ef41Sopenharmony_ci</ul>
3071cb0ef41Sopenharmony_ci</li>
3081cb0ef41Sopenharmony_ci<li>All functionality described in the <a href="https://tc39.github.io/ecma402/">ECMAScript Internationalization API
3091cb0ef41Sopenharmony_ciSpecification</a> (aka ECMA-402):
3101cb0ef41Sopenharmony_ci<ul>
3111cb0ef41Sopenharmony_ci<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl"><code>Intl</code></a> object</li>
3121cb0ef41Sopenharmony_ci<li>Locale-sensitive methods like <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/localeCompare"><code>String.prototype.localeCompare()</code></a> and
3131cb0ef41Sopenharmony_ci<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toLocaleString"><code>Date.prototype.toLocaleString()</code></a></li>
3141cb0ef41Sopenharmony_ci</ul>
3151cb0ef41Sopenharmony_ci</li>
3161cb0ef41Sopenharmony_ci<li>The <a href="url.html#the-whatwg-url-api">WHATWG URL parser</a>'s <a href="https://en.wikipedia.org/wiki/Internationalized_domain_name">internationalized domain names</a> (IDNs) support</li>
3171cb0ef41Sopenharmony_ci<li><a href="buffer.html#buffertranscodesource-fromenc-toenc"><code>require('node:buffer').transcode()</code></a></li>
3181cb0ef41Sopenharmony_ci<li>More accurate <a href="repl.html#repl">REPL</a> line editing</li>
3191cb0ef41Sopenharmony_ci<li><a href="util.html#class-utiltextdecoder"><code>require('node:util').TextDecoder</code></a></li>
3201cb0ef41Sopenharmony_ci<li><a href="https://github.com/tc39/proposal-regexp-unicode-property-escapes"><code>RegExp</code> Unicode Property Escapes</a></li>
3211cb0ef41Sopenharmony_ci</ul>
3221cb0ef41Sopenharmony_ci<p>Node.js and the underlying V8 engine use
3231cb0ef41Sopenharmony_ci<a href="http://site.icu-project.org/">International Components for Unicode (ICU)</a> to implement these features
3241cb0ef41Sopenharmony_ciin native C/C++ code. The full ICU data set is provided by Node.js by default.
3251cb0ef41Sopenharmony_ciHowever, due to the size of the ICU data file, several
3261cb0ef41Sopenharmony_cioptions are provided for customizing the ICU data set either when
3271cb0ef41Sopenharmony_cibuilding or running Node.js.</p>
3281cb0ef41Sopenharmony_ci<section><h3>Options for building Node.js<span><a class="mark" href="#options-for-building-nodejs" id="options-for-building-nodejs">#</a></span><a aria-hidden="true" class="legacy" id="intl_options_for_building_node_js"></a></h3>
3291cb0ef41Sopenharmony_ci<p>To control how ICU is used in Node.js, four <code>configure</code> options are available
3301cb0ef41Sopenharmony_ciduring compilation. Additional details on how to compile Node.js are documented
3311cb0ef41Sopenharmony_ciin <a href="https://github.com/nodejs/node/blob/HEAD/BUILDING.md">BUILDING.md</a>.</p>
3321cb0ef41Sopenharmony_ci<ul>
3331cb0ef41Sopenharmony_ci<li><code>--with-intl=none</code>/<code>--without-intl</code></li>
3341cb0ef41Sopenharmony_ci<li><code>--with-intl=system-icu</code></li>
3351cb0ef41Sopenharmony_ci<li><code>--with-intl=small-icu</code></li>
3361cb0ef41Sopenharmony_ci<li><code>--with-intl=full-icu</code> (default)</li>
3371cb0ef41Sopenharmony_ci</ul>
3381cb0ef41Sopenharmony_ci<p>An overview of available Node.js and JavaScript features for each <code>configure</code>
3391cb0ef41Sopenharmony_cioption:</p>
3401cb0ef41Sopenharmony_ci
3411cb0ef41Sopenharmony_ci
3421cb0ef41Sopenharmony_ci
3431cb0ef41Sopenharmony_ci
3441cb0ef41Sopenharmony_ci
3451cb0ef41Sopenharmony_ci
3461cb0ef41Sopenharmony_ci
3471cb0ef41Sopenharmony_ci
3481cb0ef41Sopenharmony_ci
3491cb0ef41Sopenharmony_ci
3501cb0ef41Sopenharmony_ci
3511cb0ef41Sopenharmony_ci
3521cb0ef41Sopenharmony_ci
3531cb0ef41Sopenharmony_ci
3541cb0ef41Sopenharmony_ci
3551cb0ef41Sopenharmony_ci
3561cb0ef41Sopenharmony_ci
3571cb0ef41Sopenharmony_ci
3581cb0ef41Sopenharmony_ci
3591cb0ef41Sopenharmony_ci
3601cb0ef41Sopenharmony_ci
3611cb0ef41Sopenharmony_ci
3621cb0ef41Sopenharmony_ci
3631cb0ef41Sopenharmony_ci
3641cb0ef41Sopenharmony_ci
3651cb0ef41Sopenharmony_ci
3661cb0ef41Sopenharmony_ci
3671cb0ef41Sopenharmony_ci
3681cb0ef41Sopenharmony_ci
3691cb0ef41Sopenharmony_ci
3701cb0ef41Sopenharmony_ci
3711cb0ef41Sopenharmony_ci
3721cb0ef41Sopenharmony_ci
3731cb0ef41Sopenharmony_ci
3741cb0ef41Sopenharmony_ci
3751cb0ef41Sopenharmony_ci
3761cb0ef41Sopenharmony_ci
3771cb0ef41Sopenharmony_ci
3781cb0ef41Sopenharmony_ci
3791cb0ef41Sopenharmony_ci
3801cb0ef41Sopenharmony_ci
3811cb0ef41Sopenharmony_ci
3821cb0ef41Sopenharmony_ci
3831cb0ef41Sopenharmony_ci
3841cb0ef41Sopenharmony_ci
3851cb0ef41Sopenharmony_ci
3861cb0ef41Sopenharmony_ci
3871cb0ef41Sopenharmony_ci
3881cb0ef41Sopenharmony_ci
3891cb0ef41Sopenharmony_ci
3901cb0ef41Sopenharmony_ci
3911cb0ef41Sopenharmony_ci
3921cb0ef41Sopenharmony_ci
3931cb0ef41Sopenharmony_ci
3941cb0ef41Sopenharmony_ci
3951cb0ef41Sopenharmony_ci
3961cb0ef41Sopenharmony_ci
3971cb0ef41Sopenharmony_ci
3981cb0ef41Sopenharmony_ci
3991cb0ef41Sopenharmony_ci
4001cb0ef41Sopenharmony_ci
4011cb0ef41Sopenharmony_ci
4021cb0ef41Sopenharmony_ci
4031cb0ef41Sopenharmony_ci
4041cb0ef41Sopenharmony_ci
4051cb0ef41Sopenharmony_ci
4061cb0ef41Sopenharmony_ci
4071cb0ef41Sopenharmony_ci
4081cb0ef41Sopenharmony_ci
4091cb0ef41Sopenharmony_ci
4101cb0ef41Sopenharmony_ci
4111cb0ef41Sopenharmony_ci
4121cb0ef41Sopenharmony_ci
4131cb0ef41Sopenharmony_ci
4141cb0ef41Sopenharmony_ci
4151cb0ef41Sopenharmony_ci
4161cb0ef41Sopenharmony_ci
4171cb0ef41Sopenharmony_ci
4181cb0ef41Sopenharmony_ci
4191cb0ef41Sopenharmony_ci
4201cb0ef41Sopenharmony_ci
4211cb0ef41Sopenharmony_ci
4221cb0ef41Sopenharmony_ci
4231cb0ef41Sopenharmony_ci
4241cb0ef41Sopenharmony_ci
4251cb0ef41Sopenharmony_ci
4261cb0ef41Sopenharmony_ci
4271cb0ef41Sopenharmony_ci
4281cb0ef41Sopenharmony_ci
4291cb0ef41Sopenharmony_ci
4301cb0ef41Sopenharmony_ci
4311cb0ef41Sopenharmony_ci
4321cb0ef41Sopenharmony_ci
4331cb0ef41Sopenharmony_ci
4341cb0ef41Sopenharmony_ci
4351cb0ef41Sopenharmony_ci
4361cb0ef41Sopenharmony_ci
4371cb0ef41Sopenharmony_ci
4381cb0ef41Sopenharmony_ci
4391cb0ef41Sopenharmony_ci
4401cb0ef41Sopenharmony_ci
4411cb0ef41Sopenharmony_ci
4421cb0ef41Sopenharmony_ci
4431cb0ef41Sopenharmony_ci<table><thead><tr><th>Feature</th><th><code>none</code></th><th><code>system-icu</code></th><th><code>small-icu</code></th><th><code>full-icu</code></th></tr></thead><tbody><tr><td><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/normalize"><code>String.prototype.normalize()</code></a></td><td>none (function is no-op)</td><td>full</td><td>full</td><td>full</td></tr><tr><td><code>String.prototype.to*Case()</code></td><td>full</td><td>full</td><td>full</td><td>full</td></tr><tr><td><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl"><code>Intl</code></a></td><td>none (object does not exist)</td><td>partial/full (depends on OS)</td><td>partial (English-only)</td><td>full</td></tr><tr><td><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/localeCompare"><code>String.prototype.localeCompare()</code></a></td><td>partial (not locale-aware)</td><td>full</td><td>full</td><td>full</td></tr><tr><td><code>String.prototype.toLocale*Case()</code></td><td>partial (not locale-aware)</td><td>full</td><td>full</td><td>full</td></tr><tr><td><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/toLocaleString"><code>Number.prototype.toLocaleString()</code></a></td><td>partial (not locale-aware)</td><td>partial/full (depends on OS)</td><td>partial (English-only)</td><td>full</td></tr><tr><td><code>Date.prototype.toLocale*String()</code></td><td>partial (not locale-aware)</td><td>partial/full (depends on OS)</td><td>partial (English-only)</td><td>full</td></tr><tr><td><a href="url.html#legacy-url-api">Legacy URL Parser</a></td><td>partial (no IDN support)</td><td>full</td><td>full</td><td>full</td></tr><tr><td><a href="url.html#the-whatwg-url-api">WHATWG URL Parser</a></td><td>partial (no IDN support)</td><td>full</td><td>full</td><td>full</td></tr><tr><td><a href="buffer.html#buffertranscodesource-fromenc-toenc"><code>require('node:buffer').transcode()</code></a></td><td>none (function does not exist)</td><td>full</td><td>full</td><td>full</td></tr><tr><td><a href="repl.html#repl">REPL</a></td><td>partial (inaccurate line editing)</td><td>full</td><td>full</td><td>full</td></tr><tr><td><a href="util.html#class-utiltextdecoder"><code>require('node:util').TextDecoder</code></a></td><td>partial (basic encodings support)</td><td>partial/full (depends on OS)</td><td>partial (Unicode-only)</td><td>full</td></tr><tr><td><a href="https://github.com/tc39/proposal-regexp-unicode-property-escapes"><code>RegExp</code> Unicode Property Escapes</a></td><td>none (invalid <code>RegExp</code> error)</td><td>full</td><td>full</td><td>full</td></tr></tbody></table>
4441cb0ef41Sopenharmony_ci<p>The "(not locale-aware)" designation denotes that the function carries out its
4451cb0ef41Sopenharmony_cioperation just like the non-<code>Locale</code> version of the function, if one
4461cb0ef41Sopenharmony_ciexists. For example, under <code>none</code> mode, <code>Date.prototype.toLocaleString()</code>'s
4471cb0ef41Sopenharmony_cioperation is identical to that of <code>Date.prototype.toString()</code>.</p>
4481cb0ef41Sopenharmony_ci<h4>Disable all internationalization features (<code>none</code>)<span><a class="mark" href="#disable-all-internationalization-features-none" id="disable-all-internationalization-features-none">#</a></span><a aria-hidden="true" class="legacy" id="intl_disable_all_internationalization_features_none"></a></h4>
4491cb0ef41Sopenharmony_ci<p>If this option is chosen, ICU is disabled and most internationalization
4501cb0ef41Sopenharmony_cifeatures mentioned above will be <strong>unavailable</strong> in the resulting <code>node</code> binary.</p>
4511cb0ef41Sopenharmony_ci<h4>Build with a pre-installed ICU (<code>system-icu</code>)<span><a class="mark" href="#build-with-a-pre-installed-icu-system-icu" id="build-with-a-pre-installed-icu-system-icu">#</a></span><a aria-hidden="true" class="legacy" id="intl_build_with_a_pre_installed_icu_system_icu"></a></h4>
4521cb0ef41Sopenharmony_ci<p>Node.js can link against an ICU build already installed on the system. In fact,
4531cb0ef41Sopenharmony_cimost Linux distributions already come with ICU installed, and this option would
4541cb0ef41Sopenharmony_cimake it possible to reuse the same set of data used by other components in the
4551cb0ef41Sopenharmony_ciOS.</p>
4561cb0ef41Sopenharmony_ci<p>Functionalities that only require the ICU library itself, such as
4571cb0ef41Sopenharmony_ci<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/normalize"><code>String.prototype.normalize()</code></a> and the <a href="url.html#the-whatwg-url-api">WHATWG URL parser</a>, are fully
4581cb0ef41Sopenharmony_cisupported under <code>system-icu</code>. Features that require ICU locale data in
4591cb0ef41Sopenharmony_ciaddition, such as <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat"><code>Intl.DateTimeFormat</code></a> <em>may</em> be fully or partially
4601cb0ef41Sopenharmony_cisupported, depending on the completeness of the ICU data installed on the
4611cb0ef41Sopenharmony_cisystem.</p>
4621cb0ef41Sopenharmony_ci<h4>Embed a limited set of ICU data (<code>small-icu</code>)<span><a class="mark" href="#embed-a-limited-set-of-icu-data-small-icu" id="embed-a-limited-set-of-icu-data-small-icu">#</a></span><a aria-hidden="true" class="legacy" id="intl_embed_a_limited_set_of_icu_data_small_icu"></a></h4>
4631cb0ef41Sopenharmony_ci<p>This option makes the resulting binary link against the ICU library statically,
4641cb0ef41Sopenharmony_ciand includes a subset of ICU data (typically only the English locale) within
4651cb0ef41Sopenharmony_cithe <code>node</code> executable.</p>
4661cb0ef41Sopenharmony_ci<p>Functionalities that only require the ICU library itself, such as
4671cb0ef41Sopenharmony_ci<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/normalize"><code>String.prototype.normalize()</code></a> and the <a href="url.html#the-whatwg-url-api">WHATWG URL parser</a>, are fully
4681cb0ef41Sopenharmony_cisupported under <code>small-icu</code>. Features that require ICU locale data in addition,
4691cb0ef41Sopenharmony_cisuch as <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat"><code>Intl.DateTimeFormat</code></a>, generally only work with the English locale:</p>
4701cb0ef41Sopenharmony_ci<pre><code class="language-js"><span class="hljs-keyword">const</span> january = <span class="hljs-keyword">new</span> <span class="hljs-title class_">Date</span>(<span class="hljs-number">9e8</span>);
4711cb0ef41Sopenharmony_ci<span class="hljs-keyword">const</span> english = <span class="hljs-keyword">new</span> <span class="hljs-title class_">Intl</span>.<span class="hljs-title class_">DateTimeFormat</span>(<span class="hljs-string">'en'</span>, { <span class="hljs-attr">month</span>: <span class="hljs-string">'long'</span> });
4721cb0ef41Sopenharmony_ci<span class="hljs-keyword">const</span> spanish = <span class="hljs-keyword">new</span> <span class="hljs-title class_">Intl</span>.<span class="hljs-title class_">DateTimeFormat</span>(<span class="hljs-string">'es'</span>, { <span class="hljs-attr">month</span>: <span class="hljs-string">'long'</span> });
4731cb0ef41Sopenharmony_ci
4741cb0ef41Sopenharmony_ci<span class="hljs-variable language_">console</span>.<span class="hljs-title function_">log</span>(english.<span class="hljs-title function_">format</span>(january));
4751cb0ef41Sopenharmony_ci<span class="hljs-comment">// Prints "January"</span>
4761cb0ef41Sopenharmony_ci<span class="hljs-variable language_">console</span>.<span class="hljs-title function_">log</span>(spanish.<span class="hljs-title function_">format</span>(january));
4771cb0ef41Sopenharmony_ci<span class="hljs-comment">// Prints either "M01" or "January" on small-icu, depending on the user’s default locale</span>
4781cb0ef41Sopenharmony_ci<span class="hljs-comment">// Should print "enero"</span></code> <button class="copy-button">copy</button></pre>
4791cb0ef41Sopenharmony_ci<p>This mode provides a balance between features and binary size.</p>
4801cb0ef41Sopenharmony_ci<h5>Providing ICU data at runtime<span><a class="mark" href="#providing-icu-data-at-runtime" id="providing-icu-data-at-runtime">#</a></span><a aria-hidden="true" class="legacy" id="intl_providing_icu_data_at_runtime"></a></h5>
4811cb0ef41Sopenharmony_ci<p>If the <code>small-icu</code> option is used, one can still provide additional locale data
4821cb0ef41Sopenharmony_ciat runtime so that the JS methods would work for all ICU locales. Assuming the
4831cb0ef41Sopenharmony_cidata file is stored at <code>/some/directory</code>, it can be made available to ICU
4841cb0ef41Sopenharmony_cithrough either:</p>
4851cb0ef41Sopenharmony_ci<ul>
4861cb0ef41Sopenharmony_ci<li>
4871cb0ef41Sopenharmony_ci<p>The <a href="cli.html#node_icu_datafile"><code>NODE_ICU_DATA</code></a> environment variable:</p>
4881cb0ef41Sopenharmony_ci<pre><code class="language-bash"><span class="hljs-built_in">env</span> NODE_ICU_DATA=/some/directory node</code> <button class="copy-button">copy</button></pre>
4891cb0ef41Sopenharmony_ci</li>
4901cb0ef41Sopenharmony_ci<li>
4911cb0ef41Sopenharmony_ci<p>The <a href="cli.html#--icu-data-dirfile"><code>--icu-data-dir</code></a> CLI parameter:</p>
4921cb0ef41Sopenharmony_ci<pre><code class="language-bash">node --icu-data-dir=/some/directory</code> <button class="copy-button">copy</button></pre>
4931cb0ef41Sopenharmony_ci</li>
4941cb0ef41Sopenharmony_ci</ul>
4951cb0ef41Sopenharmony_ci<p>(If both are specified, the <code>--icu-data-dir</code> CLI parameter takes precedence.)</p>
4961cb0ef41Sopenharmony_ci<p>ICU is able to automatically find and load a variety of data formats, but the
4971cb0ef41Sopenharmony_cidata must be appropriate for the ICU version, and the file correctly named.
4981cb0ef41Sopenharmony_ciThe most common name for the data file is <code>icudt6X[bl].dat</code>, where <code>6X</code> denotes
4991cb0ef41Sopenharmony_cithe intended ICU version, and <code>b</code> or <code>l</code> indicates the system's endianness.
5001cb0ef41Sopenharmony_ciCheck <a href="http://userguide.icu-project.org/icudata">"ICU Data"</a> article in the ICU User Guide for other supported formats
5011cb0ef41Sopenharmony_ciand more details on ICU data in general.</p>
5021cb0ef41Sopenharmony_ci<p>The <a href="https://www.npmjs.com/package/full-icu">full-icu</a> npm module can greatly simplify ICU data installation by
5031cb0ef41Sopenharmony_cidetecting the ICU version of the running <code>node</code> executable and downloading the
5041cb0ef41Sopenharmony_ciappropriate data file. After installing the module through <code>npm i full-icu</code>,
5051cb0ef41Sopenharmony_cithe data file will be available at <code>./node_modules/full-icu</code>. This path can be
5061cb0ef41Sopenharmony_cithen passed either to <code>NODE_ICU_DATA</code> or <code>--icu-data-dir</code> as shown above to
5071cb0ef41Sopenharmony_cienable full <code>Intl</code> support.</p>
5081cb0ef41Sopenharmony_ci<h4>Embed the entire ICU (<code>full-icu</code>)<span><a class="mark" href="#embed-the-entire-icu-full-icu" id="embed-the-entire-icu-full-icu">#</a></span><a aria-hidden="true" class="legacy" id="intl_embed_the_entire_icu_full_icu"></a></h4>
5091cb0ef41Sopenharmony_ci<p>This option makes the resulting binary link against ICU statically and include
5101cb0ef41Sopenharmony_cia full set of ICU data. A binary created this way has no further external
5111cb0ef41Sopenharmony_cidependencies and supports all locales, but might be rather large. This is
5121cb0ef41Sopenharmony_cithe default behavior if no <code>--with-intl</code> flag is passed. The official binaries
5131cb0ef41Sopenharmony_ciare also built in this mode.</p>
5141cb0ef41Sopenharmony_ci</section><section><h3>Detecting internationalization support<span><a class="mark" href="#detecting-internationalization-support" id="detecting-internationalization-support">#</a></span><a aria-hidden="true" class="legacy" id="intl_detecting_internationalization_support"></a></h3>
5151cb0ef41Sopenharmony_ci<p>To verify that ICU is enabled at all (<code>system-icu</code>, <code>small-icu</code>, or
5161cb0ef41Sopenharmony_ci<code>full-icu</code>), simply checking the existence of <code>Intl</code> should suffice:</p>
5171cb0ef41Sopenharmony_ci<pre><code class="language-js"><span class="hljs-keyword">const</span> hasICU = <span class="hljs-keyword">typeof</span> <span class="hljs-title class_">Intl</span> === <span class="hljs-string">'object'</span>;</code> <button class="copy-button">copy</button></pre>
5181cb0ef41Sopenharmony_ci<p>Alternatively, checking for <code>process.versions.icu</code>, a property defined only
5191cb0ef41Sopenharmony_ciwhen ICU is enabled, works too:</p>
5201cb0ef41Sopenharmony_ci<pre><code class="language-js"><span class="hljs-keyword">const</span> hasICU = <span class="hljs-keyword">typeof</span> process.<span class="hljs-property">versions</span>.<span class="hljs-property">icu</span> === <span class="hljs-string">'string'</span>;</code> <button class="copy-button">copy</button></pre>
5211cb0ef41Sopenharmony_ci<p>To check for support for a non-English locale (i.e. <code>full-icu</code> or
5221cb0ef41Sopenharmony_ci<code>system-icu</code>), <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat"><code>Intl.DateTimeFormat</code></a> can be a good distinguishing factor:</p>
5231cb0ef41Sopenharmony_ci<pre><code class="language-js"><span class="hljs-keyword">const</span> hasFullICU = (<span class="hljs-function">() =></span> {
5241cb0ef41Sopenharmony_ci  <span class="hljs-keyword">try</span> {
5251cb0ef41Sopenharmony_ci    <span class="hljs-keyword">const</span> january = <span class="hljs-keyword">new</span> <span class="hljs-title class_">Date</span>(<span class="hljs-number">9e8</span>);
5261cb0ef41Sopenharmony_ci    <span class="hljs-keyword">const</span> spanish = <span class="hljs-keyword">new</span> <span class="hljs-title class_">Intl</span>.<span class="hljs-title class_">DateTimeFormat</span>(<span class="hljs-string">'es'</span>, { <span class="hljs-attr">month</span>: <span class="hljs-string">'long'</span> });
5271cb0ef41Sopenharmony_ci    <span class="hljs-keyword">return</span> spanish.<span class="hljs-title function_">format</span>(january) === <span class="hljs-string">'enero'</span>;
5281cb0ef41Sopenharmony_ci  } <span class="hljs-keyword">catch</span> (err) {
5291cb0ef41Sopenharmony_ci    <span class="hljs-keyword">return</span> <span class="hljs-literal">false</span>;
5301cb0ef41Sopenharmony_ci  }
5311cb0ef41Sopenharmony_ci})();</code> <button class="copy-button">copy</button></pre>
5321cb0ef41Sopenharmony_ci<p>For more verbose tests for <code>Intl</code> support, the following resources may be found
5331cb0ef41Sopenharmony_cito be helpful:</p>
5341cb0ef41Sopenharmony_ci<ul>
5351cb0ef41Sopenharmony_ci<li><a href="https://github.com/srl295/btest402">btest402</a>: Generally used to check whether Node.js with <code>Intl</code> support is
5361cb0ef41Sopenharmony_cibuilt correctly.</li>
5371cb0ef41Sopenharmony_ci<li><a href="https://github.com/tc39/test262/tree/HEAD/test/intl402">Test262</a>: ECMAScript's official conformance test suite includes a section
5381cb0ef41Sopenharmony_cidedicated to ECMA-402.</li>
5391cb0ef41Sopenharmony_ci</ul></section>
5401cb0ef41Sopenharmony_ci        <!-- API END -->
5411cb0ef41Sopenharmony_ci      </div>
5421cb0ef41Sopenharmony_ci    </div>
5431cb0ef41Sopenharmony_ci  </div>
5441cb0ef41Sopenharmony_ci</body>
5451cb0ef41Sopenharmony_ci</html>
546