跳转到内容

DateTimeExtensions

DateTimeExtensions 是一个静态扩展类,为 DateTime 类型提供了丰富的扩展方法,包括日期时间判断、转换、计算、格式化等功能,旨在简化日期时间的处理,提高代码的可读性和便捷性。

提供 DateTime 状态判断的便捷方法。

判断 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(); // true
bool result2 = dt2.IsDefault(); // false

判断 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(); // true

判断 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(); // true

判断 DateTime 是否为今天。

public static bool IsToday(this DateTime dt)

参数:

  • dt: 待判断的 DateTime

返回值:

  • 如果 DateTime 的日期部分等于今天的日期,返回 true;否则返回 false

示例:

DateTime dt = DateTime.Now;
bool result = dt.IsToday(); // true

判断 DateTime 是否为昨天。

public static bool IsYesterday(this DateTime dt)

参数:

  • dt: 待判断的 DateTime

返回值:

  • 如果 DateTime 的日期部分等于昨天的日期,返回 true;否则返回 false

示例:

DateTime dt = DateTime.Now.AddDays(-1);
bool result = dt.IsYesterday(); // true

判断 DateTime 是否为明天。

public static bool IsTomorrow(this DateTime dt)

参数:

  • dt: 待判断的 DateTime

返回值:

  • 如果 DateTime 的日期部分等于明天的日期,返回 true;否则返回 false

示例:

DateTime dt = DateTime.Now.AddDays(1);
bool result = dt.IsTomorrow(); // true

判断 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(); // true
bool result2 = dt2.IsNullOrDefault(); // true

提供 DateTime 日期属性判断的便捷方法。

判断 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年是闰年)

判断 DateTime 是否为周末(周六或周日)。

public static bool IsWeekend(this DateTime dt)

参数:

  • dt: 待判断的 DateTime

返回值:

  • 如果是周六或周日返回 true;否则返回 false

示例:

DateTime dt = new DateTime(2024, 1, 6); // 周六
bool result = dt.IsWeekend(); // true

判断 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(); // true

判断 DateTime 是否为指定月份的第一天。

public static bool IsFirstDayOfMonth(this DateTime dt)

参数:

  • dt: 待判断的 DateTime

返回值:

  • 如果是当月第一天返回 true;否则返回 false

示例:

DateTime dt = new DateTime(2024, 1, 1);
bool result = dt.IsFirstDayOfMonth(); // true

判断 DateTime 是否为指定月份的最后一天。

public static bool IsLastDayOfMonth(this DateTime dt)

参数:

  • dt: 待判断的 DateTime

返回值:

  • 如果是当月最后一天返回 true;否则返回 false

示例:

DateTime dt = new DateTime(2024, 1, 31);
bool result = dt.IsLastDayOfMonth(); // true

提供季度和周相关的计算功能。

获取 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(); // 2

获取 DateTime 所在季度(GetQuarter 的别名方法)。

public static int ToQuarter(this DateTime dt)

参数:

  • dt: 待处理的 DateTime

返回值:

  • 季度数,范围 1-4

示例:

DateTime dt = new DateTime(2024, 5, 15);
int quarter = dt.ToQuarter(); // 2

获取 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"

获取 DateTime 所在年份的第几周。

public static int GetWeekOfYear(this DateTime dt, CalendarWeekRule rule = CalendarWeekRule.FirstDay)

参数:

  • dt: 待处理的 DateTime
  • rule: 确定日历周的规则,默认为当前文化的规则

返回值:

  • 周数,范围 1-53

示例:

DateTime dt = new DateTime(2024, 1, 15);
int week = dt.GetWeekOfYear(); // 返回该日期是当年的第几周

获取 DateTime 所在月份的第几周。

public static int GetWeekOfMonth(this DateTime dt)

参数:

  • dt: 待处理的 DateTime

返回值:

  • 当月周数,范围 1-6

示例:

DateTime dt = new DateTime(2024, 1, 15);
int week = dt.GetWeekOfMonth(); // 当月第几周

获取 DateTime 所在季度的第一天。

