TryEncodeTime - C++ Builder

C++ Builder 参考手册 ➙ System::Sysutils ➙ TryEncodeTime

由时、分、秒、毫秒生成日期时间型数值

头文件：#include <System.SysUtils.hpp>
命名空间：System::Sysutils
函数原型：

bool __fastcall TryEncodeTime(
    System::Word Hour,
    System::Word Min,
    System::Word Sec,
    System::Word MSec,
    System::TDateTime &Time);

参数：

• Hour：时，0~23
• Min：分，0~59
• Sec：秒，0~59
• MSec：毫秒，0~999
• Time：返回生成的时间；

返回值：

• true：参数 Time 返回生成的日期时间类型数值，日期部分为 0，时间为参数指定的时、分、秒、毫秒；
• false：参数 (时、分、秒、毫秒) 无效，无法生成时间；
• 转换结果在数值上，为一个双精度浮点数值，等于 1 为一天 (24 小时整)，0.5 为 12 小时，所以转换结果大于等于0，并且小于1；
• 如果日期时间类型变量不包含日期，即日期为 0，如果输出日期，认为是 1899年12月30日，因为日期时间类型变量数值是从 1899/12/30 00:00:00.000 开始到这个时刻的天数，如果看到 C++ Builder 程序输出了这个日期，说明是输出了等于 0 的日期引起的。
• 函数 EncodeTime 和 TryEncodeTime 的区别：
  • EncodeTime：函数返回生成的时间，如果参数指定的时、分、秒、毫秒无效，抛出 EConvertError 异常；
  • TryEncodeTime：生成的时间通过参数返回，如果参数指定的时、分、秒、毫秒无效，函数返回 false。

相关：

• 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
• 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

C++ Builder 参考手册 ➙ System::Sysutils ➙ TryEncodeTime