1.DateOf、ToDayAt、TomorrowAt
DateOf：指定年月日时分秒
public static DateTimeOffset DateOf(int hour, int minute, int second)
{
ValidateSecond(second);
ValidateMinute(minute);
ValidateHour(hour); DateTimeOffset c = SystemTime.Now();
DateTime dt = new DateTime(c.Year, c.Month, c.Day, hour, minute, second);
return new DateTimeOffset(dt, TimeZoneUtil.GetUtcOffset(dt, TimeZoneInfo.Local));
} public static DateTimeOffset DateOf(int hour, int minute, int second,
int dayOfMonth, int month)
{
ValidateSecond(second);
ValidateMinute(minute);
ValidateHour(hour);
ValidateDayOfMonth(dayOfMonth);
ValidateMonth(month); DateTimeOffset c = SystemTime.Now();
DateTime dt = new DateTime(c.Year, month, dayOfMonth, hour, minute, second);
return new DateTimeOffset(dt, TimeZoneUtil.GetUtcOffset(dt, TimeZoneInfo.Local));
} public static DateTimeOffset DateOf(int hour, int minute, int second,
int dayOfMonth, int month, int year)
{
ValidateSecond(second);
ValidateMinute(minute);
ValidateHour(hour);
ValidateDayOfMonth(dayOfMonth);
ValidateMonth(month);
ValidateYear(year); DateTime dt = new DateTime(year, month, dayOfMonth, hour, minute, second);
return new DateTimeOffset(dt, TimeZoneUtil.GetUtcOffset(dt, TimeZoneInfo.Local));
}
TodayAt:DateOf的一个封装
public static DateTimeOffset TodayAt(int hour, int minute, int second)
{
return DateOf(hour, minute, second);
}
TomorrowAt:AddDays的一次操作
public static DateTimeOffset TomorrowAt(int hour, int minute, int second)
{
ValidateSecond(second);
ValidateMinute(minute);
ValidateHour(hour); DateTimeOffset now = DateTimeOffset.Now;
DateTimeOffset c = new DateTimeOffset(
now.Year,
now.Month,
now.Day,
hour,
minute,
second,
,
now.Offset); // advance one day
c = c.AddDays(); return c;
}
2.EvenHourDate、EvenHourDateAfterNow、EvenHourDateBefore
小时四舍五入操作
EvenHourDate：AddHours（1）操作，分、秒抹零操作 比如8:12变成9:00
/// <summary>
/// Returns a date that is rounded to the next even hour above the given date.
/// </summary>
/// <remarks>
/// For example an input date with a time of 08:13:54 would result in a date
/// with the time of 09:00:00. If the date's time is in the 23rd hour, the
/// date's 'day' will be promoted, and the time will be set to 00:00:00.
/// </remarks>
/// <param name="date">the Date to round, if <see langword="null" /> the current time will
/// be used</param>
/// <returns>the new rounded date</returns>
public static DateTimeOffset EvenHourDate(DateTimeOffset? date)
{
if (!date.HasValue)
{
date = SystemTime.Now();
}
DateTimeOffset d = date.Value.AddHours();
return new DateTimeOffset(d.Year, d.Month, d.Day, d.Hour, , , d.Offset);
}
EvenHourDateAfterNow：当前时间加一小时，EvenHourDate(null)的封装
EvenHourDateBefore：分秒抹零操作
/// <summary>
/// Returns a date that is rounded to the previous even hour below the given date.
/// </summary>
/// <remarks>
/// For example an input date with a time of 08:13:54 would result in a date
/// with the time of 08:00:00.
/// </remarks>
/// <param name="date">the Date to round, if <see langword="null" /> the current time will
/// be used</param>
/// <returns>the new rounded date</returns>
public static DateTimeOffset EvenHourDateBefore(DateTimeOffset? date)
{
if (!date.HasValue)
{
date = SystemTime.Now();
}
return new DateTimeOffset(date.Value.Year, date.Value.Month, date.Value.Day, date.Value.Hour, , , date.Value.Offset);
}
3.EvenMinuteDate、EvenMinuteDateAfterNow、EvenMinuteDateBefore
分钟操作，和前面的小时操作方法差不多
EvenMinuteDate:AddMinutes(1)操作
EvenMinuteDateAfterNow:DateTimeOffset.Now.AddMinutes(1)操作
EvenMinuteDateBefore:分钟抹零操作
4.EvenSecondDate、EvenSecondDateAfterNow、EvenSecondDateBefore
分钟操作，和前面的小时和分钟操作方法差不多
EvenSecondDate:AddSeconds(1)操作
EvenSecondDateAfterNow:DateTimeOffset.Now.AddSeconds(1)操作
EvenSecondDateBefore:秒钟抹零操作
5.NextGivenMinuteDate、NextGivenSecondDate
返回一个日期，该日期四舍五入到给定分秒的下一个偶数倍。
NextGivenMinuteDate
public static DateTimeOffset NextGivenMinuteDate(DateTimeOffset? date, int minuteBase)
{
if (minuteBase < || minuteBase > )
{
throw new ArgumentException("minuteBase must be >=0 and <= 59");
} DateTimeOffset c = date ?? SystemTime.Now(); if (minuteBase == )
{
return new DateTimeOffset(c.Year, c.Month, c.Day, c.Hour, , , , c.Offset).AddHours();
} int minute = c.Minute; int arItr = minute/minuteBase; int nextMinuteOccurance = minuteBase*(arItr + ); if (nextMinuteOccurance < )
{
return new DateTimeOffset(c.Year, c.Month, c.Day, c.Hour, nextMinuteOccurance, , , c.Offset);
}
return new DateTimeOffset(c.Year, c.Month, c.Day, c.Hour, , , , c.Offset).AddHours();
}
NextGivenSecondDate
public static DateTimeOffset NextGivenSecondDate(DateTimeOffset? date, int secondBase)
{
if (secondBase < || secondBase > )
{
throw new ArgumentException("secondBase must be >=0 and <= 59");
} DateTimeOffset c = date ?? SystemTime.Now(); if (secondBase == )
{
return new DateTimeOffset(c.Year, c.Month, c.Day, c.Hour, c.Minute, , , c.Offset).AddMinutes();
} int second = c.Second; int arItr = second/secondBase; int nextSecondOccurance = secondBase*(arItr + ); if (nextSecondOccurance < )
{
return new DateTimeOffset(c.Year, c.Month, c.Day, c.Hour, c.Minute, nextSecondOccurance, , c.Offset);
}
return new DateTimeOffset(c.Year, c.Month, c.Day, c.Hour, c.Minute, , , c.Offset).AddMinutes();
}
6.FutureDate
指定年、月、周、日、时、分、秒加一操作
public static DateTimeOffset FutureDate(int interval, IntervalUnit unit)
{
return TranslatedAdd(SystemTime.Now(), unit, interval);
}
private static DateTimeOffset TranslatedAdd(DateTimeOffset date, IntervalUnit unit, int amountToAdd)
{
switch (unit)
{
case IntervalUnit.Day:
return date.AddDays(amountToAdd);
case IntervalUnit.Hour:
return date.AddHours(amountToAdd);
case IntervalUnit.Minute:
return date.AddMinutes(amountToAdd);
case IntervalUnit.Month:
return date.AddMonths(amountToAdd);
case IntervalUnit.Second:
return date.AddSeconds(amountToAdd);
case IntervalUnit.Millisecond:
return date.AddMilliseconds(amountToAdd);
case IntervalUnit.Week:
return date.AddDays(amountToAdd*);
case IntervalUnit.Year:
return date.AddYears(amountToAdd);
default:
throw new ArgumentException("Unknown IntervalUnit");
}
}
7.NewDate、NewDateInTimeZone、InMonth、InYear、InTimeZone、InMonthOnDay、AtMinute、AtSecond、AtHourMinuteAndSecond、OnDay
实例化DateBuilder指定年月日时分秒时区
public static DateBuilder NewDate()
{
return new DateBuilder();
} /// <summary>
/// Create a DateBuilder, with initial settings for the current date and time in the given timezone.
/// </summary>
/// <param name="tz">Time zone to use.</param>
/// <returns></returns>
public static DateBuilder NewDateInTimeZone(TimeZoneInfo tz)
{
return new DateBuilder(tz);
}
public class DateBuilder
{
private int month;
private int day;
private int year;
private int hour;
private int minute;
private int second;
private TimeZoneInfo tz; /// <summary>
/// Create a DateBuilder, with initial settings for the current date
/// and time in the system default timezone.
/// </summary>
private DateBuilder()
{
DateTime now = DateTime.Now; month = now.Month;
day = now.Day;
year = now.Year;
hour = now.Hour;
minute = now.Minute;
second = now.Second;
} /// <summary>
/// Create a DateBuilder, with initial settings for the current date and time in the given timezone.
/// </summary>
/// <param name="tz"></param>
private DateBuilder(TimeZoneInfo tz)
{
DateTime now = DateTime.Now; month = now.Month;
day = now.Day;
year = now.Year;
hour = now.Hour;
minute = now.Minute;
second = now.Second; this.tz = tz;
}
}
8.ValidateYear、ValidateMonth、ValidateDay、ValidateHour、ValidateMinute、ValidateSecond
验证年月日时分秒
public static void ValidateHour(int hour)
{
if (hour < || hour > )
{
throw new ArgumentException("Invalid hour (must be >= 0 and <= 23).");
}
} public static void ValidateMinute(int minute)
{
if (minute < || minute > )
{
throw new ArgumentException("Invalid minute (must be >= 0 and <= 59).");
}
} public static void ValidateSecond(int second)
{
if (second < || second > )
{
throw new ArgumentException("Invalid second (must be >= 0 and <= 59).");
}
} public static void ValidateDayOfMonth(int day)
{
if (day < || day > )
{
throw new ArgumentException("Invalid day of month.");
}
} public static void ValidateMonth(int month)
{
if (month < || month > )
{
throw new ArgumentException("Invalid month (must be >= 1 and <= 12).");
}
} public static void ValidateYear(int year)
{
if (year < || year > )
{
throw new ArgumentException("Invalid year (must be >= 1970 and <= 2099).");
}
}
9.Build
生成DateTimeOffset
public DateTimeOffset Build()
{
DateTime dt = new DateTime(year, month, day, hour, minute, second);
TimeSpan offset = TimeZoneUtil.GetUtcOffset(dt, tz ?? TimeZoneInfo.Local);
return new DateTimeOffset(dt, offset);
}