C++ Builder 參考手冊(cè) ? System::Sysutils ? StrToDate
字符串轉(zhuǎn)日期類型數(shù)值
頭文件：#include <System.SysUtils.hpp>
命名空間：System::Sysutils
函數(shù)原型：
System::TDateTime __fastcall StrToDate(const System::UnicodeString S);
System::TDateTime __fastcall StrToDate(const System::UnicodeString S, const TFormatSettings &AFormatSettings);
參數(shù)：
- S：字符串构罗；
- AFormatSettings：地區(qū)格式肴茄；
返回值：
- 日期時(shí)間類型數(shù)值烘跺，如果轉(zhuǎn)換失敗哪审，拋出 EConvertError 異常；
- 字符串 S 必須是日期数尿，不能包含時(shí)間被冒；
- 如果沒有 AFormatSettings 參數(shù)，日期格式必須和全局變量 FormatSettings.ShortDateFormat 相同蠕搜，分隔符必須是 FormatSettings.DateSeparator怎茫，請(qǐng)參考本文例子；
如果有 AFormatSettings 參數(shù)妓灌，日期格式必須和參數(shù) AFormatSettings.ShortDateFormat 相同轨蛤，分隔符必須是 AFormatSettings.DateSeparator，請(qǐng)參考本文例子虫埂； - 日期時(shí)間格式可以參考 System::Sysutils::FormatDateTime祥山；
- 函數(shù) StrToDate、StrToDateDef 和 TryStrToDate 的區(qū)別：
? StrToDate 轉(zhuǎn)換失敗拋出異常掉伏；
? StrToDateDef 轉(zhuǎn)換失敗返回默認(rèn)值缝呕；
? TryStrToDate 轉(zhuǎn)換結(jié)果通過參數(shù)返回，函數(shù)返回值返回是否轉(zhuǎn)換成功斧散； - 沒有 AFormatSettings 參數(shù)的 CurrToStrF 函數(shù)不是線程安全的供常，因?yàn)槭褂昧巳肿兞?FormatSettings 作為默認(rèn)的地區(qū)格式；帶有 AFormatSettings 參數(shù)的函數(shù)是線程安全的鸡捐。
例：
void __fastcall TForm1::Button1Click(TObject *Sender)
{
ShowDate(StrToDate(L"2022/04/21")); // 中國默認(rèn)日期格式為 年/月/日
TFormatSettings fs = TFormatSettings::Create(L"en_US"); // 美國
ShowDate(StrToDate(L"4/21/2022", fs)); // 美國默認(rèn)日期格式為 日/月/年
Sysutils::FormatSettings.DateSeparator = L'-'; // 把默認(rèn)的日期分隔符改為減號(hào) '-'
ShowDate(StrToDate(L"2022-04-21")); // 默認(rèn)的日期格式就變成了 年-月-日
Sysutils::FormatSettings.ShortDateFormat = L"mm/dd/yyyy"; // 繼續(xù)修改默認(rèn)日期格式為 日/月/年
ShowDate(StrToDate(L"04-21-2022")); // 這時(shí)之前修改的日期分隔符仍然有效栈暇，為減號(hào) '-'
}
運(yùn)行結(jié)果：
運(yùn)行結(jié)果
相關(guān)：
- System::Sysutils::DateTimeToStr
- System::Sysutils::DateTimeToString
- System::Sysutils::DateToStr
- System::Sysutils::FormatDateTime
- 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::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
- std::atof, std::_ttof, std::_wtof
- std::_atold, std::_ttold, std::_wtold
- std::atoi, std::_ttoi, std::_wtoi
- std::atol, std::_ttol, std::_wtol
- std::atoll, std::_ttoll, std::_wtoll
- std::_atoi64, std::_ttoi64, std::_wtoi64
- std::strtof, std::_tcstof, std::wcstof
- std::strtod, std::_tcstod, std::wcstod
- std::strtold, std::wcstold, std::_strtold, std::_tcstold, std::_wcstold
- std::strtol, std::_tcstol, std::wcstol
- std::strtoll, std::_tcstoll, std::wcstoll
- std::strtoul, std::_tcstoul, std::wcstoul
- std::strtoull, std::_tcstoull, std::wcstoull
- <cstdlib>
C++ Builder 參考手冊(cè) ? System::Sysutils ? StrToDate
