# generaltranslation: General Translation Core SDK: isValidLocale
URL: https://generaltranslation.com/es/docs/core/functions/locales/is-valid-locale.mdx
---
title: isValidLocale
description: Referencia de la API para la función isValidLocale
---

## resumen

La función `isValidLocale` valida si una cadena representa un código de configuración regional BCP-47 válido. Realiza una validación exhaustiva del formato sin requerir una instancia de la clase GT.

***

## Referencia

### Parámetros

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

### Devuelve

`boolean`: `true` si el código de configuración regional es válido; `false` en caso contrario

***

## Ejemplos

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

// Códigos de configuración regional válidos
console.log(isValidLocale('en-US')); // true
console.log(isValidLocale('zh-CN')); // true
console.log(isValidLocale('es')); // true

// Códigos de configuración regional inválidos
console.log(isValidLocale('invalid')); // false
console.log(isValidLocale('en_US')); // false (guion bajo en lugar de guion)
console.log(isValidLocale('')); // false
```

***


## Notas

* Valida el formato del código de configuración regional BCP-47
* Funciona con mapeos personalizados de configuración regional
* Esencial para validar la entrada del usuario
* Sin solicitudes de red: solo valida el formato
* Función sin estado adecuada para bibliotecas de utilidades

## Próximos pasos

* Usa el método de la clase GT [`isValidLocale`](/docs/core/class/methods/locales/is-valid-locale)
* Estandariza el formato con [`standardizeLocale`](/docs/core/functions/locales/standardize-locale)