EndOfADay - C++ Builder

2022-07-31 本文已影响0人玄坴

C++ Builder 参考手册 ➙ System::Dateutils ➙ EndOfADay

某一年的某一天的结束时间，
这一年的第几天的结束时间 (23:59:59.999)，
这个年、月、日的结束时间 (23:59:59.999)

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

System::TDateTime __fastcall EndOfADay(
    const System::Word AYear,
    const System::Word ADayOfYear);

System::TDateTime __fastcall EndOfADay(
    const System::Word AYear,
    const System::Word AMonth,
    const System::Word ADay);

参数：

AYear：年，1 - 9999；
AMonth：月，1 - 12；
ADay：日，1 - 31；
ADayOfYear：这一年的几天，1 - 366；

返回值：

AYear 年的第 ADayOfYear 天的结束时间 (23:59:59.999) 或
AYear 年 AMonth 月 ADay 日的结束时间 (23:59:59.999)；
可以使用 DayOfTheYear 获取一个日期时间是这一年的第几天；
使用 StartOfADay 和 EndOfADay 获取这一年的第几天的日期和时间；
EndOfTheDay 和 EndOfADay 的区别：
• EndOfTheDay 的参数是一个日期时间；
• EndOfADay 的参数是年、月、日或年和这一年的第几天；
如果日期相同，这两个函数的返回值相同；
程序里面通常判断小于下一天的开始时间，而不是判断小于等于这一天的结束时间。

例：

#include <System.DateUtils.hpp>
void __fastcall TForm1::Button1Click(TObject *Sender)
{
    TDateTime dt = Sysutils::Now();
    Memo1->Lines->Add(L"现在时间 " + FormatDateTime(L"yyyy/mm/dd hh:nn:ss.zzz", dt));
    Memo1->Lines->Add(L"今天开始 " + FormatDateTime(L"yyyy/mm/dd hh:nn:ss.zzz", StartOfTheDay(dt)));
    Memo1->Lines->Add(L"今天结束 " + FormatDateTime(L"yyyy/mm/dd hh:nn:ss.zzz", EndOfTheDay(dt)));

    unsigned short iYear = Dateutils::YearOf(dt);
    unsigned short iDoY = Dateutils::DayOfTheYear(dt);

    Memo1->Lines->Add(String().sprintf(L"今天是 %d年 的 第%d天", iYear, iDoY));
    Memo1->Lines->Add(L"今天开始 " + FormatDateTime(L"yyyy/mm/dd hh:nn:ss.zzz", StartOfADay(iYear, iDoY)));
    Memo1->Lines->Add(L"今天结束 " + FormatDateTime(L"yyyy/mm/dd hh:nn:ss.zzz", EndOfADay(iYear, iDoY)));

    unsigned short iMonth = Dateutils::MonthOf(dt);
    unsigned short iDay = Dateutils::DayOf(dt);

    Memo1->Lines->Add(String().sprintf(L"今天是 %d年%d月%d日", iYear, iMonth, iDay));
    Memo1->Lines->Add(L"今天开始 " + FormatDateTime(L"yyyy/mm/dd hh:nn:ss.zzz", StartOfADay(iYear, iMonth, iDay)));
    Memo1->Lines->Add(L"今天结束 " + FormatDateTime(L"yyyy/mm/dd hh:nn:ss.zzz", EndOfADay(iYear, iMonth, iDay)));
}

运行结果：

EndOfADay - C++ Builder

猜你喜欢

热点阅读