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

## Descripción general

La función `requiresTranslation` determina si es necesaria una traducción entre la configuración regional de origen y la de destino sin requerir una instancia de la clase GT.

***

## Referencia

### Parámetros

<TypeTable
  type={{
  "sourceLocale": {
    type: 'string',
    optional: false,
  },
  "targetLocale": {
    type: 'string',
    optional: false,
  },
  "approvedLocales?": {
    type: 'string[]',
    optional: true,
  },
  "customMapping?": {
    type: 'CustomMapping',
    optional: true,
  }
}}
/>

### Devuelve

`boolean`: `true` si se requiere traducción; `false` en caso contrario

***

## Ejemplos

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

// Los idiomas diferentes requieren traducción
console.log(requiresTranslation('en-US', 'es-ES')); // true
console.log(requiresTranslation('en-US', 'fr-FR')); // true

// Los idiomas iguales no requieren traducción
console.log(requiresTranslation('en-US', 'en-US')); // false
console.log(requiresTranslation('en-US', 'en-GB')); // false

// Con filtro de configuraciones regionales aprobadas
const approved = ['en-US', 'es-ES', 'fr-FR'];
console.log(requiresTranslation('en-US', 'it-IT', approved)); // false (no aprobado)
console.log(requiresTranslation('en-US', 'es-ES', approved)); // true (aprobado y diferente)
```

***


## Notas

* Respeta las restricciones de las configuraciones regionales aprobadas
* Devuelve false si la configuración regional de destino no está en la lista de aprobadas
* Tiene en cuenta las asignaciones personalizadas de configuración regional

## Siguientes pasos

* Usa el método [`requiresTranslation`](/docs/core/class/methods/locales/requires-translation) de la clase GT
* Compara idiomas con [`isSameLanguage`](/docs/core/functions/locales/is-same-language)