# generaltranslation: General Translation Core SDK: formatDateTime URL: https://generaltranslation.com/fr/docs/core/class/methods/formatting/format-date-time.mdx --- title: formatDateTime description: Référence de l’API pour la méthode formatDateTime, qui formate les dates et heures selon les conventions du paramètre régional --- ## Vue d’ensemble La méthode `formatDateTime` met en forme les dates et les heures selon les conventions propres au paramètre régional à l’aide de l’API d’internationalisation. Elle gère automatiquement les formats de date et d’heure, les calendriers et les fuseaux horaires en fonction du paramètre régional cible. ```typescript const gt = new GT({ targetLocale: 'de-DE' }); const formatted = gt.formatDateTime(new Date(), { dateStyle: 'medium', timeStyle: 'short' }); // Retourne : "25.09.2025, 18:06" (formatage de date/heure en allemand) ``` ## Référence ### Paramètres | Nom | Type | Description | | ---------- | ----------------------- | --------------------------------- | | `date` | `Date` | L’objet Date à formater | | `options?` | `DateTimeFormatOptions` | Options de formatage facultatives | ### DateTimeFormatOptions Étend `Intl.DateTimeFormatOptions` en ajoutant une spécification de paramètre régional supplémentaire : | Nom | Type | Description | | ------------------------- | --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | | `locales?` | `string \| string[]` | Remplace les paramètres régionaux utilisés pour le formatage (utilise par défaut ceux de l'instance) | | `localeMatcher?` | `'lookup' \| 'best fit'` | Algorithme de correspondance des paramètres régionaux (par défaut : 'best fit') | | `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 | | `era?` | `'long' \| 'short' \| 'narrow'` | Représentation de l'ère | | `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 | | `dayPeriod?` | `'narrow' \| 'short' \| 'long'` | Formatage de la période de la journée (matin, après-midi, etc.) | | `hour?` | `'numeric' \| '2-digit'` | Représentation de l'heure | | `minute?` | `'numeric' \| '2-digit'` | Représentation des minutes | | `second?` | `'numeric' \| '2-digit'` | Représentation des secondes | | `fractionalSecondDigits?` | `1 \| 2 \| 3` | Nombre de chiffres des fractions de seconde | | `timeZoneName?` | `'long' \| 'short' \| 'longOffset' \| 'shortOffset' \| 'longGeneric' \| 'shortGeneric'` | Format du nom du fuseau horaire | | `timeZone?` | `string` | Identifiant de fuseau horaire IANA | | `hour12?` | `boolean` | Indique s'il faut utiliser le format horaire sur 12 heures | | `hourCycle?` | `'h11' \| 'h12' \| 'h23' \| 'h24'` | Préférence de cycle horaire | | `calendar?` | `string` | Système de calendrier à utiliser | | `numberingSystem?` | `string` | Système de numération pour les chiffres | | `formatMatcher?` | `'basic' \| 'best fit'` | Algorithme de correspondance du format (par défaut : 'best fit') | ### Renvoie `chaîne de caractères` - La date et l’heure formatées selon les conventions du paramètre régional. *** ## Exemples ### Formatage de base de la date et de l’heure ```typescript copy import { GT } from 'generaltranslation'; const gt = new GT({ targetLocale: 'en-US' }); const date = new Date('2024-03-14T14:30:45Z'); // Formatage de date de base (utilise les options par défaut) console.log(gt.formatDateTime(date)); // Output: "3/14/2024" // Formatage avec le paramètre régional allemand console.log(gt.formatDateTime(date, { locales: 'de-DE' })); // Output: "14.3.2024" // Formatage avec le paramètre régional japonais console.log(gt.formatDateTime(date, { locales: 'ja-JP' })); // Output: "2024/3/14" ``` ### Formats de date et d’heure ```typescript copy const date = new Date('2024-03-14T14:30:45Z'); // Style de date complet console.log(gt.formatDateTime(date, { dateStyle: 'full' })); // Sortie : « Thursday, March 14, 2024 » // Date longue avec heure courte console.log(gt.formatDateTime(date, { dateStyle: 'long', timeStyle: 'short' })); // Sortie : « March 14, 2024 at 7:30 AM » // Composants de date personnalisés console.log(gt.formatDateTime(date, { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' })); // Sortie : « Thursday, March 14, 2024 » ``` ### Fuseau horaire et format de l’heure ```typescript copy const date = new Date('2024-03-14T14:30:45Z'); // Forcer le format 12 heures console.log(gt.formatDateTime(date, { hour: 'numeric', minute: '2-digit', hour12: true })); // Output: "7:30 AM" // Forcer le format 24 heures console.log(gt.formatDateTime(date, { hour: 'numeric', minute: '2-digit', hour12: false })); // Output: "07:30" // Fuseau horaire spécifique console.log(gt.formatDateTime(date, { timeZone: 'America/New_York', dateStyle: 'medium', timeStyle: 'short' })); // Output: "Mar 14, 2024, 10:30 AM" ``` *** ## Remarques * Le formatage des dates suit automatiquement les conventions propres au paramètre régional * La méthode utilise `Intl.DateTimeFormat`, natif au navigateur, pour des performances et une précision optimales * Les fuseaux horaires sont correctement gérés lorsqu’ils sont spécifiés ## Méthodes associées * Consultez la documentation de [`Intl.DateTimeFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat) pour accéder à davantage d’options * Consultez [`formatMessage`](/docs/core/class/methods/formatting/format-message) pour le formatage de messages avec interpolation de dates * Consultez la version autonome de [`formatDateTime`](/docs/core/functions/formatting/format-date-time) pour l’utiliser sans instance GT * Consultez [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties) pour obtenir des informations de calendrier spécifiques au paramètre régional ## Prochaines étapes