# generaltranslation: General Translation Core SDK: requiresTranslation
URL: https://generaltranslation.com/it/docs/core/functions/locales/requires-translation.mdx
---
title: requiresTranslation
description: Riferimento API della funzione requiresTranslation
---

## Panoramica

La funzione `requiresTranslation` determina se è necessaria una traduzione tra l'impostazione regionale di origine e quella di destinazione, senza richiedere un'istanza di GT.

***

## Riferimento

### Parametri

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

### Restituisce

`boolean` - `true` se la traduzione è necessaria, `false` altrimenti

***

## Esempi

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

// Lingue diverse richiedono la traduzione
console.log(requiresTranslation('en-US', 'es-ES')); // true
console.log(requiresTranslation('en-US', 'fr-FR')); // true

// Lingue uguali non richiedono la traduzione
console.log(requiresTranslation('en-US', 'en-US')); // false
console.log(requiresTranslation('en-US', 'en-GB')); // false

// Con filtro delle impostazioni regionali approvate
const approved = ['en-US', 'es-ES', 'fr-FR'];
console.log(requiresTranslation('en-US', 'it-IT', approved)); // false (non approvata)
console.log(requiresTranslation('en-US', 'es-ES', approved)); // true (approvata e diversa)
```

***


## Note

* Rispetta i vincoli relativi alle impostazioni regionali approvate
* Restituisce false se la destinazione non è nell&#39;elenco approvato
* Tiene conto delle mappature personalizzate delle impostazioni regionali

## Passaggi successivi

* Usa il metodo della classe GT [`requiresTranslation`](/docs/core/class/methods/locales/requires-translation)
* Confronta le lingue con [`isSameLanguage`](/docs/core/functions/locales/is-same-language)