# generaltranslation: General Translation Core SDK: formatDateTime
URL: https://generaltranslation.com/fr/docs/core/functions/formatting/format-date-time.mdx
---
title: formatDateTime
description: Fonction autonome pour formater les dates et les heures conformément aux conventions du paramètre régional
---

## Vue d’ensemble

La fonction autonome `formatDateTime` met en forme les dates et les heures selon les conventions du paramètre régional, sans nécessiter d’instance GT.
Elle offre les mêmes fonctionnalités que la méthode de la classe GT, mais peut être utilisée indépendamment.

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

const formatted = formatDateTime(new Date(), {
  locales: 'de-DE',
  dateStyle: 'medium',
  timeStyle: 'short'
});
// Retourne : "26.09.2025, 17:33"
```


## Référence

### Paramètres

| Nom       | Type                                                       | Description                                          |
| --------- | ---------------------------------------------------------- | ---------------------------------------------------- |
| `date`    | `Date`                                                     | L’objet date à formater                              |
| `options` | `DateTimeFormatOptions & { locales?: string \| string[] }` | Configuration de formatage avec `locales` facultatif |

### DateTimeFormatOptions

| Nom          | Type                                                      | Description                                                                    |
| ------------ | --------------------------------------------------------- | ------------------------------------------------------------------------------ |
| `locales?`   | `string \| string[]`                                      | Paramètres régionaux utilisés pour le formatage (par défaut, celui du système) |
| `dateStyle?` | `'full' \| 'long' \| 'medium' \| 'short'`                 | Style global de formatage de la date                                           |
| `timeStyle?` | `'full' \| 'long' \| 'medium' \| 'short'`                 | Style global de formatage de l’heure                                           |
| `weekday?`   | `'long' \| 'short' \| 'narrow'`                           | Représentation du jour de la semaine                                           |
| `year?`      | `'numeric' \| '2-digit'`                                  | Représentation de l’année                                                      |
| `month?`     | `'numeric' \| '2-digit' \| 'long' \| 'short' \| 'narrow'` | Représentation du mois                                                         |
| `day?`       | `'numeric' \| '2-digit'`                                  | Représentation du jour                                                         |
| `hour?`      | `'numeric' \| '2-digit'`                                  | Représentation de l’heure                                                      |
| `minute?`    | `'numeric' \| '2-digit'`                                  | Représentation de la minute                                                    |
| `second?`    | `'numeric' \| '2-digit'`                                  | Représentation de la seconde                                                   |
| `timeZone?`  | `string`                                                  | Identifiant de fuseau horaire IANA                                             |
| `hour12?`    | `boolean`                                                 | Indique s’il faut utiliser le format horaire sur 12 heures                     |

### Renvoie

`string` - La date et l’heure mise en forme selon les conventions du paramètre régional.

***

## Exemple

### Utilisation de base

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

// Formatage de base avec un paramètre régional explicite
console.log(formatDateTime(date, { locales: 'en-US' }));
// Sortie : "3/14/2024"

// Formatage allemand
console.log(formatDateTime(date, { locales: 'de-DE' }));
// Sortie : "14.3.2024"

// Plusieurs paramètres régionaux de repli
console.log(formatDateTime(date, { 
  locales: ['ja-JP', 'en-US'] 
}));
// Sortie : "2024/3/14" (format japonais)
```


### Formats de date et d’heure

```typescript copy
const date = new Date('2024-03-14T14:30:45Z');

// Style de date complet
console.log(formatDateTime(date, {
  locales: 'en-US',
  dateStyle: 'full'
}));
// Sortie : "Thursday, March 14, 2024"

// Date longue avec heure courte
console.log(formatDateTime(date, {
  locales: 'fr-FR',
  dateStyle: 'long',
  timeStyle: 'short'
}));
// Sortie : "14 mars 2024 à 07:30"

// Format court pour différents paramètres régionaux
const locales = ['en-US', 'de-DE', 'ja-JP'];
locales.forEach(locale => {
  console.log(`${locale}: ${formatDateTime(date, {
    locales: locale,
    dateStyle: 'short',
    timeStyle: 'short'
  })}`);
});
// Sortie :
// en-US: 3/14/24, 7:30 AM
// de-DE: 14.03.24, 07:30
// ja-JP: 2024/03/14 7:30
```


### Gestion des fuseaux horaires

```typescript copy
const date = new Date('2024-03-14T14:30:45Z');

// Formater pour différents fuseaux horaires
const timeZones = [
  'America/New_York',
  'Europe/London', 
  'Asia/Tokyo'
];

timeZones.forEach(timeZone => {
  const formatted = formatDateTime(date, {
    locales: 'en-US',
    timeZone,
    dateStyle: 'medium',
    timeStyle: 'medium'
  });
  console.log(`${timeZone}: ${formatted}`);
});
// La sortie varie selon l'heure d'été
```

***


## Remarques

* Le paramètre `locales` est facultatif ; s’il n’est pas fourni, le paramètre régional du système est utilisé par défaut
* Utilise le même `Intl.DateTimeFormat` sous-jacent que la méthode de classe GT
* Les résultats sont mis en cache en interne pour de meilleures performances lorsque les mêmes combinaisons de paramètres régionaux et d’options sont réutilisées
* Toutes les options standard d’`Intl.DateTimeFormat` sont prises en charge
* Les fuseaux horaires sont correctement gérés lorsqu’ils sont spécifiés
* Les différents paramètres régionaux ont des formats de date et d’heure par défaut différents, ainsi que des préférences 12 h ou 24 h différentes

## Étapes suivantes

* Consultez la documentation de [`Intl.DateTimeFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat) pour découvrir plus d'options
* Voir [`formatNum`](/docs/core/functions/formatting/format-num) pour le formatage autonome des nombres
* Voir [`formatMessage`](/docs/core/functions/formatting/format-message) pour le formatage autonome des messages
* Voir la méthode [`formatDateTime`](/docs/core/class/methods/formatting/format-date-time) de la classe GT pour une utilisation via une instance