DateToStr - C++ Builder

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

---

日期类型数值转字符串

头文件：#include
命名空间：System::Sysutils
函数原型：

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

参数：

• DateTime：日期时间类型变量；
• AFormatSettings：地区格式；

返回值：

• 参数 DateTime 里面的日期转为字符串，忽略时间；
• 只有一个 DateTime 参数的函数使用全局变量 System::Sysutils::FormatSettings 指定的格式；
• 只有一个 DateTime 参数的 DateTimeToStr 函数不是线程安全的，因为使用了全局变量作为默认的地区格式；带有 AFormatSettings 参数的函数是线程安全的；
• 日期时间格式可以参考 System::Sysutils::FormatDateTime。

---

例：

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    System::TDateTime dt = Sysutils::Now();
    Memo1->Lines->Add(Sysutils::DateToStr(dt));
    Sysutils::FormatSettings.DateSeparator = L'-';
    Memo1->Lines->Add(Sysutils::DateToStr(dt));

    Memo1->Lines->Add(Sysutils::DateToStr(dt,TFormatSettings::Create(L"en_US")));

    TFormatSettings fs = TFormatSettings::Create();
    fs.ShortDateFormat = L"yyyy'年'm'月'd'日'";
    Memo1->Lines->Add(Sysutils::DateToStr(dt, fs));
}

运行结果：

运行结果

---

相关：

• System::Sysutils::FormatDateTime
• System::Sysutils::FormatSettings
• System::Sysutils::TFormatSettings
• System::Sysutils::DateTimeToStr
• System::Sysutils::DateTimeToString
• System::Sysutils::DateToStr
• System::Sysutils::StrToBool
• System::Sysutils::StrToBoolDef
• System::Sysutils::TryStrToBool
• System::Sysutils::BoolToStr
• System::Sysutils::CurrToStr
• System::Sysutils::CurrToStrF
• System::Sysutils::FloatToStr
• System::Sysutils::FloatToStrF
• System::Sysutils::GUIDToString
• System::Sysutils::IntToStr
• System::Sysutils::IntToHex
• System::Sysutils::TimeToStr
• System::Sysutils::UIntToStr
• System::Sysutils
• System::Currency
• System

---

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