TimeToStr - C++ Builder

2022-05-15 本文已影响0人玄坴

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

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

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

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

参数：

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

返回值：

参数 DateTime 转为字符串；
没有 AFormatSettings 参数的函数使用全局变量 System::Sysutils::FormatSettings 的格式，函数使用全局变量 FormatSettings 或参数 AFormatSettings 的 LongTimeFormat 成员作为转换的格式，格式的详细说明请参考 FormatDateTime；
没有 AFormatSettings 参数的函数不是线程安全的，因为使用了全局变量作为默认的地区格式；带有 AFormatSettings 参数的函数是线程安全的。

例：测试全局变量 FormatSettings 和参数 AFormatSettings 对转换结果的影响

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    System::TDateTime dt = Sysutils::Now(); // 当前系统时间
    Memo1->Lines->Add(Sysutils::TimeToStr(dt)); // 默认的，使用全局变量格式

    TFormatSettings fs = TFormatSettings::Create(L"en_US"); // 美国
    Memo1->Lines->Add(Sysutils::TimeToStr(dt,fs)); // 使用美国格式

    FormatSettings.LongTimeFormat = L"hh:nn:ss.zzz"; // 修改全局变量格式
    Memo1->Lines->Add(Sysutils::TimeToStr(dt)); // 使用全局变量格式

    Sysutils::GetFormatSettings(); // 全局变量格式恢复默认为本地格式
    Memo1->Lines->Add(Sysutils::TimeToStr(dt)); // 使用全局变量格式
}

运行结果：

运行结果

TimeToStr - C++ Builder

猜你喜欢

热点阅读