DateTimeToString - C++ Builder

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

日期时间类型数值转字符串

头文件：#include <System.SysUtils.hpp>
命名空间：System::Sysutils
函数原型：

void __fastcall DateTimeToString(System::UnicodeString &Result, const System::UnicodeString Format, System::TDateTime DateTime);
void __fastcall DateTimeToString(System::UnicodeString &Result, const System::UnicodeString Format, System::TDateTime DateTime, const TFormatSettings &AFormatSettings);

参数：

• Result：日期时间转字符串的结果通过这个参数返回；
• Format：日期和时间的格式：请参考 FormatDateTime；
• DateTime：日期时间类型变量；
• AFormatSettings：地区格式；

返回值：

• 无，转换结果通过参数 Result 返回；
• 参数 DateTime 转为字符串，使用 Format 参数的日期和时间的格式；
• 如果没有 AFormatSettings 参数，函数内部使用全局变量 System::Sysutils::FormatSettings 作为这个参数，所以没有 AFormatSettings 参数的版本不是线程安全的，有 AFormatSettings 参数的版本不使用全局变量，所以是线程安全的；
• 可以使用全局变量 System::Sysutils::FormatSettings 修改默认的格式；
• FormatDateTime 函数内部调用的就是这个函数，他们执行的结果是相同的，区别是 FormatDateTime 生成的字符串作为函数的返回值，而不是通过 Result 参数返回。

例：

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    UnicodeString s;
    System::TDateTime dt = Sysutils::Now();

    Sysutils::DateTimeToString(s, L"yyyy/mm/dd", dt);
    Memo1->Lines->Add(s);

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

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

运行结果：

相关：

• System::Sysutils::FormatDateTime
• System::Sysutils::DateTimeToString
• System::Sysutils::DateTimeToStr
• 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::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 ➙ DateTimeToString