VariantTimeToSystemTime

VariantTimeToSystemTime 是一个 Windows API 函数，用于将 VARIANT 类型的日期时间值转换为 SYSTEMTIME 结构体类型的日期时间值。

在 COM 编程中，经常需要使用 VARIANT 类型来表示日期时间值。VARIANT 类型是一种通用的数据类型，可以存储多种不同的数据类型，如数字、字符串、日期时间等。其中，日期时间类型的值是以双精度浮点数的形式存储的，表示自 1899 年 12 月 30 日起的天数。

VariantTimeToSystemTime 函数可以将这种以天数表示的日期时间值转换为 SYSTEMTIME 结构体类型的日期时间值。SYSTEMTIME 结构体类型是 Windows 操作系统中用于表示日期时间的一种结构体类型，包含年、月、日、时、分、秒等字段。

函数的原型如下：

BOOL VariantTimeToSystemTime(
  DOUBLE  vtime,
  LPSYSTEMTIME lpSystemTime
);

其中，vtime 参数是 VARIANT 类型的日期时间值，lpSystemTime 参数是指向 SYSTEMTIME 结构体类型的指针，用于返回转换后的日期时间值。

函数返回值为 BOOL 类型，表示转换操作是否成功。如果转换成功，则返回 TRUE；否则返回 FALSE。

相关问题

VariantTimeToSystemTime 示例

下面是一个 VariantTimeToSystemTime 的示例代码：

#include <windows.h>
#include <iostream>

int main()
{
    // 将日期转换为VARIANT类型
    COleDateTime oleDateTime(2022, 1, 1, 0, 0, 0);
    VARIANT vtDate;
    VariantInit(&vtDate);
    V_VT(&vtDate) = VT_DATE;
    V_DATE(&vtDate) = oleDateTime;

    // 将VARIANT类型转换为SYSTEMTIME类型
    SYSTEMTIME sysTime;
    if (!VariantTimeToSystemTime(V_DATE(&vtDate), &sysTime))
    {
        std::cout << "VariantTimeToSystemTime failed." << std::endl;
        return 1;
    }

    // 输出转换后的日期
    std::cout << "Year: " << sysTime.wYear << std::endl;
    std::cout << "Month: " << sysTime.wMonth << std::endl;
    std::cout << "Day: " << sysTime.wDay << std::endl;

    return 0;
}

此代码将2022年1月1日转换为 VARIANT 类型，然后将其转换为 SYSTEMTIME 类型，并输出转换后的日期。

VariantTimeToSystemTime 实现源码

VariantTimeToSystemTime 函数是将 Variant 时间值转换为系统时间值的函数。以下是该函数的实现源码：

BOOL VariantTimeToSystemTime(DATE dt, LPSYSTEMTIME lpSystemTime)
{
    if (lpSystemTime == NULL)
        return FALSE;

    // 日期的整数部分是自 1899 年 12 月 30 日以来的天数
    double dTemp = dt + HALF_SECOND / SECONDS_PER_DAY;

    // 这个数字表示了 1900 年 1 月 1 日的日期
    // 也就是说，它是 dTemp 中减去 2 的结果
    int nDays = (int)dTemp;

    // 将时间部分转换为 SYSTEMTIME 结构
    double dblSecsInDay = dTemp - (double)nDays;
    int nSeconds = (int)(dblSecsInDay * SECONDS_PER_DAY);

    lpSystemTime->wHour = nSeconds / SECONDS_PER_HOUR;
    nSeconds -= lpSystemTime->wHour * SECONDS_PER_HOUR;
    lpSystemTime->wMinute = nSeconds / SECONDS_PER_MINUTE;
    nSeconds -= lpSystemTime->wMinute * SECONDS_PER_MINUTE;
    lpSystemTime->wSecond = nSeconds;
    lpSystemTime->wMilliseconds = (WORD)((dblSecsInDay - (double)nSeconds) * 1000.0);

    // 将日期部分转换为 SYSTEMTIME 结构
    // 闰年必须是 4 的倍数，但世纪闰年必须是 400 的倍数
    int nLeapYears = (nDays - DAYS_FROM_BASELINE_TO_1900) / 1461;
    int nYear = 1900 + nLeapYears * 4;
    int nDaysInLeapYear = (nDays - DAYS_FROM_BASELINE_TO_1900) % 1461;
    for (;;)
    {
        int nDaysInYear = DaysInYear(nYear);
        if (nDaysInLeapYear < nDaysInYear)
            break;
        nYear++;
        nDaysInLeapYear -= nDaysInYear;
    }

    lpSystemTime->wYear = (WORD)nYear;
    lpSystemTime->wMonth = 1;

    int nMonth;
    for (nMonth = 1; nMonth <= 12; nMonth++)
    {
        int nDaysInMonth = DaysInMonth(nMonth, IsLeapYear(nYear));
        if (nDaysInLeapYear < nDaysInMonth)
            break;
        nDaysInLeapYear -= nDaysInMonth;
        lpSystemTime->wMonth++;
    }

    lpSystemTime->wDay = (WORD)(nDaysInLeapYear + 1);
    lpSystemTime->wDayOfWeek = (WORD)((nDays + 1) % 7);

    return TRUE;
}

这段代码中包含了一些常量和辅助函数，它们的定义如下：

#define DAYS_FROM_BASELINE_TO_1900  693593
#define SECONDS_PER_DAY             86400
#define SECONDS_PER_HOUR            3600
#define SECONDS_PER_MINUTE          60
#define HALF_SECOND                 (1.0 / (2.0 * SECONDS_PER_DAY))

inline BOOL IsLeapYear(int nYear)
{
    return ((nYear & 3) == 0) && ((nYear % 100) != 0 || (nYear % 400) == 0);
}

inline int DaysInMonth(int nMonth, BOOL bLeapYear)
{
    static int nDaysInMonth[] =
    {
        31, 28, 31, 30, 31, 30,
        31, 31, 30, 31, 30, 31
    };
    return (nMonth == 2 && bLeapYear) ? 29 : nDaysInMonth[nMonth - 1];
}

inline int DaysInYear(int nYear)
{
    return IsLeapYear(nYear) ? 366 : 365;
}