第二节：比较DateTime和DateTimeOffset两种时间类型并介绍Quartz.Net中用到的几类时间形式(定点、四舍五入、倍数、递增)

一. 时间的类型

1. 背景

　　这里为什么要介绍时间类型呢，明明是定时调度篇，原因是在定时任务中，任务什么时间开始执行，什么时间结束执行，要用到各种各样的时间模式，虽然这不能算是一个复杂的问题，但在正式介绍Quartz.Net之前，还是很有必要补充一下的，该章节就是解决这类问题的。

2. 时间类型

　　时间类型主要有两类：DateTime和DateTimeOffset

(详情参考：https://docs.microsoft.com/zh-cn/dotnet/standard/datetime/choosing-between-datetime)

(1). DateTime：表示的时区有限，国内采用这个时间。

(2). DateTimeOffset：可以表示任何时区，通过偏移量来控制。（Quartz中提供DateBuilder类来实现DateTimeOffset类型）

3. 类型转换

(1). DateTime→DateTimeOffset 利用DateTimeOffset的构造函数

(2). DateTimeOffset→DateTime 利用Convert.ToDateTime方法

下面分享一段两种类型相互转换的代码：

1 // DateTime类型
2 DateTime date1 = DateTime.Parse("2018-01-01 11:45:30");
3 //DateTimeOffset类型
4 DateTimeOffset date3 = DateBuilder.DateOf(11, 45, 30, 1, 1, 2018);
5 //1. DateTime 转换成 DateTimeOffset
6 DateTimeOffset date16 = new DateTimeOffset(date1, TimeSpan.Zero);
7 //2. DateTimeOffset 转换成 DateTime
8 DateTime date17 = Convert.ToDateTime(date3);

二. 各种模式的表示

(一). 定点模式

1. 需求：

　　a. 2018-01-01 11:45:30

　　b. 01-01 1:45:30

　　c. 1:45:30

2. 解决方案

(1). DateTime类

　　a. 利用DateTime.Parse()进行转换，如：DateTime.Parse("2018-01-01 11:45:30");

　　b. 利用DateTime类丰富的构造函数来执行, 如：new DateTime(2018, 1, 1, 11, 45, 30);

(2). DateTimeOffset类

　　a. 利用DateBuilder.DateOf()进行转换，如：DateBuilder.DateOf(11, 45, 30, 1, 1, 2018);

　　b. 利用DateTimeOffset类丰富的构造函数来执行, 如： new DateTimeOffset(2018, 1, 1, 11, 45, 30, TimeSpan.Zero);

　　c. 另外,DateBuilder类还提供 TodayAt和TomorrowAt类，便于在当前年月日的基础上进行处理

代码分享：

1             DateTime date1 = DateTime.Parse("2018-01-01 11:45:30");
2             DateTime date2 = new DateTime(2018, 1, 1, 11, 45, 30);
3             DateTimeOffset date3 = DateBuilder.DateOf(11, 45, 30, 1, 1, 2018);
4             DateTimeOffset date4 = new DateTimeOffset(2018, 1, 1, 11, 45, 30, TimeSpan.Zero);
5             //默认为当前年月日
6             DateTimeOffset date5 = DateBuilder.TodayAt(1, 45, 30);
7             //默认为当前年月日的基础上 + 1天
8             DateTimeOffset date6 = DateBuilder.TomorrowAt(1, 45, 30);

(二). 四舍五入的模式

1. 需求：1:45:30 → 2:00:00

　　　　　　　　→ 1:00:00

2. 解决方案：

　　(1).DateBuilder.EvenHourDate 在小时的基础上进行“入”

　　(2).DateBuilder.EvenHourDateBefore 在小时的基础上进行“舍”

　　(3).另外在分钟的基础上进行入和舍有： EvenMinuteDate和EvenMinuteDateBefore

　　在秒钟的基础上进行入和舍有： EvenSecondDate和EvenSecondDateBefore

代码分享：

1 DateTimeOffset date5 = DateBuilder.TodayAt(1, 45, 30);
2 DateTimeOffset date7 = DateBuilder.EvenHourDate(date5);           //当前年月日下：2:00:00
3 DateTimeOffset date8 = DateBuilder.EvenHourDateBefore(date5);     //当前年月日下：1:00:00

(三). 倍数模式(不常用)

1. 包括：NextGivenMinuteDate和NextGivenSecondDate

　　以NextGivenMinuteDate为例，说明它的用法，NextGivenSecondDate与他类似

　　查看源码：public static DateTimeOffset NextGivenMinuteDate(DateTimeOffset? date, int minuteBase);

第一个参数：可以为空，也可以指定时间

第二个参数：把一个小时按minuteBase分钟进行划分，也就是60/minuteBase等份，真正的运行时间所在区间的下一个minuteBase分钟运行，

(PS：比如minuteBase=20，那么就是将分钟划分为3等分，分别是：20、40、60, 比如现在分钟是在 0-19分59秒，任何一个都会变为 20分00秒)

2. 用法：第一个参数为空的话，取的是当前时间为依据。

　　　　第一个参数有值的话，是以第一个参数为依据。

代码分享：

//以当前时间为依据，假设当前时间为：14:43:29   d9=14:50:00    d10=15:00:00           
DateTimeOffset d9 = DateBuilder.NextGivenMinuteDate(null, 10);   
DateTimeOffset d10 = DateBuilder.NextGivenMinuteDate(null, 20);  
 //以第一个参数为依据
DateTimeOffset date9 = DateBuilder.NextGivenMinuteDate(DateBuilder.TodayAt(1, 45, 30), 10);    //50分  秒数为0
DateTimeOffset date10 = DateBuilder.NextGivenMinuteDate(new DateTime(2018, 1, 1, 11, 25, 30), 20);  //40分 秒数为0

(四). 递增模式

1. 需求：解决在某个时间点上增加：秒、分、分钟、小时、或天、月等。

2. 解决方案：

　　利用DateTime类中的各种Add函数来解决。

　　常用方法有：AddSeconds、AddMinutes、AddHours、AddDays、AddMonths

代码分享：

1 DateTime date1 = DateTime.Parse("2018-01-01 11:45:30");
2 DateTime date11 = date1.AddSeconds(1);     //2018-01-01 11:45:31
3 DateTime date12 = date1.AddMinutes(1);     //2018-01-01 11:46:30
4 DateTime date13 = date1.AddHours(1);       //2018-01-01 12:45:30
5 DateTime date14 = date1.AddDays(1);        //2018-01-02 11:45:30
6 DateTime date15 = date1.AddMonths(1);      //2018-02-01 11:45:30

来源：oschina

链接：https://my.oschina.net/u/4356045/blog/4057623

标签

quartz.net

.Net Framework

quartz