Qt C++ windows 设置系统时间

原创于 2025-12-02 09:34:15 发布 · 225 阅读

4 ·

CC 4.0 BY-SA版权

版权所属：https://xuemingde.com

文章标签：

#qt #c++ #windows

Qt 专栏收录该内容

27 篇文章

订阅专栏

在 Qt C++ 中设置 Windows 系统时间，需要调用 Windows API 函数 SetSystemTime，并注意权限问题（需管理员权限）。以下是完整的实现方案：

一、核心原理

Windows API 函数：SetSystemTime（设置系统时间，使用 UTC 时间）
权限要求：必须以管理员身份运行程序，否则设置会失败
时间转换：SetSystemTime 要求传入 UTC 时间，需将本地时间转换为 UTC 时间
头文件依赖：需要包含 Windows 系统头文件

二、完整实现代码

#include <QCoreApplication>
#include <QDateTime>
#include <QDebug>
#include <windows.h>  // Windows API 头文件

/**
 * @brief 设置 Windows 系统时间
 * @param newTime 要设置的本地时间（QDateTime）
 * @return 成功返回 true，失败返回 false
 */
bool setWindowsSystemTime(const QDateTime& newTime)
{
    // 1. 检查时间有效性
    if (!newTime.isValid()) {
        qWarning() << "无效的时间";
        return false;
    }

    // 2. 将本地时间转换为 UTC 时间（SetSystemTime 要求 UTC 时间）
    QDateTime utcTime = newTime.toUTC();

    // 3. 构造 SYSTEMTIME 结构体（Windows API 要求的时间格式）
    SYSTEMTIME st{};
    st.wYear = static_cast<WORD>(utcTime.date().year());
    st.wMonth = static_cast<WORD>(utcTime.date().month());
    st.wDayOfWeek = static_cast<WORD>(utcTime.date().dayOfWeek());  // 星期（0=星期日，1=星期一...6=星期六）
    st.wDay = static_cast<WORD>(utcTime.date().day());
    st.wHour = static_cast<WORD>(utcTime.time().hour());
    st.wMinute = static_cast<WORD>(utcTime.time().minute());
    st.wSecond = static_cast<WORD>(utcTime.time().second());
    st.wMilliseconds = static_cast<WORD>(utcTime.time().msec());

    // 4. 调用 Windows API 设置系统时间
    BOOL result = SetSystemTime(&st);
    if (!result) {
        // 获取错误信息
        DWORD errorCode = GetLastError();
        qWarning() << "设置系统时间失败，错误码：" << errorCode;
        return false;
    }

    qInfo() << "系统时间设置成功！新时间（本地）：" << newTime.toString("yyyy-MM-dd HH:mm:ss.zzz");
    return true;
}

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    // 示例1：设置为指定的本地时间（2025年12月1日 10:30:00）
    QDateTime targetTime = QDateTime::fromString("2025-12-01 10:30:00", "yyyy-MM-dd HH:mm:ss");
    bool success = setWindowsSystemTime(targetTime);

    // 示例2：设置为当前时间 + 1小时（演示动态时间设置）
    // QDateTime targetTime = QDateTime::currentDateTime().addSecs(3600);
    // bool success = setWindowsSystemTime(targetTime);

    return success ? 0 : 1;
}

三、关键说明

1. 权限配置（必须）

Windows 不允许普通用户修改系统时间，因此程序必须以管理员身份运行：

手动运行：右键程序 → 选择「以管理员身份运行」
编译时自动配置（Qt Creator）：
1. 打开项目文件（.pro）
2. 添加以下代码（仅 Windows 平台）：
```
win32 {
    # 请求管理员权限
    QMAKE_LFLAGS += /MANIFESTUAC:\"level=\'requireAdministrator\' uiAccess=\'false\'\"
}
```
3. 重新构建项目，生成的exe会自动提示需要管理员权限

2. 时间转换注意事项

SetSystemTime 接收 UTC 时间，而 QDateTime::currentDateTime() 获取的是本地时间
必须使用 toUTC() 转换为 UTC 时间，否则设置的时间会存在时区偏差
如果需要直接设置 UTC 时间，可以使用 QDateTime::currentDateTimeUtc()

3. 错误处理

使用 GetLastError() 获取错误码，常见错误：
- 错误码 5：权限不足（未以管理员身份运行）
- 错误码 1314：需要特权（通常也是权限问题）
- 错误码 87：参数错误（时间格式无效）

4. 兼容问题

该代码仅适用于 Windows 系统（依赖 windows.h）
支持 Windows 7 及以上系统
Qt 版本要求：Qt 5.0 及以上（推荐 Qt 5.12+ 或 Qt 6.x）

四、测试方法

按照上述配置权限
编译运行程序
检查系统时间是否被修改为指定时间（可在 Windows 设置 → 时间和语言中查看）

五、扩展功能（可选）

1. 验证时间是否设置成功

可以在设置后立即读取系统时间并验证：

// 设置后验证
QDateTime afterSetTime = QDateTime::currentDateTime();
qInfo() << "设置后系统时间（本地）：" << afterSetTime.toString("yyyy-MM-dd HH:mm:ss.zzz");
if (qAbs(afterSetTime.msecsTo(targetTime)) < 1000) {  // 允许1秒误差
    qInfo() << "时间验证成功！";
} else {
    qWarning() << "时间验证失败！";
}

2. 只修改日期或只修改时间

// 只修改日期（保持当前时间）
QDateTime current = QDateTime::currentDateTime();
QDate targetDate(2025, 12, 1);
QDateTime targetTime(current.date().setDate(targetDate), current.time());

// 只修改时间（保持当前日期）
QTime targetTime(14, 30, 0);
QDateTime targetTime(QDate::currentDate(), targetTime);