ESBasic 可复用的.NET类库(01) -- 时刻 Sho

系统 1422 0

(如果您能对照着源码来阅读本文,效果会更好。)

1. 缘起:

假设我们的员工打卡系统,需要设定公司规定的上班时间、下班时间、以及还要对员工是否迟到早退等这些情况进行判断。

我们以什么方式来记录类似上下班时间这样只有时分秒没有年月日的时间了?你说可以使用 DateTime ,但是合适吗?总是觉得用 DateTime 来表示上下班的时间很别扭,因为我们的上下班时间并需要指定到具体的哪一天啊。

我设计了 ESBasic.ShortTime 来对类似上下班时间的概念进行抽象。 ShortTime 只有时分秒三个必需的属性,不必再牵扯到日期。

ShortTime 的形象示意图如下:

Hour

Minute

Second

2. 适用场合:

任何只需要使用时分秒来表示时刻的场合。

3 .设计思想与实现

ShortTime 的设计与实现都是相当简单的,其类图如下:
ESBasic 可复用的.NET类库(01) -- 时刻 ShortTime
ShortTime
Hour Minute Second 三个属性, Hour 采用 24 小时制,取值范围为 0~23 Minute Second 的取值范围都是 0~59 。如果在设置这些属性的值超过了其自身的取值范围,属性的 set 方法会自动将其修正到正确的值。

ShortTime 实现了 IComparable 泛型接口,表示 ShortTime 对象之间可以相互比较。 ShortTime 所表示的时刻的值越大,则 ShortTime 就越大,这是完全一致的。

ShortTime 是可序列化的,表示可以通过 Remoting 进行远程传递。

ShortTime 提供了一个非常有用的方法 IsOnTime ,用于判断是否到了指定的时刻。该方法接受两个参数: target maxToleranceInSecs target 即是与当前对象进行比较的目标, maxToleranceInSecs 表示认为当前对象与 target 所表示的时间是同一时刻所允许的最大误差(单位为秒)。比如, maxToleranceInSecs 取值为 3 秒,那么 22:15:00 22:15:02 就被认为是同一时刻, IsOnTime 方法将返回 true

4. 使用时的注意事项

1 ShortTime 的精度只能到秒,不能记录毫秒、微秒等更小的精度。

2 IsOnTime 方法的 maxToleranceInSecs 参数的取值是由我们的系统需求所能允许的最大时刻误差来决定了。比如,你的轮询引擎是每隔 5 秒钟检测一次是否到了指定的时刻,那么在这种情况下 maxToleranceInSecs 参数就应该设置为 5 ,而不是更大或更小。

5. 扩展

我们可以将表示上班时间的 ShortTime 对象和表示下班时间的 ShortTime 对象组合成一个 ShortTimeScope 对象,用于表示工作时间。

ESBasic. ShortTimeScope 用来表示一个时间范围,当然,这个范围的最大长度为 24 小时(更准确的应该是 23 小时 59 59 秒),也就是说, ShortTimeScope 不能表示跨天的时间段。

如果我们要判断某一时刻是否在 ShortTimeScope 指定的时间范围内,可以调用 ShortTimeScope Contains 方法。

ShortTimeScope 对象之间很难进行比较大小,但是可以比较是否相等,所以 ShortTimeScope 实现了“ == ”操作符。

另外,在我们后面介绍的 CircleTaskSwitcher (循环任务切换器),它的实现也用到了本节讲到的 ShortTime

注:ESBasic源码可到 http://esbasic.codeplex.com/ 下载。

ESBasic 可复用的.NET类库(01) -- 时刻 ShortTime


更多文章、技术交流、商务合作、联系博主

微信扫码或搜索:z360901061

微信扫一扫加我为好友

QQ号联系: 360901061

您的支持是博主写作最大的动力,如果您喜欢我的文章,感觉我的文章对您有帮助,请用微信扫描下面二维码支持博主2元、5元、10元、20元等您想捐的金额吧,狠狠点击下面给点支持吧,站长非常感激您!手机微信长按不能支付解决办法:请将微信支付二维码保存到相册,切换到微信,然后点击微信右上角扫一扫功能,选择支付二维码完成支付。

【本文对您有帮助就好】

您的支持是博主写作最大的动力,如果您喜欢我的文章,感觉我的文章对您有帮助,请用微信扫描上面二维码支持博主2元、5元、10元、自定义金额等您想捐的金额吧,站长会非常 感谢您的哦!!!

发表我的评论
最新评论 总共0条评论