【Qt】QTime::toString(“hh:mm:ss.zzz“) 显示乱码的原因与解决方案

jingjing~2025-08-02 8:26

在使用 Qt 编写计时器程序时，我遇到一个很奇怪的问题：使用 QTime::toString("hh:mm:ss.zzz") 格式化时间后，显示出来的是一串乱码，如下所示：

本来应该是：

但却显示了一堆"〇"或奇怪的符号。

问题表现

在界面上用 QLabel 或 QTextEdit 显示时间字符串时，代码如下：

cpp 复制代码

ui->showTime->setText(time.toString("hh:mm:ss.zzz"));

然而运行后，显示为全角符号或乱码:〇〇:〇〇:〇〈.〈『〇

原因分析

这是因为 toString("hh:mm:ss.zzz") 返回的字符串虽然是正常的数字格式，但Qt 的控件默认字体设置或语言环境不正确，导致它无法正常显示 ASCII 数字和标点符号，而退回到了全角字符或替代字符（如"〇"、"〈"、"『"等）来渲染。

特别是中文环境下，某些系统字体（例如仿宋、楷体）默认不支持半角英文数字，会强制显示全角字符。

解决方案(如果大家有什么好的解决方法可以评论区留言)

不要直接使用 time.toString() 输出格式化时间，而是使用 QString::arg 手动拼接字符串，确保每一段都是纯 ASCII 字符，并设置控件字体为标准字体。

cpp 复制代码

QString text = QString("%1:%2:%3.%4")
        .arg(time.hour(), 2, 10, QChar('0'))
        .arg(time.minute(), 2, 10, QChar('0'))
        .arg(time.second(), 2, 10, QChar('0'))
        .arg(time.msec(), 3, 10, QChar('0'));

ui->showTime->setText(text);

这样拼接出来的时间字符串是：00:01:23.045 绝对不会出现乱码问题。

结合打点记录功能

如果你有一个"标记"按钮，记录时间点，可以这样写：

cpp 复制代码

static int i = 0;
i++;
QString text = QString("第%1次打点：%2:%3:%4.%5")
        .arg(i)
        .arg(time.hour(), 2, 10, QChar('0'))
        .arg(time.minute(), 2, 10, QChar('0'))
        .arg(time.second(), 2, 10, QChar('0'))
        .arg(time.msec(), 3, 10, QChar('0'));

ui->bitTime->append(text);

总结

项目	内容
问题类型	Qt 显示乱码
关键词	`QTime::toString`、乱码、"〇〇"
解决方式	使用 `QString::arg` 拼接格式化时间字符串
推荐字体	Arial、微软雅黑（Microsoft YaHei）