# generaltranslation: General Translation Core SDK: formatListToParts
URL: https://generaltranslation.com/es/docs/core/functions/formatting/format-list-to-parts.mdx
---
title: formatListToParts
description: Función independiente para dar formato a listas en partes conservando los tipos originales
---

## Resumen

La función independiente `formatListToParts` da formato a un array en partes específicas de la configuración regional sin necesidad de una instancia de GT.
Inserta separadores de texto entre los elementos y conserva los tipos originales de cada uno, devolviendo un `Array<T | string>`.

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

const parts = formatListToParts(['red', 'green', 'blue'], {
  locales: ['es'],
  type: 'disjunction'
});
// Devuelve: ['red', ', ', 'green', ' o ', 'blue']
```


## Referencia

### Parámetros

| Nombre    | Tipo                                                       | Descripción                                     |
| --------- | ---------------------------------------------------------- | ----------------------------------------------- |
| `array`   | `Array<T>`                                                 | El array de elementos a los que se dará formato |
| `options` | `ListFormatPartsOptions & { locales: string \| string[] }` | Configuración de formato que requiere `locales` |

### ListFormatPartsOptions

| Nombre    | Tipo                                       | Descripción                                                 |
| --------- | ------------------------------------------ | ----------------------------------------------------------- |
| `locales` | `string \| string[]`                       | **Obligatorio** - locales para dar formato                  |
| `type?`   | `'conjunction' \| 'disjunction' \| 'unit'` | Tipo de formato de listas (predeterminado: `'conjunction'`) |
| `style?`  | `'long' \| 'short' \| 'narrow'`            | Estilo de formato de listas (predeterminado: `'long'`)      |

### Devuelve

`Array<T | string>` - Un array con los elementos originales intercalados con separadores de texto específicos de la configuración regional.

***

## Ejemplo

### Uso básico

```typescript copy
import { formatListToParts } from 'generaltranslation';

// Lista de conjunción
console.log(formatListToParts(['A', 'B', 'C'], { locales: 'en' }));
// Salida: ['A', ', ', 'B', ', and ', 'C']

// Lista de disyunción
console.log(formatListToParts(['A', 'B', 'C'], { locales: 'en', type: 'disjunction' }));
// Salida: ['A', ', ', 'B', ', or ', 'C']
```


### Arrays mixtos

```typescript copy
// Los números y objetos se conservan
console.log(formatListToParts(['apple', 42, { type: 'fruit' }], { locales: 'en' }));
// Salida: ['apple', ', ', 42, ', and ', { type: 'fruit' }]
```


### Formato específico de la configuración regional

```typescript copy
// Disyunción en español
console.log(formatListToParts(['red', 'green', 'blue'], {
  locales: 'es',
  type: 'disjunction'
}));
// Salida: ['red', ', ', 'green', ' o ', 'blue']

// Estilo corto
console.log(formatListToParts(['first', 'second'], {
  locales: 'en',
  style: 'short'
}));
// Salida: ['first', ' & ', 'second']
```

***


## Notas

* A diferencia del método de la clase GT, el parámetro `locales` es obligatorio
* Se conservan los tipos de elemento originales; solo se insertan separadores de texto entre los elementos
* Este es el principal diferenciador con respecto a `formatList`, que devuelve una `cadena` plana
* Resulta especialmente útil para renderizar arrays de tipos mixtos en frameworks de interfaz de usuario como React
* Usa el mismo `Intl.ListFormat` subyacente que el método de la clase GT

## Siguientes pasos

* Consulta la documentación de [`Intl.ListFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/ListFormat) para ver más opciones
* Consulta [`formatNum`](/docs/core/functions/formatting/format-num) para dar formato a números de forma independiente
* Consulta [`formatDateTime`](/docs/core/functions/formatting/format-date-time) para dar formato a fechas de forma independiente
* Consulta [`formatListToParts`](/docs/core/class/methods/formatting/format-list-to-parts) de la clase GT para usarlo desde una instancia