# General Translation Platform: formatDateTime URL: https://generaltranslation.com/fr/docs/platform/core/reference/utility-functions/formatting/format-date-time.mdx --- title: formatDateTime description: Formate les dates et les heures sans instance GT. Référence de l’API pour formatDateTime. --- [`formatDateTime`](/docs/platform/core/reference/gt-class-methods/formatting/format-date-time) est une fonction utilitaire autonome issue de la bibliothèque principale de General Translation qui met en forme les dates et les heures selon les conventions du paramètre régional. Elle renvoie une chaîne tenant compte du paramètre régional pour un `Date`. ## Vue d’ensemble [#overview] Importez `formatDateTime` directement depuis `generaltranslation` et appelez-le avec une `Date` et un objet d’options. Cela ne nécessite ni clé d’API ni instance de [GT](/docs/platform/core/reference/gt-class/constructor). Pour un formatage via une instance qui hérite du paramètre régional de celle-ci, utilisez plutôt la méthode [`formatDateTime`](/docs/platform/core/reference/gt-class-methods/formatting/format-date-time) d’une instance [`GT`](/docs/platform/core/reference/gt-class/constructor). ```typescript import { formatDateTime } from 'generaltranslation'; const formatted = formatDateTime(new Date(), { locales: 'de-DE', dateStyle: 'medium', timeStyle: 'short', }); // Retourne une chaîne formatée selon le paramètre régional, ex. "26.09.2025, 17:33" ``` Signature : ```typescript formatDateTime( date: Date, options?: { locales?: string | string[] } & Intl.DateTimeFormatOptions ): string ``` ## Fonctionnement [#how-it-works] * **API sous-jacente.** Utilise le même [`Intl.DateTimeFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat) que la méthode de la classe GT, donc toutes les options standard de `Intl.DateTimeFormat` sont prises en charge. * **Résolution des paramètres régionaux.** Lorsque `locales` est un tableau, les paramètres régionaux sont testés dans l'ordre. Lorsque `locales` est omis, le système utilise le paramètre régional par défaut de la bibliothèque, `en`. * **Fuseaux horaires.** La sortie tient compte de l'option `timeZone` lorsqu'elle est fournie ; sinon, le fuseau horaire local de l'environnement d'exécution est utilisé. 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 variables entre 12 et 24 heures. * **Mise en cache.** Les résultats sont mis en cache en interne afin d'améliorer les performances pour les combinaisons répétées de paramètres régionaux et d'options. ## Paramètres [#parameters] | Paramètre | Description | Type | Facultatif | Par défaut | | --------------------- | ----------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | ---------- | ---------- | | [`date`](#date) | L’objet `Date` à formater. | `Date` | Non | — | | [`options`](#options) | Configuration de formatage, y compris le ou les paramètres régionaux cibles et les éventuelles options `Intl.DateTimeFormat`. | `{ locales?: string \| string[] } & Intl.DateTimeFormatOptions` | Oui | `{}` | ### `date` [#date] **Type** `Date` · **Obligatoire** L’objet `Date` à formater. ### `options` [#options] **Type** `{ locales?: string | string[] } & Intl.DateTimeFormatOptions` · **Facultatif** · **Par défaut** `{}` Configuration de formatage. Toutes les options de [`Intl.DateTimeFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat) sont acceptées en plus de `locales`. Champs courants : | Propriété | Description | Type | Facultatif | Par défaut | | ----------- | ---------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | ---------- | ---------- | | `locales` | Paramètre(s) régional(aux) pour le formatage. S’ils sont fournis sous forme de tableau, ils sont essayés dans l’ordre. | `string \| string[]` | Oui | `en` | | `dateStyle` | Style global de formatage de la date. | `'full' \| 'long' \| 'medium' \| 'short'` | Oui | — | | `timeStyle` | Style global de formatage de l’heure. | `'full' \| 'long' \| 'medium' \| 'short'` | Oui | — | | `weekday` | Représentation du jour de la semaine. | `'long' \| 'short' \| 'narrow'` | Oui | — | | `year` | Représentation de l’année. | `'numeric' \| '2-digit'` | Oui | — | | `month` | Représentation du mois. | `'numeric' \| '2-digit' \| 'long' \| 'short' \| 'narrow'` | Oui | — | | `day` | Représentation du jour. | `'numeric' \| '2-digit'` | Oui | — | | `hour` | Représentation de l’heure. | `'numeric' \| '2-digit'` | Oui | — | | `minute` | Représentation des minutes. | `'numeric' \| '2-digit'` | Oui | — | | `second` | Représentation des secondes. | `'numeric' \| '2-digit'` | Oui | — | | `timeZone` | Identifiant de fuseau horaire IANA. | `string` | Oui | — | | `hour12` | Indique s’il faut utiliser le format horaire sur 12 heures. | `boolean` | Oui | — | ## Valeur de retour [#returns] **Type** `string` La date et l’heure formatées selon les conventions du paramètre régional. ## Exemples [#examples] ```typescript import { formatDateTime } from 'generaltranslation'; const date = new Date('2024-03-14T14:30:45Z'); // Formatage de base avec un paramètre régional explicite console.log(formatDateTime(date, { locales: 'en-US', timeZone: 'UTC' })); // Résultat : "3/14/2024" // Formatage en allemand console.log(formatDateTime(date, { locales: 'de-DE', timeZone: 'UTC' })); // Résultat : "14.3.2024" // Plusieurs paramètres régionaux de secours console.log(formatDateTime(date, { locales: ['ja-JP', 'en-US'], timeZone: 'UTC' })); // Résultat : "2024/3/14" (format japonais) ``` ```typescript // Styles de date et d'heure const date = new Date('2024-03-14T14:30:45Z'); // Style de date complet console.log(formatDateTime(date, { locales: 'en-US', dateStyle: 'full', timeZone: 'UTC', })); // Résultat : "Thursday, March 14, 2024" // Date longue avec heure courte console.log(formatDateTime(date, { locales: 'fr-FR', dateStyle: 'long', timeStyle: 'short', timeZone: 'UTC', })); // Résultat : "14 mars 2024 à 14:30" ``` ```typescript // Gestion des fuseaux horaires const date = new Date('2024-03-14T14:30:45Z'); 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 en fonction de l'heure d'été ``` ## Remarques [#notes] * Utilise le même `Intl.DateTimeFormat` sous-jacent que la méthode de la classe GT. * Les résultats sont mis en cache en interne pour améliorer les performances lorsque les mêmes combinaisons de paramètres régionaux et d’options sont réutilisées. * Toutes les options standard de `Intl.DateTimeFormat` sont prises en charge. * Les fuseaux horaires sont correctement gérés lorsqu’ils sont spécifiés. Le résultat sans `timeZone` fixe dépend de l’environnement d’exécution.