# generaltranslation: General Translation Core SDK: formatDateTime URL: https://generaltranslation.com/it/docs/core/class/methods/formatting/format-date-time.mdx --- title: formatDateTime description: Riferimento API per il metodo formatDateTime, che formatta date e orari secondo le convenzioni dell'impostazione regionale --- ## Panoramica Il metodo `formatDateTime` formatta date e ore in base alle convenzioni specifiche dell'impostazione regionale utilizzando l'API di internazionalizzazione. Gestisce automaticamente i formati di data e ora, i calendari e i fusi orari in base all'impostazione regionale di destinazione. ```typescript const gt = new GT({ targetLocale: 'de-DE' }); const formatted = gt.formatDateTime(new Date(), { dateStyle: 'medium', timeStyle: 'short' }); // Restituisce: "25.09.2025, 18:06" (formattazione data/ora in tedesco) ``` ## Riferimento ### Parametri | Nome | Tipo | Descrizione | | ---------- | ----------------------- | ----------------------------------------- | | `date` | `Date` | L'oggetto data da formattare | | `options?` | `DateTimeFormatOptions` | Configurazione di formattazione opzionale | ### DateTimeFormatOptions Estende `Intl.DateTimeFormatOptions` con opzioni aggiuntive per specificare l'impostazione regionale: | Nome | Tipo | Descrizione | | ------------------------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | `locales?` | `string \| string[]` | Sovrascrive le impostazioni regionali usate per la formattazione (per impostazione predefinita usa quelle dell'istanza) | | `localeMatcher?` | `'lookup' \| 'best fit'` | Algoritmo di corrispondenza dell'impostazione regionale (predefinito: 'best fit') | | `dateStyle?` | `'full' \| 'long' \| 'medium' \| 'short'` | Stile generale di formattazione della data | | `timeStyle?` | `'full' \| 'long' \| 'medium' \| 'short'` | Stile generale di formattazione dell'ora | | `weekday?` | `'long' \| 'short' \| 'narrow'` | Rappresentazione del giorno della settimana | | `era?` | `'long' \| 'short' \| 'narrow'` | Rappresentazione dell'era | | `year?` | `'numeric' \| '2-digit'` | Rappresentazione dell'anno | | `month?` | `'numeric' \| '2-digit' \| 'long' \| 'short' \| 'narrow'` | Rappresentazione del mese | | `day?` | `'numeric' \| '2-digit'` | Rappresentazione del giorno | | `dayPeriod?` | `'narrow' \| 'short' \| 'long'` | Formattazione del periodo della giornata (mattina, pomeriggio, ecc.) | | `hour?` | `'numeric' \| '2-digit'` | Rappresentazione dell'ora | | `minute?` | `'numeric' \| '2-digit'` | Rappresentazione del minuto | | `second?` | `'numeric' \| '2-digit'` | Rappresentazione del secondo | | `fractionalSecondDigits?` | `1 \| 2 \| 3` | Numero di cifre frazionarie dei secondi | | `timeZoneName?` | `'long' \| 'short' \| 'longOffset' \| 'shortOffset' \| 'longGeneric' \| 'shortGeneric'` | Formato del nome del fuso orario | | `timeZone?` | `string` | Identificatore del fuso orario IANA | | `hour12?` | `boolean` | Indica se usare il formato orario a 12 ore | | `hourCycle?` | `'h11' \| 'h12' \| 'h23' \| 'h24'` | Preferenza per il ciclo orario | | `calendar?` | `string` | Sistema di calendario da usare | | `numberingSystem?` | `string` | Sistema di numerazione delle cifre | | `formatMatcher?` | `'basic' \| 'best fit'` | Algoritmo di corrispondenza del formato (predefinito: 'best fit') | ### Restituisce `string` - La data e l'ora formattate in base alle convenzioni dell'impostazione regionale. *** ## Esempi ### Formattazione di base di date e orari ```typescript copy import { GT } from 'generaltranslation'; const gt = new GT({ targetLocale: 'en-US' }); const date = new Date('2024-03-14T14:30:45Z'); // Formattazione di base della data (usa le opzioni predefinite) console.log(gt.formatDateTime(date)); // Output: "3/14/2024" // Formattazione con impostazione regionale tedesca console.log(gt.formatDateTime(date, { locales: 'de-DE' })); // Output: "14.3.2024" // Formattazione con impostazione regionale giapponese console.log(gt.formatDateTime(date, { locales: 'ja-JP' })); // Output: "2024/3/14" ``` ### Formati di data e ora ```typescript copy const date = new Date('2024-03-14T14:30:45Z'); // Stile data completo console.log(gt.formatDateTime(date, { dateStyle: 'full' })); // Output: "Thursday, March 14, 2024" // Data lunga con ora breve console.log(gt.formatDateTime(date, { dateStyle: 'long', timeStyle: 'short' })); // Output: "March 14, 2024 at 7:30 AM" // Componenti data personalizzati console.log(gt.formatDateTime(date, { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' })); // Output: "Thursday, March 14, 2024" ``` ### Fuso orario e formato dell’ora ```typescript copy const date = new Date('2024-03-14T14:30:45Z'); // Forza il formato a 12 ore console.log(gt.formatDateTime(date, { hour: 'numeric', minute: '2-digit', hour12: true })); // Output: "7:30 AM" // Forza il formato a 24 ore console.log(gt.formatDateTime(date, { hour: 'numeric', minute: '2-digit', hour12: false })); // Output: "07:30" // Fuso orario specifico console.log(gt.formatDateTime(date, { timeZone: 'America/New_York', dateStyle: 'medium', timeStyle: 'short' })); // Output: "Mar 14, 2024, 10:30 AM" ``` *** ## Note * La formattazione della data segue automaticamente le convenzioni specifiche dell’impostazione regionale * Il metodo usa `Intl.DateTimeFormat` nativo del browser per prestazioni e precisione ottimali * I fusi orari vengono gestiti correttamente quando sono specificati ## Metodi correlati * Consulta la documentazione di [`Intl.DateTimeFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat) per ulteriori opzioni * Vedi [`formatMessage`](/docs/core/class/methods/formatting/format-message) per la formattazione dei messaggi con interpolazione di date * Vedi [`formatDateTime`](/docs/core/functions/formatting/format-date-time) in versione autonoma, per l'uso senza un'istanza di GT * Vedi [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties) per informazioni sul calendario specifiche per l'impostazione regionale ## Passi successivi