StrToDateTimeDef - C++ Builder

2022-04-24 本文已影响0人玄坴

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

字符串转日期时间类型数值

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

System::TDateTime __fastcall StrToDateTimeDef(
    const System::UnicodeString S,
    const System::TDateTime Default);

System::TDateTime __fastcall StrToDateTimeDef(
    const System::UnicodeString S,
    const System::TDateTime Default,
    const TFormatSettings &AFormatSettings);

参数：

S：字符串，日期和时间；
Default：默认值；
AFormatSettings：地区格式；

返回值：

日期时间类型数值，如果转换失败，函数返回参数 Default 值；
字符串 S 包含日期和时间，
如果不包含时间，认为是 00:00:00；
如果不包含日期，认为是 1899年12月30日，因为日期是用从这一天开始的天数表示的；
如果没有 AFormatSettings 参数，日期格式必须和全局变量 FormatSettings.ShortDateFormat 相同，
日期分隔符必须是 FormatSettings.DateSeparator，
时间可以是12小时或24小时，
时间分隔符必须是 FormatSettings.TimeSeparator，
秒和毫秒之间的小数点必须使用 FormatSettings.DecimalSeparator，
注意这个小数点同时应用在浮点数和货币类型的小数点显示和类型转换，
上午可以用 "AM" 也可以用 FormatSettings.TimeAMString (在中国为 "上午")，
下午可以用 "PM" 也可以用 FormatSettings.TimePMString (在中国为 "下午")，
如果 FormatSettings 被修改，可以用 Sysutils::GetFormatSettings(); 恢复默认值为本地格式，
请参考本文例子及 StrToTime 的例子；
如果有 AFormatSettings 参数，日期格式必须和参数 AFormatSettings.ShortDateFormat 相同，
日期分隔符必须是 AFormatSettings.DateSeparator，
时间可以是12小时或24小时，
时间分隔符必须是 AFormatSettings.TimeSeparator，
秒和毫秒之间的小数点必须使用 AFormatSettings.DecimalSeparator
上午可以用 "AM" 也可以用 AFormatSettings.TimeAMString (在中国为 "上午")，
下午可以用 "PM" 也可以用 AFormatSettings.TimePMString (在中国为 "下午")，
请参考本文例子及 StrToTime 的例子；
日期时间格式可以参考 System::Sysutils::FormatDateTime；
函数 StrToDateTime、StrToDateTimeDef 和 TryStrToDateTime 的区别：
• StrToDateTime 转换失败抛出异常；
• StrToDateTimeDef 转换失败返回默认值；
• TryStrToDateTime 转换结果通过参数返回，函数返回值返回是否转换成功；
没有 AFormatSettings 参数的 CurrToStrF 函数不是线程安全的，因为使用了全局变量 FormatSettings 作为默认的地区格式；带有 AFormatSettings 参数的函数是线程安全的。

例：请参考 StrToDateTime、StrToDate 和 StrToDateDef 的例子。

StrToDateTimeDef - C++ Builder

猜你喜欢

热点阅读