public static DateTime GetFirstDayOfQuarter(this DateTime dt)

参数:

  • dt: 待处理的 DateTime

返回值:

  • 季度第一天的 DateTime

示例:

DateTime dt = new DateTime(2024, 5, 15);
DateTime firstDay = dt.GetFirstDayOfQuarter(); // 2024-04-01

获取 DateTime 所在季度的最后一天。

public static DateTime GetLastDayOfQuarter(this DateTime dt)

参数:

  • dt: 待处理的 DateTime

返回值:

  • 季度最后一天的 DateTime

示例:

DateTime dt = new DateTime(2024, 5, 15);
DateTime lastDay = dt.GetLastDayOfQuarter(); // 2024-06-30

提供 DateTime 与 Unix 时间戳之间的相互转换。

将 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(); // 1704067200

将 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(); // 1704067200000

将 Unix 时间戳(秒)转换为 DateTime。

public static DateTime FromUnixTimestamp(this long timestamp)

参数:

  • timestamp: Unix 时间戳(秒)

返回值:

  • 本地时间的 DateTime

示例:

long timestamp = 1704067200;
DateTime dt = timestamp.FromUnixTimestamp();

将 Unix 时间戳(毫秒)转换为 DateTime。

public static DateTime FromUnixTimestampMs(this long timestampMs)

参数:

  • timestampMs: Unix 时间戳(毫秒)

返回值:

  • 本地时间的 DateTime

示例:

long timestampMs = 1704067200000;
DateTime dt = timestampMs.FromUnixTimestampMs();

将 DateTime 转换为本地时间。

public static DateTime ToLocalTimeSafe(this DateTime dt)

参数:

  • dt: 待转换的 DateTime

返回值:

  • 本地时间的 DateTime

示例:

DateTime utcTime = DateTime.UtcNow;
DateTime localTime = utcTime.ToLocalTimeSafe();

将 DateTime 转换为 UTC 时间。

public static DateTime ToUtcTimeSafe(this DateTime dt)

参数:

  • dt: 待转换的 DateTime

返回值:

  • UTC 时间的 DateTime

示例:

DateTime localTime = DateTime.Now;
DateTime utcTime = localTime.ToUtcTimeSafe();

将 DateTime 转换为指定时区的时间。

public static DateTime ToTimeZone(this DateTime dt, string timeZoneId)

参数:

  • dt: 待转换的 DateTime
  • timeZoneId: 时区标识,如 “China Standard Time”、“Pacific Standard Time”

返回值:

  • 指定时区的 DateTime

异常:

  • TimeZoneNotFoundException: 时区标识无效时抛出

示例:

DateTime dt = DateTime.UtcNow;
DateTime chinaTime = dt.ToTimeZone("China Standard Time");

将 DateTime 转换为 DateTimeOffset。

public static DateTimeOffset ToDateTimeOffset(this DateTime dt)

参数:

  • dt: 待转换的 DateTime

返回值:

  • DateTimeOffset 对象

示例:

DateTime dt = DateTime.Now;
DateTimeOffset dto = dt.ToDateTimeOffset();

提供日期时间到各种格式字符串的转换。

将 DateTime 格式化为指定格式的字符串。

public static string ToFormatString(this DateTime dt, string format = "yyyy-MM-dd HH:mm:ss")

参数:

  • dt: 待格式化的 DateTime
  • format: 格式字符串,默认为 “yyyy-MM-dd HH:mm:ss”

返回值:

  • 格式化后的日期时间字符串

示例:

DateTime dt = DateTime.Now;
string result = dt.ToFormatString("yyyy年MM月dd日 HH:mm:ss");

将 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();

将 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();

将 DateTime 转换为中文日期字符串。

public static string ToChineseDateString(this DateTime dt)

参数:

  • dt: 待格式化的 DateTime

返回值:

  • 中文日期字符串(如 “2024年01月15日”)

示例:

DateTime dt = DateTime.Now;
string result = dt.ToChineseDateString(); // "2024年01月15日"

将 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分"

