日期 Date--ESBasic 可复用的.NET类库(02)

  1.缘起:

    同我们从DateTime中将时刻部分作为ShortTime抽离出来一样,我们将DateTime中的日期部分也抽离出来,以ESBasic.Date类来表示。

    比如,我们的报表系统是以“天”为单位来进行统计的,为了提高效率,我们会在每天凌晨将前一天的报表数据统计完毕,并存储到数据库中,一天的报表数据就对应数据库数据库中的一条记录,该记录以一个表示日期的整数而不是DateTime作为主键。比如主键值为20090501的表示这条记录对应的是2009年5月1日的报表数据。

假设我想查询2009-05-01到2009-05-07这7天的报表数据,就没有必要传入2009-05-01 00:00:00 和2009-05-07 23:59:59两个DateTime进去, 而只要传入两个Date类型的对象即可。

相比于DateTime,使用Date来表示日期在语义上会更加清晰。

DateTime的形象示意图如下:


Year


Month


Day

 

 2.适用场合:

       任何只需要使用年月日来表示日期的场合。

 

3.设计思想与实现

Date的设计与实现都是相当简单的,其类图如下:
      
      Date实现了IComparable泛型接口,表示Date对象之间可以相互比较。Date所表示的日期的值越大,则Date就越大。

Date提供一个接受DateTime类型的参数的构造函数,表示可以直接将一个DateTime转化为一个Date对象。

Date标记为可序列化,表示可以通过Remoting进行远程传递Date对象。

      ToDateInteger方法用于将日期转化为一个整数,正如缘起中提到的,对一个表示2009年5月1日的Date对象调用ToDateInteger方法会返回整数20090501,这个整数与示例数据库中对应记录的主键是相等的。

     如果一个Date所代表的日期越大,则其ToDateInteger方法返回的整数也越大。基于这一点,如果要查询上述数据库中的某日期范围内的报表记录,直接对主键值进行between…and的范围查询即可。

       AddDays方法表示在现在的日期上加上一定的天数然后返回得到的新日期。如果自己手动来实现这个方法,则要考虑很多例外情况,比如大小月份、闰年的2月等等,所以我直接借助现成的DateTime来实现这个方法。

     另外,Date类还有几个静态方法:ConvertFromDateInteger方法的作用刚好与ToDateInteger方法相反,用于将一个整数转化为一个Date对象。ConvertToDateInteger方法可以更方便地将一个DateTime的日期部分直接转化为一个整数。

 

4. 使用时的注意事项

(1)Date所代表的日期是以“一天”为递增的,是连续的,但是其ToDateInteger方法返回的整数虽然也是递增的,却是不连续的。比如20090531与20090601之间就差了70。

(2)Date有一个接受年、月、日三个整数的构造函数,该构造函数我没有手动去检测三个参数的合法性,而是借助了DateTime来做这件事情,如果三个参数的取值不合理,则会DateTime的构造会抛出异常。

        public Date(int y, int m, int d)
            : this(new DateTime(y, m, d)) //借助DateTime来验证参数的合法性
        {
        }

(3)Date类的Day属性的set方法,也是基于同(2)一样的考虑,借助DateTime来验证属性值的合法性。
 

5.扩展

我们可以将表示报表查询的起始日期的Date对象和表示结束日期的Date对象组合成一个ESBasic.DateScope对象,用于表示要查询的报表的日期范围。

如果我们要判断某个日期是否在DateScope指定的日期范围内,可以调用DateScope的Contains方法。

       DateScope对象之间很难进行比较大小,但是可以比较是否相等,所以DateScope实现了“==”操作符和覆盖的基类的Equals方法。

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

 

 

时间: 2024-10-27 13:54:22

日期 Date--ESBasic 可复用的.NET类库(02)的相关文章

ESBasic 可复用的.NET类库(00) -- 开源前言(附下载)

自从03年正式使用.NET开发以来,已经走过了6个年头,这期间我积累了几套类库和框架,ESBasic便是其中最基础的一个类库.ESBasic是Enterprise Service Basic的缩写,虽然也简写为ESB,但是它和Enterprise Service Bus(企业服务总线)没有任何关系.ESBasic是我能够快速和高效开发应用程序的利器之一,开这个专门的blog是想将它介绍给大家,希望能对大家有所启发. ESBasic覆盖的内容包括:对象管理.插件.网络(Socket).多线程.Em

优先级管理器 IPriorityManager -- ESBasic 可复用的.NET类库(14)

