System::Dateutils - C++ Builder

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

---

System::Dateutils 里面都是日期和时间处理相关的内容，包括：

• System::Dateutils 类
• System::Dateutils 类型
• System::Dateutils 常数
• System::Dateutils 变量
• System::Dateutils 函数

---

一. System::Dateutils 类

类	说明
EDateTimeException	日期时间处理异常：无效的日期时间
ELocalTimeInvalid	TTimeZone 异常：无效的本地时间
TTimeZone	时区处理类

二. System::Dateutils 类型

类型	说明
TLocalTimeType	本地时间类型 (是否使用夏令时等)

三. System::Dateutils 常数

常数	类型	说明
OneHour	System::Extended	TDateTime 类型：一小时时间
OneMinute	System::Extended	TDateTime 类型：一分钟时间
OneSecond	System::Extended	TDateTime 类型：一秒钟时间
OneMillisecond	System::Extended	TDateTime 类型：一毫秒时间
DaysPerWeek	System::Int8	Week (一周) 有多少天 (7)
WeeksPerFortnight	System::Int8	Fortnight (两周) 有多少周 (2)
MonthsPerYear	System::Int8	Year (一年) 有多少个月 (12)
YearsPerDecade	System::Int8	Decade (十年) 有多少年 (10)
YearsPerCentury	System::Int8	Century (世纪) 有多少年 (100)
YearsPerMillennium	System::Word	Millennium (千年) 有多少年 (1000)
DayMonday	System::Int8	星期一 (1)
DayTuesday	System::Int8	星期二 (2)
DayWednesday	System::Int8	星期三 (3)
DayThursday	System::Int8	星期四 (4)
DayFriday	System::Int8	星期五 (5)
DaySaturday	System::Int8	星期六 (6)
DaySunday	System::Int8	星期天 (7)
MonthJanuary	System::Int8	一月 (1)
MonthFebruary	System::Int8	二月 (2)
MonthMarch	System::Int8	三月 (3)
MonthApril	System::Int8	四月 (4)
MonthMay	System::Int8	五月 (5)
MonthJune	System::Int8	六月 (6)
MonthJuly	System::Int8	七月 (7)
MonthAugust	System::Int8	八月 (8)
MonthSeptember	System::Int8	九月 (9)
MonthOctober	System::Int8	十月 (10)
MonthNovember	System::Int8	十一月 (11)
MonthDecember	System::Int8	十二月 (12)
EpochAsJulianDate	System::Extended	TDateTime 与儒略日的时间差
EpochAsUnixDate	__int64	TDateTime 与 UNIX 时间戳的时间差
RecodeLeaveFieldAsIs	System::Word	RecodeDateTime 的参数值，保持原值

四. System::Dateutils 变量

变量	类型	说明
ApproxDaysPerMonth	double	一个月大约有多少天 (30.4375)
ApproxDaysPerYear	double	一年大约有多少天 (365.25)
DaysPerYear	System::StaticArray	一年有多少天 {365, 366}

五. System::Dateutils 函数

