expo-localization

@amazon-devices/expo-localization provides an interface for native user localization information.

This library provides the getCalendars() and getLocales() methods and their corresponding hooks, which return specific information about a user's locale settings, for example languageCode, uses24HourClock, currencyCode and textDirection. No methods are provided for formatting text or values. Hooks trigger a re-render when the app locale changes.

This library is system-deployed and available to React Native for Vega apps without a separate installation process. This autolinking library connects to your app at runtime. Compatibility is guaranteed only between the library and the version of React Native for Vega for which it is built.

• Installation
• Examples
• API reference
  • Constants
  • Hooks
  • Methods
• Known issues and limitations
• Supported versions
• Related topics

Installation

1. Add the JavaScript library dependency in the package.json file.

   Copy code Copied to clipboard.

    "dependencies": {
    ...
    "@amazon-devices/expo-localization": "~2.0.0",
    "@amazon-devices/keplerscript-turbomodule-api": "~1.0.0",
    ...
    }
   

2. Reinstall dependencies using the npm install command.

Examples

This example demonstrates how to retrieve a user's language code.

Copy code Copied to clipboard.

import React from 'react';
import {StyleSheet, Text, View} from 'react-native';
import {useLocales, useCalendars} from '@amazon-devices/expo-localization';

export const App = () => {
  const locales = useLocales();
  const calendars = useCalendars();

  return (
    <View style={styles.container}>
      <Text style={styles.text}>useLocales():</Text>
      <Text style={styles.text}>{JSON.stringify(locales, null, 2)}</Text>
      <Text style={styles.text}>useCalendars():</Text>
      <Text style={styles.text}>{JSON.stringify(calendars, null, 2)}</Text>
    </View>
  );
};

const styles = StyleSheet.create({
  container: {
    flex: 1,
    flexDirection: 'row',
    backgroundColor: 'white',
  },
  text: {
    color: 'black',
    fontSize: 32,
  },
});

API reference

Check out the dedicated documentation page for info about this library and API reference: Official Expo documentation for expo-localization.

Constants

Hooks

Methods

Known issues and limitations

• The region field on Localization type is always null on Vega.

• Functions useLocales(), useCalendars(), getCalendars() and getLocales() always return an array with one item in it, while other platforms could return empty arrays or multiple valid locales/calendars.

• The deprecated constants and method getLocalizationAsync() aren't supported on Vega.

Supported versions

Related topics

For information on additional libraries, see Supported Third-Party Libraries and Services.

Last updated: Sep 30, 2025