将 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"

将 DateTime 转换为精确到毫秒的时间戳字符串。

public static string ToCustomTimestamp(this DateTime dt)

参数:

  • dt: 待格式化的 DateTime

返回值:

  • 时间戳字符串(如 “20240115143000123”)

示例:

DateTime dt = DateTime.Now;
string result = dt.ToCustomTimestamp(); // "20240115143000123"

将 DateTime 转换为日期字符串。

public static string ToDateString(this DateTime dt)

参数:

  • dt: 待格式化的 DateTime

返回值:

  • 日期字符串(如 “2024-01-15”)

示例:

DateTime dt = DateTime.Now;
string result = dt.ToDateString(); // "2024-01-15"

将 DateTime 转换为时间字符串。

public static string ToTimeString(this DateTime dt)

参数:

  • dt: 待格式化的 DateTime

返回值:

  • 时间字符串(如 “14:30:00”)

示例:

DateTime dt = DateTime.Now;
string result = dt.ToTimeString(); // "14:30:00"

将 DateTime 转换为短时间字符串。

public static string ToShortTimeString(this DateTime dt)

参数:

  • dt: 待格式化的 DateTime

返回值:

  • 短时间字符串(如 “14:30”)

示例:

DateTime dt = DateTime.Now;
string result = dt.ToShortTimeString(); // "14:30"

将 DateTime 转换为星期中文名称。

public static string ToChineseWeekday(this DateTime dt)

参数:

  • dt: 待格式化的 DateTime

返回值:

  • 星期中文名称(如 “星期一”)

示例:

DateTime dt = DateTime.Now;
string result = dt.ToChineseWeekday(); // "星期一"

将 DateTime 转换为星期英文名称。

public static string ToEnglishWeekday(this DateTime dt)

参数:

  • dt: 待格式化的 DateTime

返回值:

  • 星期英文名称(如 “Monday”)

示例:

DateTime dt = DateTime.Now;
string result = dt.ToEnglishWeekday(); // "Monday"

将 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(); // 1

提供日期时间加减和时间差计算功能。

安全地增加指定天数。

public static DateTime AddDaysSafe(this DateTime dt, double days)

参数:

  • dt: 原始 DateTime
  • days: 要增加的天数,可为负数

返回值:

  • 增加天数后的 DateTime

示例:

DateTime dt = DateTime.Now;
DateTime result = dt.AddDaysSafe(7);

安全地增加指定小时数。

public static DateTime AddHoursSafe(this DateTime dt, double hours)

参数:

  • dt: 原始 DateTime
  • hours: 要增加的小时数,可为负数

返回值:

  • 增加小时数后的 DateTime

示例:

DateTime dt = DateTime.Now;
DateTime result = dt.AddHoursSafe(2);

安全地增加指定分钟数。

public static DateTime AddMinutesSafe(this DateTime dt, double minutes)

参数:

  • dt: 原始 DateTime
  • minutes: 要增加的分钟数,可为负数

返回值:

  • 增加分钟数后的 DateTime

示例:

DateTime dt = DateTime.Now;
DateTime result = dt.AddMinutesSafe(30);

安全地增加指定秒数。

public static DateTime AddSecondsSafe(this DateTime dt, double seconds)

参数:

  • dt: 原始 DateTime
  • seconds: 要增加的秒数,可为负数

返回值:

  • 增加秒数后的 DateTime

示例:

DateTime dt = DateTime.Now;
DateTime result = dt.AddSecondsSafe(60);

安全地增加指定月份数。

public static DateTime AddMonthsSafe(this DateTime dt, int months)

参数:

  • dt: 原始 DateTime
  • months: 要增加的月份数,可为负数

返回值:

  • 增加月份数后的 DateTime

示例:

DateTime dt = DateTime.Now;
DateTime result = dt.AddMonthsSafe(3);

安全地增加指定年份数。

public static DateTime AddYearsSafe(this DateTime dt, int years)

参数:

  • dt: 原始 DateTime
  • years: 要增加的年份数,可为负数

