# General Translation Platform: DataFormat
URL: https://generaltranslation.com/it/docs/platform/core/reference/types/data-format.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Valori supportati del formato dei dati di traduzione. Riferimento API per il tipo DataFormat.

`DataFormat` specifica il formato del contenuto traducibile. Compare nel campo `dataFormat` di [`EntryMetadata`](/docs/platform/core/reference/types/entry-metadata) e determina come il sistema di traduzione elabora una voce.

## Panoramica [#overview]

`DataFormat` è un tipo union di stringhe che comprende i quattro formati di contenuto supportati. Specificarlo esplicitamente garantisce che il contenuto venga analizzato e tradotto correttamente; il rilevamento automatico è possibile, ma si consiglia di specificarlo in modo esplicito.

```typescript
type DataFormat = 'JSX' | 'ICU' | 'I18NEXT' | 'STRING';
```

## Valori [#values]

| Valore      | Descrizione                   | Tipo di contenuto                                                 | Caso d'uso                                        |
| ----------- | ----------------------------- | ----------------------------------------------------------------- | ----------------------------------------------------- |
| `'JSX'`     | Formato componente JSX/React. | [`JsxChildren`](/docs/platform/core/reference/types/jsx-children) | Componenti UI ricchi con elementi e variabili.        |
| `'ICU'`     | MessageFormat ICU.            | `IcuMessage` (string)                                             | Formattazione complessa con plurali, date e numeri.   |
| `'I18NEXT'` | Formato messaggio i18next.    | `I18nextMessage` (string)                                         | Interpolazione semplice e progetti i18next esistenti. |
| `'STRING'`  | Formato stringa semplice.     | `string`                                                          | Contenuto testuale semplice.                          |

### Caratteristiche dei formati

| Formato   | Variabili                 | Pluralizzazione     | Elementi HTML            | Formattazione di date/numeri |
| --------- | ------------------------- | ------------------- | ------------------------ | ---------------------------- |
| `JSX`     | ✅ Variabili avanzate      | ✅ Tramite branch    | ✅ Supporto HTML completo | ✅ Tramite variabili          |
| `ICU`     | ✅ Sintassi `{variable}`   | ✅ Plurali integrati | ❌ Solo testo             | ✅ Formattatori integrati     |
| `I18NEXT` | ✅ Sintassi `{{variable}}` | ✅ Tramite count     | ❌ Solo testo             | ✅ Tramite formattatori       |
| `STRING`  | ❌                         | ❌                   | ❌                        | ❌                            |

## Esempio [#example]

```typescript
const icuEntry: TranslateManyEntry = {
  source: 'Hello {name}',
  metadata: { dataFormat: 'ICU' }
};

const plainEntry: TranslateManyEntry = {
  source: 'Hello, world!',
  metadata: { dataFormat: 'STRING' }
};
```

## Note [#notes]

* `DataFormat` determina come viene elaborato il contenuto dal sistema di traduzione.
* Specificare il formato in [`EntryMetadata`](/docs/platform/core/reference/types/entry-metadata) garantisce una corretta elaborazione del contenuto.
* Il rilevamento automatico è possibile, ma è consigliabile specificarlo esplicitamente.

## Sitemap

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