Reloj localizado con cambio de idioma en tiempo de ejecución
El ejemplo muestra las mejores prácticas para utilizar las funciones de traducción y localización de Qt en CMake y Qt Quick, en concreto, cómo cambiar el idioma de una aplicación durante la ejecución. Amplía el ejemplo más sencillo del «Reloj localizado».
Consulta el manual «Qt Linguist » para obtener más información sobre la traducción de aplicaciones Qt.
Interfaz de usuario
El ejemplo muestra la hora y la fecha actuales según la configuración regional y el idioma de su sistema. Los textos de la interfaz de usuario también están traducidos a los siguientes idiomas: inglés, alemán, francés, español, italiano, japonés, coreano, portugués, árabe y chino. Los usuarios también pueden utilizar un botón de menú para seleccionar diferentes idiomas y configuraciones regionales.
La versión en inglés de la aplicación:

La versión en alemán tras cambiar el idioma en tiempo de ejecución:

Implementación
La aplicación consta de cuatro partes:
CMakeLists.txt
La integración con CMake es la misma que la del ejemplo «Reloj localizado ». Consulta esa página para obtener más detalles.
main.cpp
El punto de partida de la aplicación, encargado de cargar el módulo QML.
int main(int argc, char *argv[])
{
QGuiApplication app(argc, argv);
QQmlApplicationEngine engine;
QObject::connect(
&engine, &QQmlApplicationEngine::objectCreationFailed, &app,
[](const QUrl &) { QCoreApplication::exit(-1); }, Qt::QueuedConnection);
engine.loadFromModule("qtexamples.localizedclockswitchlocale", "Main");
return app.exec();
}Gestor de traductores (translator.h, translator.cpp)
TranslatorManager es una clase singleton de QML que gestiona el cambio de idioma y de configuración regional en tiempo de ejecución. El método principal de la clase es ` TranslatorManager::switchLanguage()`, que acepta una cadena que representa un código de idioma.
Aunque el método está marcado con ` Q_INVOKABLE`, la clase `TranslatorManager` se declara con ` QML_ELEMENT ` y `QML_SINGLETON`. Esto permite acceder directamente al método desde QML; véase también `Main.qml`.
void TranslatorManager::switchLanguage(const QString&lang)
{
QLocale locale(lang);
QLocale::setDefault(locale);
qApp->removeTranslator(&m_translator); // not necessary from Qt 6.10
if (m_translator.load(locale, "clock"_L1, "_"_L1, ":/i18n/"_L1)
&& qApp->installTranslator(&m_translator)) {
m_engine.retranslate();
} else {
qWarning("Could not load translation to %s!", qPrintable(locale.name()));
}
}Actualización de traducciones en tiempo de ejecución
Al cambiar de idioma, se elimina la traducción anterior (QCoreApplication::removeTranslator()) y se carga (QTranslator::load()) e instala (QCoreApplication::installTranslator()) una nueva traducción para el idioma seleccionado. A continuación, QQmlEngine::retranslate() activa la retraducción de las cadenas del documento QML.
Actualización de los formatos de fecha y hora
El cambio de idioma también podría afectar a la forma en que se muestran las fechas y las horas. Por ejemplo, si QLocale en tu sistema prefiere la configuración regional «en_US» para «en» y «de_DE» para «de»:
- La aplicación se carga inicialmente con «US» como código de país.
- Debido a las convenciones de la configuración regional de EE. UU., la fecha se muestra en formato MM/DD/AAAA y la hora utiliza el formato de 12 horas.
- Tras cambiar el idioma al alemán, «de_DE» es la configuración regional preferida para el alemán, por lo que el país cambia a Alemania.
- Las convenciones alemanas establecen que la fecha se muestre en el formato DD.MM.AAAA y que se utilice el formato de 24 horas.
Al cambiar el idioma, la aplicación actualiza su objeto ` QLocale ` según el idioma seleccionado mediante ` QLocale::setDefault()`. A la hora de representar la hora, la función `Date.toLocaleTimeString()` se encarga de localizar la hora y la fecha según la configuración regional de la aplicación (véase Main.qml).
Main.qml
El archivo QML principal define la interfaz de usuario de la aplicación. La interfaz de usuario muestra la hora, la fecha y un contador de segundos. Para la traducción básica (título de la ventana) y el tratamiento del plural (número de segundos), consulta el ejemplo «Reloj localizado ».
Al seleccionar un elemento de la lista « Menu », se llama a « TranslatorManager.switchLanguage() » con el código de idioma correspondiente. Esta llamada también se encarga de volver a traducir los textos traducibles (véase «Gestor de traductores»). Sin embargo, aún debemos invocar « updateClock() » para actualizar la representación de la hora en el nuevo formato de localización cuando se cambia el idioma.
ListModel {
id: languageModel
ListElement { name: "English"; code: "en" }
ListElement { name: "Deutsch"; code: "de" }
ListElement { name: "العربية"; code: "ar" }
ListElement { name: "한국어"; code: "ko" }
ListElement { name: "中文"; code: "zh" }
ListElement { name: "日本語"; code: "ja" }
ListElement { name: "Français"; code: "fr" }
ListElement { name: "Italiano"; code: "it" }
ListElement { name: "Español"; code: "es" }
ListElement { name: "Português"; code: "pt" }
}
Menu {
id: languageMenu
width: languageButton.width
Repeater {
model: languageModel
delegate: MenuItem {
required property string name
required property string code
text: name
onTriggered: {
TranslatorManager.switchLanguage(code)
root.selectedLanguage = name
root.updateClock()
}
}
}
}© 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.