El objeto Date de JavaScript
El objeto «Date» de QML amplía el objeto «Date» de JavaScript con funciones que tienen en cuenta la configuración regional.
Las funciones que aceptan un argumento ` format ` admiten valores de la enumeración `Locale.LongFormat`, `Locale.ShortFormat` o `Locale.NarrowFormat`, o bien una cadena que especifique el formato.
El formato de las cadenas de formato admitidas es el descrito en la documentación de QDate::toString(), QTime::toString() y QDateTime::toString().
Si la fecha no es válida, se devuelve una cadena vacía.
Valores de la enumeración de formatos
Utilice los valores de la enumeración cuando desee un formato que se ajuste a las preferencias de la configuración regional.
| Locale.LongFormat | Formato extenso |
| Locale.ShortFormat | Formato más breve |
| Locale.NarrowFormat | En este contexto, es lo mismo que Locale.ShortFormat |
El formato que representan las enumeraciones dependerá de tu configuración regional, pero también del método para el que se utilice la enumeración.
Por ejemplo, para la configuración regional en_US, se utilizan estas cadenas de formato:
| Función | Enumeración de configuración regional | Cadena de formato |
|---|---|---|
| fromLocaleDateString, toLocaleDateString | Locale.LongFormat | dddd, MMMM d, yyyy |
| fromLocaleDateString, toLocaleDateString | Locale.ShortFormat | M/d/yy |
| fromLocaleTimeString, toLocaleTimeString | Locale.LongFormat | h:mm:ss AP t |
| cadenaDeHoraDeLaConfiguraciónRegionalDeOrigen, cadenaDeHoraDeLaConfiguraciónRegionalDeDestino | Locale.ShortFormat | h:mm AP |
| cadenaDeLaConfiguraciónDeRegiónDeOrigen, cadenaDeLaConfiguraciónDeRegiónDeDestino | Locale.LongFormat | dddd, MMMM d, yyyy h:mm:ss AP t |
| cadenaDeOrigen, cadenaDeDestino | Locale.ShortFormat | M/d/yy h:mm AP |
Notas adicionales
El uso de las funciones sensibles a la configuración regional para dar formato a la fecha o la hora puede dar lugar a horas con un formato incorrecto, debido a una inconsistencia en las especificaciones entre Qt y JS. La norma ECMA-262 especifica que las fechas históricas deben interpretarse aplicando las reglas actuales sobre el horario de verano a los años pasados, mientras que Qt utiliza datos históricos (cuando están disponibles) para determinar si el horario de verano estaba en vigor en una fecha determinada. Por lo tanto, crear un valor de fecha en JS y convertirlo a una cadena utilizando las funciones sensibles a la configuración regional puede dar lugar a un resultado con un error de una hora, si el horario de verano está actualmente en vigor, mientras que no lo estaba en el momento especificado, o viceversa.
Existen diferentes formatos de fecha con diferentes interpretaciones de los años negativos. El lenguaje coloquial no cuenta con un año 0. El año siguiente al 1 a. C. es el 1 d. C. Esta interpretación se refleja al mostrar o analizar fechas en alguno de los formatos no estandarizados por ECMAScript. Es decir: toString(), toLocaleString(), toUTCString() y similares. ECMAScript sí estandariza un formato: ISO 8601. Este es el resultado que se obtiene al llamar a toISOString(). Este formato incluye un año 0, que en otros formatos corresponde al año 1 a. C. Por lo tanto, se obtienen años diferentes al mostrar fechas negativas con toISOString() y toString().
Al establecer el año mediante el constructor Date o set(UTC)FullYear(), se utiliza la convención establecida por la norma ISO 8601, según la cual el 0 es un año válido. Esto significa que los años negativos establecidos con el constructor o con set(UTC)FullYear() se cuentan a partir del cero y, por lo tanto, presentan un desfase de un año respecto a lo que se muestra con toString() y métodos similares. Al analizar la salida de cualquiera de los métodos to*String(), se obtendrá el mismo valor de fecha que el que se ha impreso. Date.parse() reconocerá los diferentes formatos y su convención respecto a la existencia del año 0.
Ten en cuenta que todo esto difiere de lo que se obtiene en otras implementaciones de JavaScript, que suelen tratar el año 0 como válido en todas las representaciones de cadena. No obstante, dado que los formatos de fecha son «dependientes de la implementación» en el estándar ECMAScript, esto sigue siendo válido.
cadena Date::toLocaleString(locale, format)
Convierte la fecha en una cadena que contiene la fecha y la hora adecuadas para la configuración regional especificada ( locale ) en el formato especificado ( format).
Si no se especifica « format », se utilizará « Locale.LongFormat ».
Si no se especifica locale, se utilizará la configuración regional por defecto.
El siguiente ejemplo muestra la fecha y la hora actuales con el formato correspondiente a la configuración regional alemana:
string Date::toLocaleDateString(locale, format)
Convierte la fecha en una cadena que contiene la fecha adecuada para la configuración regional especificada ( locale ) en la configuración regional especificada ( format).
Si no se especifica « format », se utilizará « Locale.LongFormat ».
Si no se especifica locale, se utilizará la configuración regional predeterminada.
El siguiente ejemplo muestra la fecha actual formateada según la configuración regional alemana:
import QtQuick 2.0
Text {
text: "The date is: " + new Date().toLocaleDateString(Qt.locale("de_DE"))
}string Date::toLocaleTimeString(locale, format)
Convierte la fecha en una cadena que contiene la hora adecuada para la configuración regional especificada ( locale ) en el formato especificado ( format).
Si no se especifica « format », se utilizará « Locale.LongFormat ».
Si no se especifica locale, se utilizará la configuración regional predeterminada.
El siguiente ejemplo muestra la hora actual formateada según la configuración regional alemana:
import QtQuick 2.0
Text {
text: "The date is: " + new Date().toLocaleTimeString(Qt.locale("de_DE"))
}string Date::fromLocaleString(locale, dateTimeString, format)
Convierte la cadena de fecha y hora dateTimeString en un objeto Date utilizando locale y format.
Si no se especifica format, se utilizará Locale.LongFormat.
Si no se especifica locale, se utilizará la configuración regional predeterminada.
El siguiente ejemplo muestra cómo se analiza una fecha y hora a partir de una cadena de fecha y hora en un formato determinado utilizando la configuración regional predeterminada:
import QtQml 2.0
QtObject {
property var locale: Qt.locale()
property string dateTimeString: "Tue 2013-09-17 10:56:06"
Component.onCompleted: {
print(Date.fromLocaleString(locale, dateTimeString, "ddd yyyy-MM-dd hh:mm:ss"));
}
}string Date::fromLocaleDateString(locale, dateString, format)
Convierte la cadena de fecha dateString en un objeto Date utilizando locale y format.
Si no se especifica format, se utilizará Locale.LongFormat.
Si no se especifica locale, se utilizará la configuración regional predeterminada.
El siguiente ejemplo muestra cómo la fecha actual se formatea primero como una cadena de fecha utilizando la configuración regional y el formato predeterminados, y luego se vuelve a analizar de la misma manera:
import QtQml 2.0
QtObject {
property var locale: Qt.locale()
property date currentDate: new Date()
property string dateString
Component.onCompleted: {
dateString = currentDate.toLocaleDateString();
print(Date.fromLocaleDateString(dateString));
}
}string Date::fromLocaleTimeString(locale, timeString, format)
Convierte la cadena de tiempo timeString en un objeto Date utilizando locale y format.
Si no se especifica format, se utilizará Locale.LongFormat.
Si no se especifica locale, se utilizará la configuración regional predeterminada.
El siguiente ejemplo muestra cómo la hora actual se formatea primero como una cadena de tiempo utilizando la configuración regional predeterminada y un formato corto, y luego se vuelve a analizar de la misma manera:
import QtQml 2.2
QtObject {
property var locale: Qt.locale()
property date currentTime: new Date()
property string timeString
Component.onCompleted: {
timeString = currentTime.toLocaleTimeString(locale, Locale.ShortFormat);
print(Date.fromLocaleTimeString(locale, timeString, Locale.ShortFormat));
}
}string Date::timeZoneUpdated()
Informa al motor de JS de que se ha cambiado la zona horaria del sistema, lo cual es necesario para la correcta manipulación de los datos de fecha y hora.
JS almacena los objetos Date en hora UTC; todo acceso a y desde los componentes Date en hora local implica la aplicación del desfase actual respecto a UTC. Si el desfase actual cambia debido a la actualización de la zona horaria, es necesario informar al motor JS para que pueda recalcular el desfase.
Esta función debe llamarse después de que se haya actualizado la zona horaria del sistema.
Por ejemplo, una aplicación que cambie la zona horaria llamaría a timeZoneUpdated() tras establecer la nueva zona horaria:
property string selectedTimeZone
onSelectedTimeZoneChanged: {
MyFunctions.setSystemTimeZone(selectedTimeZone)
Date.timeZoneUpdated()
}Véase también Locale.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.