返回值:

  • 增加年份数后的 DateTime

示例:

DateTime dt = DateTime.Now;
DateTime result = dt.AddYearsSafe(1);

安全地增加指定工作日数(跳过周末)。

public static DateTime AddWorkDays(this DateTime dt, int workDays)

参数:

  • dt: 原始 DateTime
  • workDays: 要增加的工作日数,可为负数

返回值:

  • 增加工作日数后的 DateTime

示例:

DateTime dt = new DateTime(2024, 1, 5); // 周五
DateTime result = dt.AddWorkDays(1); // 返回下周一
DateTime result2 = dt.AddWorkDays(5); // 下周五

获取两个 DateTime 之间的天数差。

public static double DaysBetween(this DateTime dt, DateTime other)

参数:

  • dt: 起始 DateTime
  • other: 结束 DateTime

返回值:

  • 两个日期之间的天数差的绝对值

示例:

DateTime dt1 = new DateTime(2024, 1, 1);
DateTime dt2 = new DateTime(2024, 1, 10);
double days = dt1.DaysBetween(dt2); // 9

获取两个 DateTime 之间的小时差。

public static double HoursBetween(this DateTime dt, DateTime other)

参数:

  • dt: 起始 DateTime
  • other: 结束 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.5

获取两个 DateTime 之间的分钟差。

public static double MinutesBetween(this DateTime dt, DateTime other)

参数:

  • dt: 起始 DateTime
  • other: 结束 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); // 30

获取两个 DateTime 之间的秒数差。

public static double SecondsBetween(this DateTime dt, DateTime other)

参数:

  • dt: 起始 DateTime
  • other: 结束 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); // 45

获取两个 DateTime 之间的时间间隔。

public static TimeSpan SpanBetween(this DateTime dt, DateTime other)

参数:

  • dt: 起始 DateTime
  • other: 结束 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(); // 返回当前年龄

提供时间比较和范围判断功能。

判断 DateTime 是否在指定范围内(包含边界)。

public static bool IsBetween(this DateTime dt, DateTime start, DateTime end)

参数:

  • dt: 待判断的 DateTime
  • start: 起始时间
  • 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); // true

判断 DateTime 是否早于指定时间。

public static bool IsBefore(this DateTime dt, DateTime other)

参数:

  • dt: 待判断的 DateTime
  • other: 比较的时间

返回值:

  • 如果早于指定时间返回 true;否则返回 false

示例:

DateTime dt = new DateTime(2024, 1, 1);
DateTime other = new DateTime(2024, 6, 1);
bool result = dt.IsBefore(other); // true

判断 DateTime 是否晚于指定时间。

public static bool IsAfter(this DateTime dt, DateTime other)

参数:

  • dt: 待判断的 DateTime
  • other: 比较的时间

返回值:

  • 如果晚于指定时间返回 true;否则返回 false

示例:

DateTime dt = new DateTime(2024, 6, 1);
DateTime other = new DateTime(2024, 1, 1);
bool result = dt.IsAfter(other); // true

提供获取时间范围的功能。

