C++ Builder 參考手冊(cè) ? System::Sysutils ? EncodeTime

由時(shí)、分、秒、毫秒生成日期時(shí)間型數(shù)值

頭文件：#include <System.SysUtils.hpp>
命名空間：System::Sysutils
函數(shù)原型：

System::TDateTime __fastcall EncodeTime(System::Word Hour, System::Word Min, System::Word Sec, System::Word MSec);

參數(shù)：

• Hour：時(shí)，0~23
• Min：分，0~59
• Sec：秒，0~59
• MSec：毫秒，0~999

返回值：

• 日期時(shí)間類型數(shù)值，日期部分為 0，時(shí)間為參數(shù)指定的時(shí)、分、秒、毫秒；
• 如果參數(shù)指定的時(shí)、分、秒、毫秒無(wú)效，拋出 EConvertError 異常；
• 轉(zhuǎn)換結(jié)果在數(shù)值上，為一個(gè)雙精度浮點(diǎn)數(shù)值，等于 1 為一天 (24 小時(shí)整)，0.5 為 12 小時(shí)，所以轉(zhuǎn)換結(jié)果大于等于0，并且小于1；
• 如果日期時(shí)間類型變量不包含日期，即日期為 0，如果輸出日期，認(rèn)為是 1899年12月30日，因?yàn)槿掌跁r(shí)間類型變量數(shù)值是從 1899/12/30 00:00:00.000 開始到這個(gè)時(shí)刻的天數(shù)，如果看到 C++ Builder 程序輸出了這個(gè)日期，說(shuō)明是輸出了等于 0 的日期引起的。

例：23時(shí) 59分 59秒 999毫秒：轉(zhuǎn)換為日期時(shí)間成功，1時(shí) 0分 60秒 0毫秒：轉(zhuǎn)換為日期時(shí)間失?。?/p>

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    try
    {
        TDateTime dt = Sysutils::EncodeTime(23, 59, 59, 999);
        Memo1->Lines->Add(FormatDateTime(L"hh:nn:ss.zzz", dt));
    }
    catch(Exception &e)
    {
        ShowMessage(L"轉(zhuǎn)換出錯(cuò)：" + e.Message);
    }
}
//---------------------------------------------------------------------------
void __fastcall TForm1::Button2Click(TObject *Sender)
{
    try
    {
        TDateTime dt = Sysutils::EncodeTime(1, 0, 60, 0);
        Memo1->Lines->Add(FormatDateTime(L"yyyy/mm/dd", dt));
    }
    catch(Exception &e)
    {
        ShowMessage(L"轉(zhuǎn)換出錯(cuò)：" + e.Message);
    }
}

運(yùn)行結(jié)果：

點(diǎn)擊 Button1 運(yùn)行結(jié)果

點(diǎn)擊 Button2 運(yùn)行結(jié)果

相關(guān)：

• System::Dateutils::DecodeDateTime
• System::Dateutils::EncodeDateTime
• System::Dateutils::TryEncodeDateTime
• System::Dateutils::DateTimeToUnix
• System::Dateutils::UnixToDateTime
• System::Dateutils::YearOf
• System::Dateutils::MonthOf
• System::Dateutils::DayOf
• System::Dateutils::DayOfTheWeek
• System::Dateutils::DayOfTheMonth
• System::Dateutils::DayOfTheYear
• System::Dateutils::HourOf
• System::Dateutils::MinuteOf
• System::Dateutils::SecondOf
• System::Dateutils::MilliSecondOf
• System::Dateutils
• System::Sysutils::DecodeDate
• System::Sysutils::DecodeDateFully
• System::Sysutils::DecodeTime
• System::Sysutils::EncodeDate
• System::Sysutils::EncodeTime
• System::Sysutils::TryEncodeDate
• System::Sysutils::TryEncodeTime
• System::Sysutils::TryStrToDate
• System::Sysutils::TryStrToDateTime
• System::Sysutils::TryStrToTime
• System::Sysutils::FormatDateTime
• System::Sysutils::CurrentYear
• System::Sysutils::Now
• System::Sysutils::Date
• System::Sysutils::Time
• System::Sysutils

C++ Builder 參考手冊(cè) ? System::Sysutils ? EncodeTime