os-locale

February 3, 2026 · View on GitHub

Get the system locale

Note

You may want new Intl.DateTimeFormat().resolvedOptions().locale instead. This package is useful for CLI tools as it also reads locale from environment variables (LC_ALL, LC_MESSAGES, LANG, LANGUAGE), which the Intl API does not fully support (it only respects LC_ALL).

Useful for localizing your module or app.

POSIX systems: The returned locale refers to the LC_MESSAGES category, suitable for selecting the language used in the user interface for message translation.

Install

npm install os-locale

Usage

import osLocale from 'os-locale';

console.log(osLocale());
//=> 'en-US'

API

osLocale()

Returns the locale.