TryStrToDate - C++ Builder

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

---

字符串转日期类型数值

头文件：#include
命名空间：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