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

简介:         (如果您能对照着源码来阅读本文,效果会更好。) 1.缘起:        假设我们的员工打卡系统,需要设定公司规定的上班时间、下班时间、以及还要对员工是否迟到早退等这些情况进行判断。

 

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

1.缘起:

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

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

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

       ShortTime的形象示意图如下:

Hour

Minute

Second

 

2.适用场合:

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

 

3.设计思想与实现

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

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

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

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

 

4. 使用时的注意事项

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

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

 

5.扩展

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

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

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

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

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

注:ESBasic已经开源,点击这里下载源码。
    ESBasic开源前言

 

目录
相关文章
|
IDE API 开发工具
拦截|篡改|伪造.NET类库中不限于public的类和方法
本文除了回顾拦截.NET类库中的方法,实现方法参数的篡改、方法返回结果的伪造,再着重介绍.NET类库中非public类及方法如何拦截。
拦截|篡改|伪造.NET类库中不限于public的类和方法
|
3月前
|
开发框架 .NET Linux
2款高效的.NET二维码生成类库
2款高效的.NET二维码生成类库
|
3月前
|
XML 开发框架 数据格式
.Net Core 开发框架,支持多版本的类库
.Net Core 开发框架,支持多版本的类库
56 0
|
4月前
|
人工智能 开发框架 Devops
.NET技术概览:** 本文探讨了.NET的核心特性,包括多语言支持、Common Language Runtime、丰富的类库和跨平台能力,强调其在企业级、Web、移动及游戏开发中的应用。
【7月更文挑战第4天】.NET技术概览:** 本文探讨了.NET的核心特性,包括多语言支持、Common Language Runtime、丰富的类库和跨平台能力,强调其在企业级、Web、移动及游戏开发中的应用。此外,讨论了.NET如何通过性能优化、DevOps集成、AI与ML支持以及开源策略应对未来挑战,为开发者提供强大工具,共创软件开发新篇章。
51 3
|
4月前
|
人工智能 前端开发 Devops
NET技术在现代开发中的影响力日益增强,本文聚焦其核心价值,如多语言支持、强大的Visual Studio工具、丰富的类库和跨平台能力。
【7月更文挑战第4天】**.NET技术在现代开发中的影响力日益增强,本文聚焦其核心价值,如多语言支持、强大的Visual Studio工具、丰富的类库和跨平台能力。实际应用涵盖企业系统、Web、移动和游戏开发,以及云服务。面对性能挑战、容器化、AI集成及跨平台竞争,.NET持续创新,开发者应关注技术趋势,提升技能,并参与社区,共同推进技术发展。**
37 1
|
4月前
|
开发框架 .NET API
.NET Core 和 .NET 标准类库项目类型有什么区别?
在 Visual Studio 中,可创建三种类库:.NET Framework、.NET Standard 和 .NET Core。.NET Standard 是规范,确保跨.NET实现的API一致性,适用于代码共享。.NET Framework 用于特定技术,如旧版支持。.NET Core 库允许访问更多API但限制兼容性。选择取决于兼容性和所需API:需要广泛兼容性时用.NET Standard,需要更多API时用.NET Core。.NET Standard 替代了 PCL,促进多平台共享代码。
|
6月前
|
C# 数据安全/隐私保护
一款实用的.NET Core加密解密工具类库
一款实用的.NET Core加密解密工具类库
|
11月前
|
存储 文字识别 C#
一个基于百度飞桨封装的.NET版本OCR工具类库 - PaddleOCRSharp
一个基于百度飞桨封装的.NET版本OCR工具类库 - PaddleOCRSharp
400 0
|
存储 安全 API
10分钟学会Visual Studio将自己创建的类库打包到NuGet进行引用(net,net core,C#)
10分钟学会Visual Studio将自己创建的类库打包到NuGet进行引用(net,net core,C#)
|
XML .NET C#
.NET Framework 类库——C#命名空间大全
引用地址:https://msdn.microsoft.com/zh-cn/library/gg145045.aspx C# using引用时,不知道有哪些命名空间,这下转载收集一篇,方面查找使用。
1178 0