TryEncodeTime - C++ Builder

2022-05-19 本文已影响0人玄坴

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。

TryEncodeTime - C++ Builder

猜你喜欢

热点阅读