1.缘起:     假设我们的订单处理系统所要处理的订单是有优先级的,也就是说,不同的订单类型所要求被处理的紧迫程度不同,对那些优先级高的注单要先处理,对于优先级低的注单可稍后处理.对于处于同一优先级的订单了,就按照其到达的先后顺序进行处理.     这是一个典型的管理具有优先级的对象的需求,注单就是具有优先级(With Priority)的对象.我设计了ESBasic.ObjectManagement.Managers.IPriorityManager优先级管理器(确切地说,应该称之为"具有优

Round缓存管理器RoundCacheManager--ESBasic 可复用的.NET类库(26)

1.缘起:     在增量自动获取器章节的缘起部分,我们曾提到增量缓存,本节我们将深入探讨它以及用于管理增量缓存的管理器.我们还是以增量自动获取器章节提到的例子作为基础,并做更进一步的讨论.       OK,现在让我们开始这有趣的旅程. 首先,基于前面例子给出的上下文,我们知道IIncreaseAutoRetriever获取的增量是用于累积当天的已成交订单报表的."当天已成交报表"就是一个典型的增量缓存,每当有新的增量到来,都会累加到上面. 我们假设今天是2009.07.08,那么我

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

          (如果您能对照着源码来阅读本文,效果会更好.) 1.缘起:        假设我们的员工打卡系统,需要设定公司规定的上班时间.下班时间.以及还要对员工是否迟到早退等这些情况进行判断.        我们以什么方式来记录类似上下班时间这样只有时分秒没有年月日的时间了?你说可以使用DateTime,但是合适吗?总是觉得用DateTime来表示上下班的时间很别扭,因为我们的上下班时间并需要指定到具体的哪一天啊.        我设计了ESBasic.ShortTime来对类似上下班

循环任务切换器 CircleTaskSwitcher -- ESBasic 可复用的.NET类库(06)

 1.缘起:     假设我的订单处理系统有这样的需求:将一天24小时分为4个时段,凌晨2:15到8:30采用A类型的处理器处理接收到的订单,8:30到14:00采用B类型的处理器,14:00到20:00采用C类型的处理器,20:00到第二天凌晨2:15采用D类型的处理器.     即我们的订单处理器需要在任一天的2:15.8:30.14:00.20:00这四个时刻发生切换,这就是一个循环切换器所要做的工作.     我设计了ESBasic.Threading.Application. ICir

对象获取器IObjectRetriever -- ESBasic 可复用的.NET类库(17)

1.缘起: ESBasic中许多管理对象的容器都用到了这个ESBasic.ObjectManagement.IObjectRetriever接口,所以单独将其提出来介绍一下. 当我们向对象容器(Container)请求某个对象时,也许目标对象还未加载到容器中,这可能是因为容器在初始化的时候就没有加载这个对象,也有可能是因为这个对象是容器初始化以后新增到数据库(当然也有可能是其它的持久化存储)的.在这种情况下,对象容器就可以借助IObjectRetriever来将目标对象从数据库等持久化存储中加载

工作者引擎 IWorkerEngine -- ESBasic 可复用的.NET类库(05)

1.缘起:     假设我们的系统在运行的过程中,源源不断的有新的任务需要处理(比如订单处理),而且这些任务的处理是相互独立的,没有前后顺序依赖性(顺序依赖性是指,必须在任务A处理结束后才可开始B任务),那么我们就可以使用多个线程来同时处理多个任务.每个处理任务的线程称为"工作者(线程)".      我设计了ESBasic.Threading.Engines.IWorkerEngine工作者引擎,其目的就是使用多个线程来并行处理任务,提高系统的吞吐能力.       工作者引擎的形象

回调定时器ICallbackTimer --ESBasic 可复用的.NET类库(07)

 1.缘起:     举个例子也许就能够说清楚回调定时器的用途.假设我的订单系统接收各种不同类型的订单,当订单A进来时,系统根据订单的类型和其它特征进行综合判断后,决定A订单要在2秒之后被方法M1处理:接下来收到的B订单经过同样的判断后,决定要在10秒后被方法M2处理,--.这时候就可以用回调定时器来管理这些将要被延迟一定时间再执行的任务.     当然,我们可以使用定时器或前面介绍的循环引擎来实现这样的功能,只不过我们自己需要手动管理注册的定时回调任务,并且定时检查每一个未处理订单是否已经到了

双向映射 IBidirectionalMapping -- ESBasic 可复用的.NET类库(11)

1.缘起:     假设我们的用户管理系统要求用户的ID和Name都必须是唯一的,并且用户的ID和Name一经确定就不能被修改.而且管理系统经常需要根据ID来查找Name,也经常需要根据Name来查找ID.根据这样的需求,我们可以考虑使用一个Dictionary来将ID和Name缓存起来,通常ID作为Key,Name作为Value.这样便可实现通过ID查询Name的快速查找,但是,通过Name查找ID就不是那么快了,因为涉及到对Dictionary的Values做遍历的操作.那么,有可能使得通过