C++ Builder 參考手冊 ? System::Sysutils ? FormatDateTime

日期時間類型數(shù)值轉(zhuǎn)字符串

頭文件：#include <System.SysUtils.hpp>
命名空間：System::Sysutils
函數(shù)原型：

System::UnicodeString __fastcall FormatDateTime(const System::UnicodeString Format, System::TDateTime DateTime);
System::UnicodeString __fastcall FormatDateTime(const System::UnicodeString Format, System::TDateTime DateTime, const TFormatSettings &AFormatSettings);

參數(shù)：

• Format：日期和時間的格式；
• DateTime：日期時間類型變量；
• AFormatSettings：地區(qū)格式；

返回值：

• 日期時間轉(zhuǎn)字符串的結(jié)果通過這個參數(shù)返回；
• 參數(shù) DateTime 轉(zhuǎn)為字符串，使用 Format 參數(shù)的日期和時間的格式；
• 如果沒有 AFormatSettings 參數(shù)，函數(shù)內(nèi)部使用全局變量 System::Sysutils::FormatSettings 作為這個參數(shù)，所以沒有 AFormatSettings 參數(shù)的版本不是線程安全的，有 AFormatSettings 參數(shù)的版本不使用全局變量，所以是線程安全的；
• 可以使用全局變量 System::Sysutils::FormatSettings 修改默認的格式；
• FormatDateTime 函數(shù)通過調(diào)用 DateTimeToString 函數(shù)實現(xiàn)，他們執(zhí)行的結(jié)果是相同的，區(qū)別是 FormatDateTime 生成的字符串作為函數(shù)的返回值，而 DateTimeToString 是通過 Result 參數(shù)返回的。

Format 參數(shù)的格式：

例：

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    System::TDateTime dt = Sysutils::Now();
    Memo1->Lines->Add(Sysutils::FormatDateTime(L"yyyy/mm/dd", dt));

    TFormatSettings fs = TFormatSettings::Create();
    fs.DateSeparator = L'-';
    Memo1->Lines->Add(Sysutils::FormatDateTime(L"yyyy/mm/dd", dt, fs));

    Memo1->Lines->Add(Sysutils::FormatDateTime(L"yyyy'年'mm'月'dd'日' hh:nn:ss.zzz", dt));
}

運行結(jié)果：

運行結(jié)果

相關(guān)：

• System::Sysutils::FormatSettings
• System::Sysutils::TFormatSettings
• System::Sysutils::StrToBool
• System::Sysutils::StrToBoolDef
• System::Sysutils::TryStrToBool
• System::Sysutils::BoolToStr
• System::Sysutils::CurrToStr
• System::Sysutils::CurrToStrF
• System::Sysutils::DateTimeToStr
• System::Sysutils::DateTimeToString
• System::Sysutils::DateToStr
• System::Sysutils::FloatToStr
• System::Sysutils::FloatToStrF
• System::Sysutils::GUIDToString
• System::Sysutils::IntToStr
• System::Sysutils::IntToHex
• System::Sysutils::TimeToStr
• System::Sysutils::UIntToStr
• System::Sysutils
• System::Dateutils
• System
• std::itoa, std::_itoa, std::_itot, std::_itow
• std::ltoa, std::_ltoa, std::_ltot, std::_ltow
• std::ultoa, std::_ultoa, std::_ultot, std::_ultow
• std::_i64toa, std::_i64tot, std::_i64tow
• std::_ui64toa, std::_ui64tot, std::_ui64tow
• std::ecvt, std::_ecvt
• std::fcvt, std::_fcvt
• std::gcvt, std::_gcvt
• <cstdlib>

C++ Builder 參考手冊 ? System::Sysutils ? FormatDateTime