C++ Builder 參考手冊(cè) ? System::Sysutils ? StrToDateDef
字符串轉(zhuǎn)日期類型數(shù)值
頭文件：#include <System.SysUtils.hpp>
命名空間：System::Sysutils
函數(shù)原型：
System::TDateTime __fastcall StrToDateDef(
const System::UnicodeString S,
const System::TDateTime Default);
System::TDateTime __fastcall StrToDateDef(
const System::UnicodeString S,
const System::TDateTime Default,
const TFormatSettings &AFormatSettings);
參數(shù)：
- S：字符串及志；
- Default：默認(rèn)值；
- AFormatSettings：地區(qū)格式箩溃；
返回值：
- 日期時(shí)間類型數(shù)值，如果轉(zhuǎn)換失敗颜骤，函數(shù)返回參數(shù) Default 值阁苞；
- 字符串 S 必須是日期妒挎，不能包含時(shí)間；
- 如果沒(méi)有 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é)果通過(guò)參數(shù)返回，函數(shù)返回值返回是否轉(zhuǎn)換成功琴许； - 沒(méi)有 AFormatSettings 參數(shù)的 CurrToStrF 函數(shù)不是線程安全的税肪，因?yàn)槭褂昧巳肿兞?FormatSettings 作為默認(rèn)的地區(qū)格式；帶有 AFormatSettings 參數(shù)的函數(shù)是線程安全的榜田。
例：
測(cè)試默認(rèn)日期格式和通過(guò) Sysutils::FormatSettings 修改默認(rèn)日期格式益兄，
通過(guò) Sysutils::GetFormatSettings 恢復(fù)默認(rèn)格式。
通過(guò)函數(shù)參數(shù) AFormatSettings 指定格式請(qǐng)參考 StrToDate 的例子箭券。
void TForm1::ShowDate(TDateTime dt)
{
Memo1->Lines->Add(FormatDateTime(L"yyyy'年'm'月'd'日'", dt)); // 顯示日期
}
//---------------------------------------------------------------------------
void __fastcall TForm1::Button1Click(TObject *Sender)
{
TDateTime dtDefault = Sysutils::Now(); // 默認(rèn)值為當(dāng)前日期
ShowDate(StrToDateDef(L"2022/03/31", dtDefault)); // 中國(guó)默認(rèn)日期格式為 年/月/日
ShowDate(StrToDateDef(L"2022-03-31", dtDefault)); // 轉(zhuǎn)換失敗净捅，返回默認(rèn)值
ShowDate(StrToDateDef(L"03-31-2022", dtDefault)); // 轉(zhuǎn)換失敗，返回默認(rèn)值
ShowDate(StrToDateDef(L"03/31/2022", dtDefault)); // 轉(zhuǎn)換失敗辩块，返回默認(rèn)值
Memo1->Lines->Add(L"-");
Sysutils::FormatSettings.DateSeparator = L'-'; // 把默認(rèn)的日期分隔符改為減號(hào) '-'
Sysutils::FormatSettings.ShortDateFormat = L"yyyy/mm/dd"; // 繼續(xù)修改默認(rèn)日期格式為 年/日/月
ShowDate(StrToDateDef(L"2022/03/31", dtDefault)); // 轉(zhuǎn)換失敗灸叼，返回默認(rèn)值
ShowDate(StrToDateDef(L"2022-03-31", dtDefault)); // 符合修改之后的格式，轉(zhuǎn)換成功
ShowDate(StrToDateDef(L"03-31-2022", dtDefault)); // 轉(zhuǎn)換失敗庆捺，返回默認(rèn)值
ShowDate(StrToDateDef(L"03/31/2022", dtDefault)); // 轉(zhuǎn)換失敗，返回默認(rèn)值
Memo1->Lines->Add(L"-");
Sysutils::FormatSettings.ShortDateFormat = L"mm/dd/yyyy"; // 繼續(xù)修改默認(rèn)日期格式為 日/月/年
ShowDate(StrToDateDef(L"2022/03/31", dtDefault)); // 轉(zhuǎn)換失敗屁魏，返回默認(rèn)值
ShowDate(StrToDateDef(L"2022-03-31", dtDefault)); // 轉(zhuǎn)換失敗滔以，返回默認(rèn)值
ShowDate(StrToDateDef(L"03-31-2022", dtDefault)); // 符合修改之后的格式，轉(zhuǎn)換成功
ShowDate(StrToDateDef(L"03/31/2022", dtDefault)); // 轉(zhuǎn)換失敗氓拼，返回默認(rèn)值
Memo1->Lines->Add(L"-");
Sysutils::GetFormatSettings(); // 格式恢復(fù)默認(rèn)值 - 當(dāng)前地區(qū) (中國(guó)) 的格式
ShowDate(StrToDateDef(L"2022/03/31", dtDefault)); // 中國(guó)默認(rèn)日期格式為 年/月/日
ShowDate(StrToDateDef(L"2022-03-31", dtDefault)); // 轉(zhuǎn)換失敗你画，返回默認(rèn)值
ShowDate(StrToDateDef(L"03-31-2022", dtDefault)); // 轉(zhuǎn)換失敗，返回默認(rèn)值
ShowDate(StrToDateDef(L"03/31/2022", dtDefault)); // 轉(zhuǎn)換失敗桃漾，返回默認(rèn)值
}
運(yùn)行結(jié)果：
剪貼簿01.png
相關(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 ? StrToDateDef
