# generaltranslation: General Translation Core SDK: formatDateTime URL: https://generaltranslation.com/es/docs/core/class/methods/formatting/format-date-time.mdx --- title: formatDateTime description: Referencia de la API del método formatDateTime para dar formato a fechas y horas según las convenciones de la configuración regional --- ## Resumen El método `formatDateTime` da formato a fechas y horas según las convenciones específicas de la configuración regional mediante la API de internacionalización. Maneja automáticamente los formatos de fecha y hora, los calendarios y las zonas horarias en función de la configuración regional de destino. ```typescript const gt = new GT({ targetLocale: 'de-DE' }); const formatted = gt.formatDateTime(new Date(), { dateStyle: 'medium', timeStyle: 'short' }); // Devuelve: "25.09.2025, 18:06" (formato de fecha/hora en alemán) ``` ## Referencia ### Parámetros | Nombre | Tipo | Descripción | | ---------- | ----------------------- | ---------------------------------------- | | `date` | `Date` | El objeto de fecha que se va a formatear | | `options?` | `DateTimeFormatOptions` | Configuración de formato opcional | ### DateTimeFormatOptions Extiende `Intl.DateTimeFormatOptions` con una especificación adicional de configuración regional: | nombre | tipo | Descripción | | ------------------------- | --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | `locales?` | `string \| string[]` | Sobrescribe `locales` para el formato (valor predeterminado: `locales` de la instancia) | | `localeMatcher?` | `'lookup' \| 'best fit'` | Algoritmo de coincidencia de configuración regional (valor predeterminado: 'best fit') | | `dateStyle?` | `'full' \| 'long' \| 'medium' \| 'short'` | Estilo general de formato de fecha | | `timeStyle?` | `'full' \| 'long' \| 'medium' \| 'short'` | Estilo general de formato de hora | | `weekday?` | `'long' \| 'short' \| 'narrow'` | Representación del día de la semana | | `era?` | `'long' \| 'short' \| 'narrow'` | Representación de la era | | `year?` | `'numeric' \| '2-digit'` | Representación del año | | `month?` | `'numeric' \| '2-digit' \| 'long' \| 'short' \| 'narrow'` | Representación del mes | | `day?` | `'numeric' \| '2-digit'` | Representación del día | | `dayPeriod?` | `'narrow' \| 'short' \| 'long'` | Formato del período del día (mañana, tarde, etc.) | | `hour?` | `'numeric' \| '2-digit'` | Representación de la hora | | `minute?` | `'numeric' \| '2-digit'` | Representación del minuto | | `second?` | `'numeric' \| '2-digit'` | Representación del segundo | | `fractionalSecondDigits?` | `1 \| 2 \| 3` | Número de dígitos fraccionarios de segundo | | `timeZoneName?` | `'long' \| 'short' \| 'longOffset' \| 'shortOffset' \| 'longGeneric' \| 'shortGeneric'` | Formato del nombre de la zona horaria | | `timeZone?` | `string` | Identificador de zona horaria de IANA | | `hour12?` | `boolean` | Indica si se usa el formato de 12 horas | | `hourCycle?` | `'h11' \| 'h12' \| 'h23' \| 'h24'` | Preferencia de ciclo horario | | `calendar?` | `string` | Sistema de calendario que se usará | | `numberingSystem?` | `string` | Sistema de numeración para los dígitos | | `formatMatcher?` | `'basic' \| 'best fit'` | Algoritmo de coincidencia de formato (valor predeterminado: 'best fit') | ### Devuelve `string` - La fecha y hora con el formato correspondiente según las convenciones de la configuración regional. *** ## Ejemplos ### Formato básico de fecha y hora ```typescript copy import { GT } from 'generaltranslation'; const gt = new GT({ targetLocale: 'en-US' }); const date = new Date('2024-03-14T14:30:45Z'); // Formato de fecha básico (usa opciones predeterminadas) console.log(gt.formatDateTime(date)); // Salida: "3/14/2024" // Formato con configuración regional alemana console.log(gt.formatDateTime(date, { locales: 'de-DE' })); // Salida: "14.3.2024" // Formato con configuración regional japonesa console.log(gt.formatDateTime(date, { locales: 'ja-JP' })); // Salida: "2024/3/14" ``` ### Formatos de fecha y hora ```typescript copy const date = new Date('2024-03-14T14:30:45Z'); // Estilo de fecha completo console.log(gt.formatDateTime(date, { dateStyle: 'full' })); // Salida: "Thursday, March 14, 2024" // Fecha larga con hora corta console.log(gt.formatDateTime(date, { dateStyle: 'long', timeStyle: 'short' })); // Salida: "March 14, 2024 at 7:30 AM" // Componentes de fecha personalizados console.log(gt.formatDateTime(date, { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' })); // Salida: "Thursday, March 14, 2024" ``` ### Zona horaria y formato de hora ```typescript copy const date = new Date('2024-03-14T14:30:45Z'); // Forzar formato de 12 horas console.log(gt.formatDateTime(date, { hour: 'numeric', minute: '2-digit', hour12: true })); // Salida: "7:30 AM" // Forzar formato de 24 horas console.log(gt.formatDateTime(date, { hour: 'numeric', minute: '2-digit', hour12: false })); // Salida: "07:30" // Zona horaria específica console.log(gt.formatDateTime(date, { timeZone: 'America/New_York', dateStyle: 'medium', timeStyle: 'short' })); // Salida: "Mar 14, 2024, 10:30 AM" ``` *** ## Notas * El formato de fecha sigue automáticamente las convenciones específicas de la configuración regional * El método usa `Intl.DateTimeFormat` nativo del navegador para ofrecer un rendimiento y una precisión óptimos * Las zonas horarias se manejan correctamente cuando se especifican ## Métodos relacionados * Consulta la [documentación de `Intl.DateTimeFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat) para conocer más opciones * Consulta [`formatMessage`](/docs/core/class/methods/formatting/format-message) para dar formato a mensajes con interpolación de fechas * Consulta [`formatDateTime`](/docs/core/functions/formatting/format-date-time) como función independiente para usarlo sin una instancia de GT * Consulta [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties) para obtener información del calendario específica de la configuración regional ## Próximos pasos