1. Documentation
    2. Packages
    3. intlayer
    4. getLocaleLang

    Documentation: getLocaleLang Function in intlayer

    Description:

    The getLocaleLang function extracts the language code from a locale string. It supports locales with or without country codes. If no locale is provided, it defaults to returning an empty string.

    Parameters:

    • locale?: Locales

      • Description: The locale string (e.g., Locales.ENGLISH_UNITED_STATES, Locales.FRENCH_CANADA) from which the language code is extracted.
      • Type: Locales (optional)

    Returns:

    • Type: string
    • Description: The language code extracted from the locale. If the locale is not provided, it returns an empty string ('').

    Example Usage:

    Extracting Language Codes:

    typescript
    1import { getLocaleLang, Locales } from "intlayer"; 2 3getLocaleLang(Locales.ENGLISH_UNITED_STATES); // Output: "en" 4getLocaleLang(Locales.ENGLISH); // Output: "en" 5getLocaleLang(Locales.FRENCH_CANADA); // Output: "fr" 6getLocaleLang(Locales.FRENCH); // Output: "fr"

    Edge Cases:

    • No Locale Provided:

      • The function returns an empty string when locale is undefined.
    • Malformed Locale Strings:

      • If the locale does not follow the language-country format (e.g., Locales.ENGLISH-US), the function safely returns the part before '-' or the entire string if no '-' is present.

    If you have an idea for improving this documentation, please feel free to contribute by submitting a pull request on GitHub.

    GitHub link to the documentation

    In this page