# generaltranslation: General Translation Core SDK: isValidLocale
URL: https://generaltranslation.com/it/docs/core/functions/locales/is-valid-locale.mdx
---
title: isValidLocale
description: Riferimento dell’API per la funzione isValidLocale
---

## Panoramica

La funzione `isValidLocale` verifica se una determinata stringa rappresenta un codice locale BCP-47 valido. Esegue una validazione completa del formato senza richiedere un'istanza della classe GT.

***

## Riferimento

### Parametri

<TypeTable
  type={{
  "locale": {
    type: 'string',
    optional: false,
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
  }
}}
/>

### Restituisce

`boolean` - `true` se il codice locale è valido, `false` in caso contrario

***

## Esempi

```typescript
import { isValidLocale } from 'generaltranslation';

// Codici locale validi
console.log(isValidLocale('en-US')); // true
console.log(isValidLocale('zh-CN')); // true
console.log(isValidLocale('es')); // true

// Codici locale non validi
console.log(isValidLocale('invalid')); // false
console.log(isValidLocale('en_US')); // false (underscore invece del trattino)
console.log(isValidLocale('')); // false
```

***


## Note

* Convalida il formato del codice locale BCP-47
* Funziona con mappature personalizzate delle impostazioni regionali
* Essenziale per la convalida dell&#39;input dell&#39;utente
* Nessuna richiesta di rete: convalida solo il formato
* Funzione senza stato adatta alle librerie di utilità

## Passaggi successivi

* Usa il metodo [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale) della classe GT
* Standardizza il formato con [`standardizeLocale`](/docs/core/functions/locales/standardize-locale)