函数	说明
DateOf	提取日期时间当中的日期
TimeOf	提取日期时间当中的时间
IsInLeapYear	这个日期和时间是在闰年
IsAM	这个时间是上午
IsPM	这个时间是下午
IsValidDate	判断年、月、日是有效的日期
IsValidTime	判断时、分、秒、毫秒是有效的时间
IsValidDateTime	判断年、月、日、时、分、秒、毫秒是有效的日期和时间
IsValidDateMonthWeek	年、月、这个月的周、这个周的第几天是否有效
IsValidDateDay	年、这个年的第几天是否有效
IsValidDateWeek	年、这个年的第几周、这个周的第几天是否有效
DaysInYear	这个日期所在的年一共有多少天
DaysInAYear	这一年一共有多少天
DaysInMonth	这个日期所在的月份一共有多少天
DaysInAMonth	这个年的这个月份一共有多少天
WeeksInYear	这个日期所在的年一共有多少周
WeeksInAYear	这一年一共有多少周
Today	今天的日期 (时间部分为 0)
Yesterday	昨天的日期 (时间部分为 0)
Tomorrow	明天的日期 (时间部分为 0)
IsToday	这个时间是否在今天
IsSameDay	这两个时间是否在同一天
YearOf	提取日期时间的年
MonthOf	提取日期时间的月
DayOf	提取日期时间的日
WeekOf	这个日期时间在这一年的第几周 (ISO 8601)
HourOf	提取日期时间的时
MinuteOf	提取日期时间的分
SecondOf	提取日期时间的秒
MilliSecondOf	提取日期时间的毫秒
StartOfTheYear	这个日期时间所在年的 1 月 1 日 00:00:00.000
EndOfTheYear	这个日期时间所在年的 12月31日 23:59:59.999
StartOfTheMonth	这个日期时间所在月份的 1 日 00:00:00.000
EndOfTheMonth	这个日期时间所在月份的最后一天 23:59:59.999
StartOfTheWeek	这个日期时间所在周星期一 00:00:00.000 (ISO 8601)
EndOfTheWeek	这个日期时间所在周星期天 23:59:59.999 (ISO 8601)
StartOfTheDay	这个日期时间所在天的 00:00:00.000
EndOfTheDay	这个日期时间所在天的 23:59:59.999
StartOfAYear	这一年的 1 月 1 日 00:00:00.000
EndOfAYear	这一年的 12月31日 23:59:59.999
StartOfAMonth	这个月的 1 日 00:00:00.000
EndOfAMonth	这个月的最后一天的 23:59:59.999
StartOfAWeek	这一年的这一周星期一 00:00:00.000 (ISO 8601)
EndOfAWeek	这一年的这一周星期天 23:59:59.999 (ISO 8601)
StartOfADay	这一天的 00:00:00.000
EndOfADay	这一天的 23:59:59.999
MonthOfTheYear	这个日期时间所在的月份
WeekOfTheYear	这个日期时间所在的周 (ISO 8601)
DayOfTheYear	这个日期时间所在的天是这一年的第几天
HourOfTheYear	这个日期时间所在的小时是这一年的第几个小时
MinuteOfTheYear	这个日期时间所在的分钟是这一年的第几个分钟
SecondOfTheYear	这个日期时间所在的秒是这一年的第几个秒
MilliSecondOfTheYear	这个日期时间所在的毫秒是这一年的第几个毫秒
WeekOfTheMonth	这个日期时间在这个月的第几周 (ISO 8601)
DayOfTheMonth	这个日期时间在这个月的第几天
HourOfTheMonth	这个日期时间在这个月的第几个小时
MinuteOfTheMonth	这个日期时间在这个月的第几分钟
SecondOfTheMonth	这个日期时间在这个月的第几秒钟
MilliSecondOfTheMonth	这个日期时间在这个月的第几个毫秒
DayOfTheWeek	这个日期时间在所在周的第几天 (ISO 8601)
HourOfTheWeek	这个日期时间在所在周的第几小时 (ISO 8601)
MinuteOfTheWeek	这个日期时间在所在周的第几分钟 (ISO 8601)
SecondOfTheWeek	这个日期时间在所在周的第几秒钟 (ISO 8601)
MilliSecondOfTheWeek	这个日期时间在所在周的第几毫秒 (ISO 8601)
HourOfTheDay	这个日期时间是这一天的第几个小时
MinuteOfTheDay	这个日期时间是这一天的第几分钟
SecondOfTheDay	这个日期时间是这一天的第几秒钟
MilliSecondOfTheDay	这个日期时间是这一天的第几毫秒
MinuteOfTheHour	这个日期时间是这一小时的第几分钟
SecondOfTheHour	这个日期时间是这一小时的第几秒钟
MilliSecondOfTheHour	这个日期时间是这一小时的第几毫秒
SecondOfTheMinute	这个日期时间是这一分钟的第几秒钟
MilliSecondOfTheMinute	这个日期时间是这一分钟的第几毫秒
MilliSecondOfTheSecond	这个日期时间是这一秒的第几毫秒
WithinPastYears	两个日期时间是否相差在几年之内
WithinPastMonths	两个日期时间是否相差在几个月之内
WithinPastWeeks	两个日期时间是否相差在几周之内
WithinPastDays	两个日期时间是否相差在几天之内
WithinPastHours	两个日期时间是否相差在几个小时之内
WithinPastMinutes	两个日期时间是否相差在几分钟之内
WithinPastSeconds	两个日期时间是否相差在几秒钟之内
WithinPastMilliSeconds	两个日期时间是否相差在几毫秒之内
YearsBetween	两个日期时间相差多少年
MonthsBetween	两个日期时间相差多少个月
WeeksBetween	两个日期时间相差多少周
DaysBetween	两个日期时间相差多少天
HoursBetween	两个日期时间相差多少小时
MinutesBetween	两个日期时间相差多少分钟
SecondsBetween	两个日期时间相差多少秒
MilliSecondsBetween	两个日期时间相差多少毫秒
DateTimeInRange	这个日期时间是否在两个日期时间之间
TimeInRange	这个时间是否在两个时间之间
DateInRange	这个日期是否在两个日期之间
YearSpan	两个日期时间相差多少年 (小数)
MonthSpan	两个日期时间相差多少月 (小数)
WeekSpan	两个日期时间相差多少周 (小数)
DaySpan	两个日期时间相差多少天 (小数)
HourSpan	两个日期时间相差多少小时 (小数)
MinuteSpan	两个日期时间相差多少分钟 (小数)
SecondSpan	两个日期时间相差多少秒 (小数)
MilliSecondSpan	两个日期时间相差多少毫秒 (小数)
IncYear	这个日期时间几年之前(后)的日期时间
IncWeek	这个日期时间几周之前(后)的日期时间
IncDay	这个日期时间几天之前(后)的日期时间
IncHour	这个日期时间几小时之前(后)的日期时间
IncMinute	这个日期时间几分钟之前(后)的日期时间
IncSecond	这个日期时间几秒之前(后)的日期时间
IncMilliSecond	这个日期时间几毫秒之前(后)的日期时间
EncodeDateTime	年月日时分毫秒转日期时间
DecodeDateTime	日期时间转年月日时分毫秒
EncodeDateWeek	年、第几周、这个周的第几天转日期
DecodeDateWeek	日期转年、第几周、这个周的第几天
EncodeDateDay	年、这一年的第几天转日期
DecodeDateDay	日期转年、这一年的第几天
EncodeDateMonthWeek	年、月、这个月的第几周、这个周的第几天转日期
DecodeDateMonthWeek	日期转年、月、这个月的第几周、这个周的第几天
TryEncodeDateTime	年月日时分毫秒转日期时间
TryEncodeDateWeek	年、第几周、这个周的第几天转日期
TryEncodeDateDay	年、这一年的第几天转日期
TryEncodeDateMonthWeek	年、月、这个月的第几周、这个周的第几天转日期
RecodeYear	改变日期时间当中的年
RecodeMonth	改变日期时间当中的月
RecodeDay	改变日期时间当中的日
RecodeHour	改变日期时间当中的时
RecodeMinute	改变日期时间当中的分
RecodeSecond	改变日期时间当中的秒
RecodeMilliSecond	改变日期时间当中的毫秒
RecodeDate	改变日期时间当中的日期
RecodeTime	改变日期时间当中的时间
RecodeDateTime	改变日期时间当中某些组成部分
TryRecodeDateTime	改变日期时间当中的某些组成部分
SameDateTime	两个日期时间是否相同
SameDate	两个日期时间的日期是否相同
SameTime	两个日期时间的时间是否相同
CompareDateTime	比较两个日期时间的大小
CompareDate	比较两个日期时间的日期的大小
CompareTime	比较两个日期时间的时间的大小
NthDayOfWeek	这个日期是这个月的第几周
DecodeDayOfWeekInMonth	日期时间转年、月、这个月的第几周、这个周的第几天
EncodeDayOfWeekInMonth	年、月、这个月的第几周、这个周的第几天转日期时间
TryEncodeDayOfWeekInMonth	年、月、这个月的第几周、这个周的第几天转日期时间
DateTimeToJulianDate	日期时间转儒略日
JulianDateToDateTime	儒略日转日期时间
TryJulianDateToDateTime	儒略日转日期时间
DateTimeToModifiedJulianDate	日期时间转修正的儒略日
ModifiedJulianDateToDateTime	修正的儒略日转日期时间
TryModifiedJulianDateToDateTime	修正的儒略日转日期时间
DateTimeToUnix	日期时间转 UNIX 时间戳
UnixToDateTime	UNIX 时间戳转日期时间
InvalidDateTimeError	如果日期时间无效，抛出 EConvertError 异常
InvalidDateWeekError	如果年、周、日无效，抛出 EConvertError 异常
InvalidDateDayError	如果年、天无效，抛出 EConvertError 异常
InvalidDateMonthWeekError	如果年、月、周、天无效，抛出 EConvertError 异常
InvalidDayOfWeekInMonthError	如果年、月、周、日无效，抛出 EConvertError 异常
DateToISO8601	日期时间转 ISO 8601 格式
ISO8601ToDate	ISO 8601 格式转日期时间
TryISO8601ToDate	ISO 8601 格式转日期时间

---

相关：

• System
• System::Classes
• System::Sysutils
• System::Ioutils
• System::Netencoding

---

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