expo-localization

What is expo-localization?

The expo-localization package provides utilities for determining the locale, language, and region settings of a user's device. It is useful for internationalizing and localizing applications to provide a more personalized user experience.

What are expo-localization's main functionalities?

Get current locale

This feature allows you to get the current locale of the user's device. The locale is a string that represents the language and region settings, such as 'en-US' for English (United States).

import * as Localization from 'expo-localization';

console.log(Localization.locale);

Get preferred languages

This feature provides an array of preferred languages set on the user's device. This can be useful for applications that support multiple languages and want to prioritize content based on user preferences.

import * as Localization from 'expo-localization';

console.log(Localization.locales);

Get timezone

This feature allows you to get the current timezone of the user's device. The timezone is a string that represents the time zone identifier, such as 'America/Los_Angeles'.

import * as Localization from 'expo-localization';

console.log(Localization.timezone);

Get country

This feature provides the country code of the user's device, such as 'US' for the United States. This can be useful for region-specific content or services.

import * as Localization from 'expo-localization';

console.log(Localization.country);

Other packages similar to expo-localization

react-native-localize

The react-native-localize package provides similar functionalities for determining the locale, language, and region settings of a user's device. It offers more comprehensive support for React Native applications and includes additional features like currency and calendar type detection.

i18next

The i18next package is a powerful internationalization framework for JavaScript applications. While it does not directly provide device locale information, it integrates well with localization packages to manage translations and language switching in applications.

globalize

The globalize package is a comprehensive library for internationalization and localization in JavaScript. It provides functionalities for formatting numbers, dates, and strings based on locale settings. It can be used in conjunction with device locale detection packages to provide a complete localization solution.

README

expo-localization

Provides an interface for native user localization information.

API documentation

• Documentation for the master branch
• Documentation for the latest stable release

Installation in managed Expo projects

For managed managed Expo projects, please follow the installation instructions in the API documentation for the latest stable release. If you follow the link and there is no documentation available then this library is not yet usable within managed projects — it is likely to be included in an upcoming Expo SDK release.

Installation in bare React Native projects

For bare React Native projects, you must ensure that you have installed and configured the react-native-unimodules package before continuing.

Add the package to your npm dependencies

npm install expo-localization

Configure for iOS

Run pod install in the ios directory after installing the npm package.

Configure for Android

No additional set up necessary.

Contributing

Contributions are very welcome! Please refer to guidelines described in the contributing guide.