DateTimeExtensions
DateTimeExtensions 扩展类文档
Section titled “DateTimeExtensions 扩展类文档”DateTimeExtensions 是一个静态扩展类,为 DateTime 类型提供了丰富的扩展方法,包括日期时间判断、转换、计算、格式化等功能,旨在简化日期时间的处理,提高代码的可读性和便捷性。
主要功能模块
Section titled “主要功能模块”1. 基础判断
Section titled “1. 基础判断”提供 DateTime 状态判断的便捷方法。
IsDefault
Section titled “IsDefault”判断 DateTime 是否为默认值(0001-01-01 00:00:00)。
public static bool IsDefault(this DateTime dt)参数:
dt: 待判断的 DateTime
返回值:
- 如果 DateTime 等于 default(DateTime),返回 true;否则返回 false
示例:
DateTime dt1 = default;DateTime dt2 = DateTime.Now;
bool result1 = dt1.IsDefault(); // truebool result2 = dt2.IsDefault(); // falseIsMinValue
Section titled “IsMinValue”判断 DateTime 是否为最小值(0001-01-01 00:00:00)。
public static bool IsMinValue(this DateTime dt)参数:
dt: 待判断的 DateTime
返回值:
- 如果 DateTime 等于 DateTime.MinValue,返回 true;否则返回 false
示例:
DateTime dt = DateTime.MinValue;bool result = dt.IsMinValue(); // trueIsMaxValue
Section titled “IsMaxValue”判断 DateTime 是否为最大值(9999-12-31 23:59:59.9999999)。
public static bool IsMaxValue(this DateTime dt)参数:
dt: 待判断的 DateTime
返回值:
- 如果 DateTime 等于 DateTime.MaxValue,返回 true;否则返回 false
示例:
DateTime dt = DateTime.MaxValue;bool result = dt.IsMaxValue(); // trueIsToday
Section titled “IsToday”判断 DateTime 是否为今天。
public static bool IsToday(this DateTime dt)参数:
dt: 待判断的 DateTime
返回值:
- 如果 DateTime 的日期部分等于今天的日期,返回 true;否则返回 false
示例:
DateTime dt = DateTime.Now;bool result = dt.IsToday(); // trueIsYesterday
Section titled “IsYesterday”判断 DateTime 是否为昨天。
public static bool IsYesterday(this DateTime dt)参数:
dt: 待判断的 DateTime
返回值:
- 如果 DateTime 的日期部分等于昨天的日期,返回 true;否则返回 false
示例:
DateTime dt = DateTime.Now.AddDays(-1);bool result = dt.IsYesterday(); // trueIsTomorrow
Section titled “IsTomorrow”判断 DateTime 是否为明天。
public static bool IsTomorrow(this DateTime dt)参数:
dt: 待判断的 DateTime
返回值:
- 如果 DateTime 的日期部分等于明天的日期,返回 true;否则返回 false
示例:
DateTime dt = DateTime.Now.AddDays(1);bool result = dt.IsTomorrow(); // trueIsNullOrDefault
Section titled “IsNullOrDefault”判断 DateTime 是否为 null 或默认值(针对 Nullable<DateTime>)。
public static bool IsNullOrDefault(this DateTime? dt)参数:
dt: 待判断的可空 DateTime
返回值:
- 如果 DateTime 为 null 或等于默认值,返回 true;否则返回 false
示例:
DateTime? dt1 = null;DateTime? dt2 = default(DateTime);
bool result1 = dt1.IsNullOrDefault(); // truebool result2 = dt2.IsNullOrDefault(); // true2. 日期属性判断
Section titled “2. 日期属性判断”提供 DateTime 日期属性判断的便捷方法。
IsLeapYear
Section titled “IsLeapYear”判断 DateTime 所在年份是否为闰年。
public static bool IsLeapYear(this DateTime dt)参数:
dt: 待判断的 DateTime
返回值:
- 如果是闰年返回 true;否则返回 false
示例:
DateTime dt = new DateTime(2024, 1, 1);bool result = dt.IsLeapYear(); // true (2024年是闰年)IsWeekend
Section titled “IsWeekend”判断 DateTime 是否为周末(周六或周日)。
public static bool IsWeekend(this DateTime dt)参数:
dt: 待判断的 DateTime
返回值:
- 如果是周六或周日返回 true;否则返回 false
示例:
DateTime dt = new DateTime(2024, 1, 6); // 周六bool result = dt.IsWeekend(); // trueIsWeekday
Section titled “IsWeekday”判断 DateTime 是否为工作日(周一到周五)。
public static bool IsWeekday(this DateTime dt)参数:
dt: 待判断的 DateTime
返回值:
- 如果是周一到周五返回 true;否则返回 false
示例:
DateTime dt = new DateTime(2024, 1, 8); // 周一bool result = dt.IsWeekday(); // true判断 DateTime 是否为上午(0:00 - 11:59)。
public static bool IsAM(this DateTime dt)参数:
dt: 待判断的 DateTime
返回值:
- 如果小时数小于 12 返回 true;否则返回 false
示例:
DateTime dt = new DateTime(2024, 1, 1, 9, 0, 0);bool result = dt.IsAM(); // true判断 DateTime 是否为下午(12:00 - 23:59)。
public static bool IsPM(this DateTime dt)参数:
dt: 待判断的 DateTime
返回值:
- 如果小时数大于等于 12 返回 true;否则返回 false
示例:
DateTime dt = new DateTime(2024, 1, 1, 14, 0, 0);bool result = dt.IsPM(); // trueIsFirstDayOfMonth
Section titled “IsFirstDayOfMonth”判断 DateTime 是否为指定月份的第一天。
public static bool IsFirstDayOfMonth(this DateTime dt)参数:
dt: 待判断的 DateTime
返回值:
- 如果是当月第一天返回 true;否则返回 false
示例:
DateTime dt = new DateTime(2024, 1, 1);bool result = dt.IsFirstDayOfMonth(); // trueIsLastDayOfMonth
Section titled “IsLastDayOfMonth”判断 DateTime 是否为指定月份的最后一天。
public static bool IsLastDayOfMonth(this DateTime dt)参数:
dt: 待判断的 DateTime
返回值:
- 如果是当月最后一天返回 true;否则返回 false
示例:
DateTime dt = new DateTime(2024, 1, 31);bool result = dt.IsLastDayOfMonth(); // true3. 季度和周计算
Section titled “3. 季度和周计算”提供季度和周相关的计算功能。
GetQuarter
Section titled “GetQuarter”获取 DateTime 所在的季度(1-4)。
public static int GetQuarter(this DateTime dt)参数:
dt: 待处理的 DateTime
返回值:
- 季度数字,范围 1-4
示例:
DateTime dt = new DateTime(2024, 5, 15);int quarter = dt.GetQuarter(); // 2ToQuarter
Section titled “ToQuarter”获取 DateTime 所在季度(GetQuarter 的别名方法)。
public static int ToQuarter(this DateTime dt)参数:
dt: 待处理的 DateTime
返回值:
- 季度数,范围 1-4
示例:
DateTime dt = new DateTime(2024, 5, 15);int quarter = dt.ToQuarter(); // 2ToQuarterString
Section titled “ToQuarterString”获取 DateTime 所在季度的字符串表示(如 “Q1”)。
public static string ToQuarterString(this DateTime dt)参数:
dt: 待处理的 DateTime
返回值:
- 季度字符串,格式为 “Q1”、“Q2”、“Q3” 或 “Q4”
示例:
DateTime dt = new DateTime(2024, 5, 15);string result = dt.ToQuarterString(); // "Q2"GetWeekOfYear
Section titled “GetWeekOfYear”获取 DateTime 所在年份的第几周。
public static int GetWeekOfYear(this DateTime dt, CalendarWeekRule rule = CalendarWeekRule.FirstDay)参数:
dt: 待处理的 DateTimerule: 确定日历周的规则,默认为当前文化的规则
返回值:
- 周数,范围 1-53
示例:
DateTime dt = new DateTime(2024, 1, 15);int week = dt.GetWeekOfYear(); // 返回该日期是当年的第几周GetWeekOfMonth
Section titled “GetWeekOfMonth”获取 DateTime 所在月份的第几周。
public static int GetWeekOfMonth(this DateTime dt)参数:
dt: 待处理的 DateTime
返回值:
- 当月周数,范围 1-6
示例:
DateTime dt = new DateTime(2024, 1, 15);int week = dt.GetWeekOfMonth(); // 当月第几周GetFirstDayOfQuarter
Section titled “GetFirstDayOfQuarter”获取 DateTime 所在季度的第一天。
public static DateTime GetFirstDayOfQuarter(this DateTime dt)参数:
dt: 待处理的 DateTime
返回值:
- 季度第一天的 DateTime
示例:
DateTime dt = new DateTime(2024, 5, 15);DateTime firstDay = dt.GetFirstDayOfQuarter(); // 2024-04-01GetLastDayOfQuarter
Section titled “GetLastDayOfQuarter”获取 DateTime 所在季度的最后一天。
public static DateTime GetLastDayOfQuarter(this DateTime dt)参数:
dt: 待处理的 DateTime
返回值:
- 季度最后一天的 DateTime
示例:
DateTime dt = new DateTime(2024, 5, 15);DateTime lastDay = dt.GetLastDayOfQuarter(); // 2024-06-304. 时间转换
Section titled “4. 时间转换”提供 DateTime 与 Unix 时间戳之间的相互转换。
ToUnixTimestamp
Section titled “ToUnixTimestamp”将 DateTime 转换为 Unix 时间戳(秒)。
public static long ToUnixTimestamp(this DateTime dt)参数:
dt: 待转换的 DateTime
返回值:
- Unix 时间戳(自 1970-01-01 00:00:00 UTC 以来的秒数)
示例:
DateTime dt = new DateTime(2024, 1, 1, 0, 0, 0, DateTimeKind.Utc);long timestamp = dt.ToUnixTimestamp(); // 1704067200ToUnixTimestampMs
Section titled “ToUnixTimestampMs”将 DateTime 转换为 Unix 时间戳(毫秒)。
public static long ToUnixTimestampMs(this DateTime dt)参数:
dt: 待转换的 DateTime
返回值:
- Unix 时间戳(自 1970-01-01 00:00:00 UTC 以来的毫秒数)
示例:
DateTime dt = new DateTime(2024, 1, 1, 0, 0, 0, DateTimeKind.Utc);long timestamp = dt.ToUnixTimestampMs(); // 1704067200000FromUnixTimestamp
Section titled “FromUnixTimestamp”将 Unix 时间戳(秒)转换为 DateTime。
public static DateTime FromUnixTimestamp(this long timestamp)参数:
timestamp: Unix 时间戳(秒)
返回值:
- 本地时间的 DateTime
示例:
long timestamp = 1704067200;DateTime dt = timestamp.FromUnixTimestamp();FromUnixTimestampMs
Section titled “FromUnixTimestampMs”将 Unix 时间戳(毫秒)转换为 DateTime。
public static DateTime FromUnixTimestampMs(this long timestampMs)参数:
timestampMs: Unix 时间戳(毫秒)
返回值:
- 本地时间的 DateTime
示例:
long timestampMs = 1704067200000;DateTime dt = timestampMs.FromUnixTimestampMs();ToLocalTimeSafe
Section titled “ToLocalTimeSafe”将 DateTime 转换为本地时间。
public static DateTime ToLocalTimeSafe(this DateTime dt)参数:
dt: 待转换的 DateTime
返回值:
- 本地时间的 DateTime
示例:
DateTime utcTime = DateTime.UtcNow;DateTime localTime = utcTime.ToLocalTimeSafe();ToUtcTimeSafe
Section titled “ToUtcTimeSafe”将 DateTime 转换为 UTC 时间。
public static DateTime ToUtcTimeSafe(this DateTime dt)参数:
dt: 待转换的 DateTime
返回值:
- UTC 时间的 DateTime
示例:
DateTime localTime = DateTime.Now;DateTime utcTime = localTime.ToUtcTimeSafe();ToTimeZone
Section titled “ToTimeZone”将 DateTime 转换为指定时区的时间。
public static DateTime ToTimeZone(this DateTime dt, string timeZoneId)参数:
dt: 待转换的 DateTimetimeZoneId: 时区标识,如 “China Standard Time”、“Pacific Standard Time”
返回值:
- 指定时区的 DateTime
异常:
TimeZoneNotFoundException: 时区标识无效时抛出
示例:
DateTime dt = DateTime.UtcNow;DateTime chinaTime = dt.ToTimeZone("China Standard Time");ToDateTimeOffset
Section titled “ToDateTimeOffset”将 DateTime 转换为 DateTimeOffset。
public static DateTimeOffset ToDateTimeOffset(this DateTime dt)参数:
dt: 待转换的 DateTime
返回值:
- DateTimeOffset 对象
示例:
DateTime dt = DateTime.Now;DateTimeOffset dto = dt.ToDateTimeOffset();5. 格式化输出
Section titled “5. 格式化输出”提供日期时间到各种格式字符串的转换。
ToFormatString
Section titled “ToFormatString”将 DateTime 格式化为指定格式的字符串。
public static string ToFormatString(this DateTime dt, string format = "yyyy-MM-dd HH:mm:ss")参数:
dt: 待格式化的 DateTimeformat: 格式字符串,默认为 “yyyy-MM-dd HH:mm:ss”
返回值:
- 格式化后的日期时间字符串
示例:
DateTime dt = DateTime.Now;string result = dt.ToFormatString("yyyy年MM月dd日 HH:mm:ss");ToIso8601String
Section titled “ToIso8601String”将 DateTime 转换为 ISO8601 格式字符串。
public static string ToIso8601String(this DateTime dt)参数:
dt: 待格式化的 DateTime
返回值:
- ISO8601 格式的字符串(如 “2024-01-15T14:30:00.0000000+08:00”)
示例:
DateTime dt = DateTime.Now;string result = dt.ToIso8601String();ToRfc1123String
Section titled “ToRfc1123String”将 DateTime 转换为 RFC1123 格式字符串。
public static string ToRfc1123String(this DateTime dt)参数:
dt: 待格式化的 DateTime
返回值:
- RFC1123 格式的字符串(如 “Mon, 15 Jan 2024 14:30:00 GMT”)
示例:
DateTime dt = DateTime.Now;string result = dt.ToRfc1123String();ToChineseDateString
Section titled “ToChineseDateString”将 DateTime 转换为中文日期字符串。
public static string ToChineseDateString(this DateTime dt)参数:
dt: 待格式化的 DateTime
返回值:
- 中文日期字符串(如 “2024年01月15日”)
示例:
DateTime dt = DateTime.Now;string result = dt.ToChineseDateString(); // "2024年01月15日"ToChineseDateTimeString
Section titled “ToChineseDateTimeString”将 DateTime 转换为中文日期时间字符串。
public static string ToChineseDateTimeString(this DateTime dt)参数:
dt: 待格式化的 DateTime
返回值:
- 中文日期时间字符串(如 “2024年01月15日 14时30分”)
示例:
DateTime dt = DateTime.Now;string result = dt.ToChineseDateTimeString(); // "2024年01月15日 14时30分"ToTimestampString
Section titled “ToTimestampString”将 DateTime 转换为时间戳字符串。
public static string ToTimestampString(this DateTime dt)参数:
dt: 待格式化的 DateTime
返回值:
- 时间戳字符串(如 “20240115143000”)
示例:
DateTime dt = new DateTime(2024, 1, 15, 14, 30, 0);string result = dt.ToTimestampString(); // "20240115143000"ToCustomTimestamp
Section titled “ToCustomTimestamp”将 DateTime 转换为精确到毫秒的时间戳字符串。
public static string ToCustomTimestamp(this DateTime dt)参数:
dt: 待格式化的 DateTime
返回值:
- 时间戳字符串(如 “20240115143000123”)
示例:
DateTime dt = DateTime.Now;string result = dt.ToCustomTimestamp(); // "20240115143000123"ToDateString
Section titled “ToDateString”将 DateTime 转换为日期字符串。
public static string ToDateString(this DateTime dt)参数:
dt: 待格式化的 DateTime
返回值:
- 日期字符串(如 “2024-01-15”)
示例:
DateTime dt = DateTime.Now;string result = dt.ToDateString(); // "2024-01-15"ToTimeString
Section titled “ToTimeString”将 DateTime 转换为时间字符串。
public static string ToTimeString(this DateTime dt)参数:
dt: 待格式化的 DateTime
返回值:
- 时间字符串(如 “14:30:00”)
示例:
DateTime dt = DateTime.Now;string result = dt.ToTimeString(); // "14:30:00"ToShortTimeString
Section titled “ToShortTimeString”将 DateTime 转换为短时间字符串。
public static string ToShortTimeString(this DateTime dt)参数:
dt: 待格式化的 DateTime
返回值:
- 短时间字符串(如 “14:30”)
示例:
DateTime dt = DateTime.Now;string result = dt.ToShortTimeString(); // "14:30"ToChineseWeekday
Section titled “ToChineseWeekday”将 DateTime 转换为星期中文名称。
public static string ToChineseWeekday(this DateTime dt)参数:
dt: 待格式化的 DateTime
返回值:
- 星期中文名称(如 “星期一”)
示例:
DateTime dt = DateTime.Now;string result = dt.ToChineseWeekday(); // "星期一"ToEnglishWeekday
Section titled “ToEnglishWeekday”将 DateTime 转换为星期英文名称。
public static string ToEnglishWeekday(this DateTime dt)参数:
dt: 待格式化的 DateTime
返回值:
- 星期英文名称(如 “Monday”)
示例:
DateTime dt = DateTime.Now;string result = dt.ToEnglishWeekday(); // "Monday"ToWeekdayNumber
Section titled “ToWeekdayNumber”将 DateTime 转换为星期数字(周日为 0,周一为 1,依此类推)。
public static int ToWeekdayNumber(this DateTime dt)参数:
dt: 待处理的 DateTime
返回值:
- 星期数字,范围 0-6
示例:
DateTime dt = new DateTime(2024, 1, 15); // 周一int result = dt.ToWeekdayNumber(); // 16. 日期计算
Section titled “6. 日期计算”提供日期时间加减和时间差计算功能。
AddDaysSafe
Section titled “AddDaysSafe”安全地增加指定天数。
public static DateTime AddDaysSafe(this DateTime dt, double days)参数:
dt: 原始 DateTimedays: 要增加的天数,可为负数
返回值:
- 增加天数后的 DateTime
示例:
DateTime dt = DateTime.Now;DateTime result = dt.AddDaysSafe(7);AddHoursSafe
Section titled “AddHoursSafe”安全地增加指定小时数。
public static DateTime AddHoursSafe(this DateTime dt, double hours)参数:
dt: 原始 DateTimehours: 要增加的小时数,可为负数
返回值:
- 增加小时数后的 DateTime
示例:
DateTime dt = DateTime.Now;DateTime result = dt.AddHoursSafe(2);AddMinutesSafe
Section titled “AddMinutesSafe”安全地增加指定分钟数。
public static DateTime AddMinutesSafe(this DateTime dt, double minutes)参数:
dt: 原始 DateTimeminutes: 要增加的分钟数,可为负数
返回值:
- 增加分钟数后的 DateTime
示例:
DateTime dt = DateTime.Now;DateTime result = dt.AddMinutesSafe(30);AddSecondsSafe
Section titled “AddSecondsSafe”安全地增加指定秒数。
public static DateTime AddSecondsSafe(this DateTime dt, double seconds)参数:
dt: 原始 DateTimeseconds: 要增加的秒数,可为负数
返回值:
- 增加秒数后的 DateTime
示例:
DateTime dt = DateTime.Now;DateTime result = dt.AddSecondsSafe(60);AddMonthsSafe
Section titled “AddMonthsSafe”安全地增加指定月份数。
public static DateTime AddMonthsSafe(this DateTime dt, int months)参数:
dt: 原始 DateTimemonths: 要增加的月份数,可为负数
返回值:
- 增加月份数后的 DateTime
示例:
DateTime dt = DateTime.Now;DateTime result = dt.AddMonthsSafe(3);AddYearsSafe
Section titled “AddYearsSafe”安全地增加指定年份数。
public static DateTime AddYearsSafe(this DateTime dt, int years)参数:
dt: 原始 DateTimeyears: 要增加的年份数,可为负数
返回值:
- 增加年份数后的 DateTime
示例:
DateTime dt = DateTime.Now;DateTime result = dt.AddYearsSafe(1);AddWorkDays
Section titled “AddWorkDays”安全地增加指定工作日数(跳过周末)。
public static DateTime AddWorkDays(this DateTime dt, int workDays)参数:
dt: 原始 DateTimeworkDays: 要增加的工作日数,可为负数
返回值:
- 增加工作日数后的 DateTime
示例:
DateTime dt = new DateTime(2024, 1, 5); // 周五DateTime result = dt.AddWorkDays(1); // 返回下周一DateTime result2 = dt.AddWorkDays(5); // 下周五DaysBetween
Section titled “DaysBetween”获取两个 DateTime 之间的天数差。
public static double DaysBetween(this DateTime dt, DateTime other)参数:
dt: 起始 DateTimeother: 结束 DateTime
返回值:
- 两个日期之间的天数差的绝对值
示例:
DateTime dt1 = new DateTime(2024, 1, 1);DateTime dt2 = new DateTime(2024, 1, 10);
double days = dt1.DaysBetween(dt2); // 9HoursBetween
Section titled “HoursBetween”获取两个 DateTime 之间的小时差。
public static double HoursBetween(this DateTime dt, DateTime other)参数:
dt: 起始 DateTimeother: 结束 DateTime
返回值:
- 两个日期时间之间的小时差的绝对值
示例:
DateTime dt1 = new DateTime(2024, 1, 1, 0, 0, 0);DateTime dt2 = new DateTime(2024, 1, 1, 5, 30, 0);
double hours = dt1.HoursBetween(dt2); // 5.5MinutesBetween
Section titled “MinutesBetween”获取两个 DateTime 之间的分钟差。
public static double MinutesBetween(this DateTime dt, DateTime other)参数:
dt: 起始 DateTimeother: 结束 DateTime
返回值:
- 两个日期时间之间的分钟差的绝对值
示例:
DateTime dt1 = new DateTime(2024, 1, 1, 0, 0, 0);DateTime dt2 = new DateTime(2024, 1, 1, 0, 30, 0);
double minutes = dt1.MinutesBetween(dt2); // 30SecondsBetween
Section titled “SecondsBetween”获取两个 DateTime 之间的秒数差。
public static double SecondsBetween(this DateTime dt, DateTime other)参数:
dt: 起始 DateTimeother: 结束 DateTime
返回值:
- 两个日期时间之间的秒数差的绝对值
示例:
DateTime dt1 = new DateTime(2024, 1, 1, 0, 0, 0);DateTime dt2 = new DateTime(2024, 1, 1, 0, 0, 45);
double seconds = dt1.SecondsBetween(dt2); // 45SpanBetween
Section titled “SpanBetween”获取两个 DateTime 之间的时间间隔。
public static TimeSpan SpanBetween(this DateTime dt, DateTime other)参数:
dt: 起始 DateTimeother: 结束 DateTime
返回值:
- 两个日期时间之间的时间间隔(绝对值)
示例:
DateTime dt1 = new DateTime(2024, 1, 1);DateTime dt2 = new DateTime(2024, 1, 3, 12, 0, 0);
TimeSpan span = dt1.SpanBetween(dt2); // 2.5 天根据出生日期计算年龄。
public static int ToAge(this DateTime birthDate)参数:
birthDate: 出生日期
返回值:
- 年龄(周岁),如果出生日期在未来则返回 0
示例:
DateTime birthDate = new DateTime(1990, 5, 15);int age = birthDate.ToAge(); // 返回当前年龄7. 时间比较
Section titled “7. 时间比较”提供时间比较和范围判断功能。
IsBetween
Section titled “IsBetween”判断 DateTime 是否在指定范围内(包含边界)。
public static bool IsBetween(this DateTime dt, DateTime start, DateTime end)参数:
dt: 待判断的 DateTimestart: 起始时间end: 结束时间
返回值:
- 如果 DateTime 在范围内返回 true;否则返回 false
示例:
DateTime dt = DateTime.Now;DateTime start = new DateTime(2024, 1, 1);DateTime end = new DateTime(2024, 12, 31);
bool result = dt.IsBetween(start, end); // trueIsBefore
Section titled “IsBefore”判断 DateTime 是否早于指定时间。
public static bool IsBefore(this DateTime dt, DateTime other)参数:
dt: 待判断的 DateTimeother: 比较的时间
返回值:
- 如果早于指定时间返回 true;否则返回 false
示例:
DateTime dt = new DateTime(2024, 1, 1);DateTime other = new DateTime(2024, 6, 1);
bool result = dt.IsBefore(other); // trueIsAfter
Section titled “IsAfter”判断 DateTime 是否晚于指定时间。
public static bool IsAfter(this DateTime dt, DateTime other)参数:
dt: 待判断的 DateTimeother: 比较的时间
返回值:
- 如果晚于指定时间返回 true;否则返回 false
示例:
DateTime dt = new DateTime(2024, 6, 1);DateTime other = new DateTime(2024, 1, 1);
bool result = dt.IsAfter(other); // true8. 时间范围
Section titled “8. 时间范围”提供获取时间范围的功能。
GetStartOfDay
Section titled “GetStartOfDay”获取当天的开始时间(00:00:00)。
public static DateTime GetStartOfDay(this DateTime dt)参数:
dt: 待处理的 DateTime
返回值:
- 当天的开始时间
示例:
DateTime dt = DateTime.Now;DateTime start = dt.GetStartOfDay(); // 2024-01-15 00:00:00GetEndOfDay
Section titled “GetEndOfDay”获取当天的结束时间(23:59:59.9999999)。
public static DateTime GetEndOfDay(this DateTime dt)参数:
dt: 待处理的 DateTime
返回值:
- 当天的结束时间
示例:
DateTime dt = DateTime.Now;DateTime end = dt.GetEndOfDay(); // 2024-01-15 23:59:59.9999999GetStartOfWeek
Section titled “GetStartOfWeek”获取当周的第一天(周一)。
public static DateTime GetStartOfWeek(this DateTime dt, DayOfWeek startOfWeek = DayOfWeek.Monday)参数:
dt: 待处理的 DateTimestartOfWeek: 每周的第一天,默认为周一
返回值:
- 当周第一天的日期
示例:
DateTime dt = new DateTime(2024, 1, 17); // 周三DateTime start = dt.GetStartOfWeek(); // 2024-01-15 (周一)GetEndOfWeek
Section titled “GetEndOfWeek”获取当周的最后一天(周日)。
public static DateTime GetEndOfWeek(this DateTime dt, DayOfWeek startOfWeek = DayOfWeek.Monday)参数:
dt: 待处理的 DateTimestartOfWeek: 每周的第一天,默认为周一
返回值:
- 当周最后一天的日期
示例:
DateTime dt = new DateTime(2024, 1, 17); // 周三DateTime end = dt.GetEndOfWeek(); // 2024-01-21 (周日)GetStartOfMonth
Section titled “GetStartOfMonth”获取当月的第一天。
public static DateTime GetStartOfMonth(this DateTime dt)参数:
dt: 待处理的 DateTime
返回值:
- 当月第一天的日期
示例:
DateTime dt = new DateTime(2024, 1, 15);DateTime start = dt.GetStartOfMonth(); // 2024-01-01GetEndOfMonth
Section titled “GetEndOfMonth”获取当月的最后一天。
public static DateTime GetEndOfMonth(this DateTime dt)参数:
dt: 待处理的 DateTime
返回值:
- 当月最后一天的日期
示例:
DateTime dt = new DateTime(2024, 1, 15);DateTime end = dt.GetEndOfMonth(); // 2024-01-31GetStartOfYear
Section titled “GetStartOfYear”获取当年的第一天。
public static DateTime GetStartOfYear(this DateTime dt)参数:
dt: 待处理的 DateTime
返回值:
- 当年第一天的日期
示例:
DateTime dt = DateTime.Now;DateTime start = dt.GetStartOfYear(); // 2024-01-01GetEndOfYear
Section titled “GetEndOfYear”获取当年的最后一天。
public static DateTime GetEndOfYear(this DateTime dt)参数:
dt: 待处理的 DateTime
返回值:
- 当年最后一天的日期
示例:
DateTime dt = DateTime.Now;DateTime end = dt.GetEndOfYear(); // 2024-12-319. 特殊功能
Section titled “9. 特殊功能”提供农历转换、友好显示等特殊功能。
ToChineseLunarDate
Section titled “ToChineseLunarDate”将 DateTime 转换为农历日期字符串。
public static string ToChineseLunarDate(this DateTime dt)参数:
dt: 待格式化的 DateTime
返回值:
- 农历日期字符串(如 “正月初一”)
示例:
DateTime dt = new DateTime(2024, 1, 15);string result = dt.ToChineseLunarDate(); // 农历日期ToFriendlyString
Section titled “ToFriendlyString”将 DateTime 转换为友好时间描述。
public static string ToFriendlyString(this DateTime dt)参数:
dt: 待处理的 DateTime
返回值:
- 友好时间描述(如 “刚刚”、“5分钟前”、“昨天”、“3天前”)
示例:
DateTime dt = DateTime.Now.AddMinutes(-5);string result = dt.ToFriendlyString(); // "5分钟前"ToMinguoString
Section titled “ToMinguoString”将 DateTime 转换为民国纪年字符串。
public static string ToMinguoString(this DateTime dt)参数:
dt: 待格式化的 DateTime
返回值:
- 民国纪年字符串(如 “民国113年01月15日”)
示例:
DateTime dt = new DateTime(2024, 1, 15);string result = dt.ToMinguoString(); // "民国113年01月15日"ToJulianDayNumber
Section titled “ToJulianDayNumber”将 DateTime 转换为儒略日号(Julian Day Number)。
public static double ToJulianDayNumber(this DateTime dt)参数:
dt: 待处理的 DateTime
返回值:
- 儒略日号
示例:
DateTime dt = new DateTime(2024, 1, 15, 12, 0, 0);double jdn = dt.ToJulianDayNumber(); // 2460325.010. .NET 6+ 类型转换
Section titled “10. .NET 6+ 类型转换”提供 DateTime 与 DateOnly/TimeOnly 之间的转换功能。
ToDateOnly
Section titled “ToDateOnly”将 DateTime 转换为 DateOnly。
public static DateOnly ToDateOnly(this DateTime dt)参数:
dt: 待转换的 DateTime
返回值:
- DateOnly 对象
示例:
DateTime dt = DateTime.Now;DateOnly date = dt.ToDateOnly();ToTimeOnly
Section titled “ToTimeOnly”将 DateTime 转换为 TimeOnly。
public static TimeOnly ToTimeOnly(this DateTime dt)参数:
dt: 待转换的 DateTime
返回值:
- TimeOnly 对象
示例:
DateTime dt = DateTime.Now;TimeOnly time = dt.ToTimeOnly();- 时间格式化 - 将 DateTime 转换为各种指定格式的字符串显示
- 时间计算 - 计算时间差、增加时间等操作
- 国际化显示 - 支持中文、英文等多种语言的时间表示
- 时区转换 - 处理不同时区之间的时间转换
- 用户友好显示 - 提供友好的时间显示(如”刚刚”、“5分钟前”)
- 数据解析 - 时间戳转换到系统日期数据
- 报表生成 - 生成指定格式的时间报告
- 业务逻辑 - 判断工作日、周末、节假日等业务时间逻辑
- 所有方法都是扩展方法,需要通过
DateTime实例调用 - 大部分方法对边界进行了安全处理,不会抛出异常
- 时间戳转换使用 DateTimeOffset 实现,确保时区准确
- 农历转换支持中国农历,需要引用 System.Globalization.ChineseLunisolarCalendar
- 友好时间描述基于当前时间计算,不适合处理过去很久的时间
- 年龄计算考虑了月份和日期,结果准确
- 时区转换需要系统支持相应时区标识
- 部分方法如 ToDateOnly、ToTimeOnly 需要 .NET 6+ 版本支持