TryStrToDate - C++ Builder
2022-05-24 本文已影响0人
玄坴
C++ Builder 参考手册 ➙ System::Sysutils ➙ TryStrToDate
字符串转日期类型数值
头文件:#include <System.SysUtils.hpp>
命名空间:System::Sysutils
函数原型:
bool __fastcall TryStrToDate(
const System::UnicodeString S,
System::TDateTime &Value);
bool __fastcall TryStrToDate(
const System::UnicodeString S,
System::TDateTime &Value,
const TFormatSettings &AFormatSettings);
参数:
- S:字符串;
- Value:返回日期类型数值转换结果;
- AFormatSettings:地区格式;
返回值:
- true:通过参数 Value 返回日期时间类型数值,
- false:转换失败;
- 字符串 S 必须是日期,不能包含时间;
- 如果没有 AFormatSettings 参数,日期格式必须和全局变量 FormatSettings.ShortDateFormat 相同,分隔符必须是 FormatSettings.DateSeparator,请参考本文例子;
如果有 AFormatSettings 参数,日期格式必须和参数 AFormatSettings.ShortDateFormat 相同,分隔符必须是 AFormatSettings.DateSeparator,请参考 StrToDate 的例子; - 日期时间格式可以参考 System::Sysutils::FormatDateTime;
- 函数 StrToDate、StrToDateDef 和 TryStrToDate 的区别:
• StrToDate 转换失败抛出 EConvertError 异常;
• StrToDateDef 转换失败返回默认值;
• TryStrToDate 转换结果通过参数返回,函数返回值返回是否转换成功; - 没有 AFormatSettings 参数的函数不是线程安全的,因为使用了全局变量 FormatSettings 作为默认的地区格式;带有 AFormatSettings 参数的函数是线程安全的。
相关:
- System::Sysutils::DateTimeToStr
- System::Sysutils::DateTimeToString
- System::Sysutils::DateToStr
- System::Sysutils::FormatDateTime
- System::Sysutils::FormatSettings
- System::Sysutils::GetFormatSettings
- System::Sysutils::StrToBool
- System::Sysutils::StrToBoolDef
- System::Sysutils::StrToCurr
- System::Sysutils::StrToCurrDef
- System::Sysutils::StrToDate
- System::Sysutils::StrToDateDef
- System::Sysutils::StrToDateTime
- System::Sysutils::StrToDateTimeDef
- System::Sysutils::StrToFloat
- System::Sysutils::StrToFloatDef
- System::Sysutils::StrToInt
- System::Sysutils::StrToIntDef
- System::Sysutils::StrToInt64
- System::Sysutils::StrToInt64Def
- System::Sysutils::StrToTime
- System::Sysutils::StrToTimeDef
- System::Sysutils::StrToUInt
- System::Sysutils::StrToUIntDef
- System::Sysutils::StrToUInt64
- System::Sysutils::StrToUInt64Def
- System::Sysutils::TFormatSettings
- System::Sysutils::TimeToStr
- System::Sysutils::TryStrToBool
- System::Sysutils::TryStrToCurr
- System::Sysutils::TryStrToDate
- System::Sysutils::TryStrToDateTime
- System::Sysutils::TryStrToFloat
- System::Sysutils::TryStrToInt
- System::Sysutils::TryStrToInt64
- System::Sysutils::TryStrToTime
- System::Sysutils::TryStrToUInt
- System::Sysutils::TryStrToUInt64
- System::Sysutils
- System::TDateTime
- System
C++ Builder 参考手册 ➙ System::Sysutils ➙ TryStrToDate