获取当天的开始时间(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:00

获取当天的结束时间(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.9999999

获取当周的第一天(周一)。

public static DateTime GetStartOfWeek(this DateTime dt, DayOfWeek startOfWeek = DayOfWeek.Monday)

参数:

  • dt: 待处理的 DateTime
  • startOfWeek: 每周的第一天,默认为周一

返回值:

  • 当周第一天的日期

示例:

DateTime dt = new DateTime(2024, 1, 17); // 周三
DateTime start = dt.GetStartOfWeek(); // 2024-01-15 (周一)

获取当周的最后一天(周日)。

public static DateTime GetEndOfWeek(this DateTime dt, DayOfWeek startOfWeek = DayOfWeek.Monday)

参数:

  • dt: 待处理的 DateTime
  • startOfWeek: 每周的第一天,默认为周一

返回值:

  • 当周最后一天的日期

示例:

DateTime dt = new DateTime(2024, 1, 17); // 周三
DateTime end = dt.GetEndOfWeek(); // 2024-01-21 (周日)

获取当月的第一天。

public static DateTime GetStartOfMonth(this DateTime dt)

参数:

  • dt: 待处理的 DateTime

返回值:

  • 当月第一天的日期

示例:

DateTime dt = new DateTime(2024, 1, 15);
DateTime start = dt.GetStartOfMonth(); // 2024-01-01

获取当月的最后一天。

public static DateTime GetEndOfMonth(this DateTime dt)

参数:

  • dt: 待处理的 DateTime

返回值:

  • 当月最后一天的日期

示例:

DateTime dt = new DateTime(2024, 1, 15);
DateTime end = dt.GetEndOfMonth(); // 2024-01-31

获取当年的第一天。

public static DateTime GetStartOfYear(this DateTime dt)

参数:

  • dt: 待处理的 DateTime

返回值:

  • 当年第一天的日期

示例:

DateTime dt = DateTime.Now;
DateTime start = dt.GetStartOfYear(); // 2024-01-01

获取当年的最后一天。

public static DateTime GetEndOfYear(this DateTime dt)

参数:

  • dt: 待处理的 DateTime

返回值:

  • 当年最后一天的日期

示例:

DateTime dt = DateTime.Now;
DateTime end = dt.GetEndOfYear(); // 2024-12-31

提供农历转换、友好显示等特殊功能。

将 DateTime 转换为农历日期字符串。

public static string ToChineseLunarDate(this DateTime dt)

参数:

  • dt: 待格式化的 DateTime

返回值:

  • 农历日期字符串(如 “正月初一”)

示例:

DateTime dt = new DateTime(2024, 1, 15);
string result = dt.ToChineseLunarDate(); // 农历日期

将 DateTime 转换为友好时间描述。

public static string ToFriendlyString(this DateTime dt)

参数:

  • dt: 待处理的 DateTime

返回值:

  • 友好时间描述(如 “刚刚”、“5分钟前”、“昨天”、“3天前”)

示例:

DateTime dt = DateTime.Now.AddMinutes(-5);
string result = dt.ToFriendlyString(); // "5分钟前"

将 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日"

将 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.0

提供 DateTime 与 DateOnly/TimeOnly 之间的转换功能。

将 DateTime 转换为 DateOnly。

public static DateOnly ToDateOnly(this DateTime dt)

参数:

  • dt: 待转换的 DateTime

返回值:

  • DateOnly 对象

示例:

DateTime dt = DateTime.Now;
DateOnly date = dt.ToDateOnly();

将 DateTime 转换为 TimeOnly。

public static TimeOnly ToTimeOnly(this DateTime dt)

参数:

  • dt: 待转换的 DateTime

返回值:

  • TimeOnly 对象

示例:

DateTime dt = DateTime.Now;
TimeOnly time = dt.ToTimeOnly();

  1. 时间格式化 - 将 DateTime 转换为各种指定格式的字符串显示
  2. 时间计算 - 计算时间差、增加时间等操作
  3. 国际化显示 - 支持中文、英文等多种语言的时间表示
  4. 时区转换 - 处理不同时区之间的时间转换
  5. 用户友好显示 - 提供友好的时间显示(如”刚刚”、“5分钟前”)
  6. 数据解析 - 时间戳转换到系统日期数据
  7. 报表生成 - 生成指定格式的时间报告
  8. 业务逻辑 - 判断工作日、周末、节假日等业务时间逻辑

  1. 所有方法都是扩展方法,需要通过 DateTime 实例调用
  2. 大部分方法对边界进行了安全处理,不会抛出异常
  3. 时间戳转换使用 DateTimeOffset 实现,确保时区准确
  4. 农历转换支持中国农历,需要引用 System.Globalization.ChineseLunisolarCalendar
  5. 友好时间描述基于当前时间计算,不适合处理过去很久的时间
  6. 年龄计算考虑了月份和日期,结果准确
  7. 时区转换需要系统支持相应时区标识
  8. 部分方法如 ToDateOnly、ToTimeOnly 需要 .NET 6+ 版本支持