# General Translation Platform: isSameDialect
URL: https://generaltranslation.com/es/docs/platform/core/reference/gt-class-methods/locales/is-same-dialect.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Comprueba si dos configuraciones regionales representan el mismo dialecto. Referencia de la API de isSameDialect.

General Translation compara los componentes de idioma y región de los códigos de configuración regional para determinar si representan la misma variedad lingüística.

## Resumen [#overview]

Llama a `isSameDialect` sobre una instancia de [`GT`](/docs/platform/core/reference/gt-class/constructor) con dos o más códigos de configuración regional (o listas de códigos). Devuelve `true` cuando todos representan el mismo dialecto.

```typescript
const gt = new GT({ sourceLocale: 'en-US', targetLocale: 'es-ES' });

console.log(gt.isSameDialect('en-US', 'en-GB')); // false
console.log(gt.isSameDialect('en', 'en-US')); // true
```

Firma:

```typescript
isSameDialect(...locales: (string | string[])[]): boolean
```

*Nota: `isSameDialect` se ejecuta localmente y no requiere una clave de API. Los códigos de configuración regional no válidos se manejan correctamente y devuelven `false`. Para hacer comparaciones sin una instancia de `GT`, consulta la versión independiente de [`isSameDialect`](/docs/platform/core/reference/utility-functions/locales/is-same-dialect).*

## Cómo funciona [#how-it-works]

### Lógica de comparación de dialectos

El método determina si dos dialectos son iguales de la siguiente manera:

1. **Normalizar las configuraciones regionales** — estandariza todos los códigos de configuración regional de entrada.
2. **Comparar los códigos de idioma** — todas las configuraciones regionales deben tener el mismo idioma base.
3. **Tener en cuenta la jerarquía regional** — un idioma base coincide con sus variantes regionales.
4. **Coincidencia exacta de dialectos** — las variantes regionales deben coincidir exactamente.

### Reglas de jerarquía

* Un idioma base (`'en'`) coincide con cualquier variante regional (`'en-US'`, `'en-GB'`).
* Las variantes regionales solo coinciden si son idénticas (`'en-US'` ≠ `'en-GB'`).
* Las variantes de script se tienen en cuenta en la comparación cuando están presentes.
* Los idiomas distintos nunca coinciden (`'en'` ≠ `'es'`).

### Flexibilidad de entrada

El método acepta:

* Múltiples parámetros de tipo `string`: `isSameDialect('en-US', 'en-GB')`
* Listas de cadenas: `isSameDialect(['en-US', 'en-GB'])`
* Formato mixto: `isSameDialect('en-US', ['en-GB', 'en-CA'])`
* Una sola configuración regional: `isSameDialect('en-US')` (siempre devuelve `true`)

## Parámetros [#parameters]

| Parámetro             | Descripción                                                                                                            | Tipo                     | Opcional | Predeterminado |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------ | -------- | -------------- |
| [`locales`](#locales) | Un número variable de códigos de configuración regional, o listas de códigos de configuración regional, para comparar. | `(string \| string[])[]` | No       | —              |

### `...locales` [#locales]

**Tipo** `(string | string[])[]` · **obligatorio**

Una cantidad variable de códigos de configuración regional (cadenas) o listas de códigos de configuración regional para comparar. Todas las configuraciones regionales indicadas deben corresponder al mismo dialecto.

## Devuelve [#returns]

**Tipo** `boolean`

`true` si todos los códigos de configuración regional proporcionados representan el mismo dialecto; `false` en caso contrario. No se lanza ninguna excepción; los códigos de configuración regional no válidos se procesan correctamente y devuelven `false`.

## Ejemplos [#examples]

```typescript
// Comparación básica de dialectos
const gt = new GT({ sourceLocale: 'en-US', targetLocale: 'es-ES' });

// Dialectos exactamente iguales
console.log(gt.isSameDialect('en-US', 'en-US')); // true
console.log(gt.isSameDialect('zh-CN', 'zh-CN')); // true

// Dialectos distintos del mismo idioma
console.log(gt.isSameDialect('en-US', 'en-GB')); // false
console.log(gt.isSameDialect('es-ES', 'es-MX')); // false
console.log(gt.isSameDialect('pt-PT', 'pt-BR')); // false

// Idioma base con variantes regionales
console.log(gt.isSameDialect('en', 'en-US')); // true
console.log(gt.isSameDialect('es', 'es-ES')); // true
console.log(gt.isSameDialect('zh', 'zh-CN')); // true

// Idiomas distintos
console.log(gt.isSameDialect('en-US', 'es-ES')); // false
console.log(gt.isSameDialect('fr-FR', 'de-DE')); // false
```

## Notas [#notes]

* Usa códigos de configuración regional estandarizados para garantizar una comparación precisa.
* Acepta formatos de entrada flexibles (cadenas, listas o combinaciones de ambas).

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
