# General Translation Platform: formatDateTime URL: https://generaltranslation.com/fr/docs/platform/core/reference/utility-functions/formatting/format-date-time.mdx Docs index: https://generaltranslation.com/llms.txt 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. Le tableau répertorie les options courantes exposées par les types de la bibliothèque principale publiés et leurs valeurs par défaut effectives dans la bibliothèque principale. (Consultez les [options du constructeur `Intl.DateTimeFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat#options) pour obtenir des détails supplémentaires sur les normes et les spécificités de l’environnement d’exécution). | Propriété | Description | Type | Facultatif | Par défaut | | ------------------------ | --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ---------- | -------------------------------------------------------- | | `locales` | Paramètre(s) régional(aux) utilisé(s) pour le formatage. Lorsqu’un tableau est fourni, ils sont essayés dans l’ordre. | `string \| string[]` | Oui | `en` | | `localeMatcher` | Algorithme de correspondance des paramètres régionaux. | `'lookup' \| 'best fit'` | Oui | `'best fit'` | | `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 | — | | `era` | Représentation de l’ère. | `'long' \| 'short' \| 'narrow'` | Oui | — | | `year` | Représentation de l’année. | `'numeric' \| '2-digit'` | Oui | `'numeric'` lorsqu’aucun style ni composant n’est défini | | `month` | Représentation du mois. | `'numeric' \| '2-digit' \| 'long' \| 'short' \| 'narrow'` | Oui | `'numeric'` lorsqu’aucun style ni composant n’est défini | | `day` | Représentation du jour. | `'numeric' \| '2-digit'` | Oui | `'numeric'` lorsqu’aucun style ni composant n’est défini | | `dayPeriod` | Largeur de la période de la journée pour les cycles de 12 heures. | `'narrow' \| 'short' \| 'long'` | 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 | — | | `fractionalSecondDigits` | Nombre de chiffres pour les secondes fractionnaires. | `1 \| 2 \| 3` | Oui | — | | `timeZoneName` | Format du nom du fuseau horaire. | `'long' \| 'short' \| 'longOffset' \| 'shortOffset' \| 'longGeneric' \| 'shortGeneric'` | Oui | — | | `timeZone` | Nom de fuseau horaire IANA ou identifiant de décalage UTC pris en charge. | `string` | Oui | fuseau horaire de l’environnement d’exécution | | `hour12` | Indique s’il faut utiliser le format horaire sur 12 heures. | `boolean` | Oui | dépend du paramètre régional | | `hourCycle` | Préférence de cycle horaire. | `'h11' \| 'h12' \| 'h23' \| 'h24'` | Oui | dépend du paramètre régional | | `calendar` | Système calendaire à utiliser. | `string` | Oui | `'gregory'` | | `numberingSystem` | Système de numérotation des chiffres. | `string` | Oui | `'latn'` | | `formatMatcher` | Algorithme de correspondance de format. | `'basic' \| 'best fit'` | Oui | `'best fit'` | `dateStyle` et `timeStyle` peuvent être combinés, mais pas avec des options individuelles de composant de date et d’heure telles que `year`, `month` ou `hour`. `hour12` prévaut sur `hourCycle`, et `dayPeriod` n’affecte que les cycles de 12 heures. La bibliothèque principale définit `calendar: 'gregory'` et `numberingSystem: 'latn'` ; sinon, `Intl.DateTimeFormat` choisit les deux en fonction du paramètre régional. ## 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. ## Sitemap See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.