译：Datetime类型的扩展

译文出处：http://www.codeproject.com/Articles/870939/Datetime-Extensions

本文主要针对System.DateTime类型的一系列扩展。包括不同语言环境下对节假日和工作日时间的计算。

简介：

这个开源的项目是对System.DateTime类型的一系列扩展。包括在不同语言环境下节假日和工作日的时间计算。

在许多的企业中，都有一个工作日的概念。无论是计算工作流的完成日期还是回电话，除了节假日和周末，许多企业都从一个日期来增加或减少天数的方式来定义工作日。

你可以从下面链接来下载开放的源码：https://github.com/kappy/DateTimeExtensions

背景：

一个企业的节假日或周末都受到了企业的政策和地理位置的影响，而不是同一某个经验法则来计算的。这里是通过一个DateTimeCultureInfo对象来定义工作日的。

DateTimeCultureInfo是一个基于具体文化来处理日期的核心类。它定义了如何判断一个给出的日期是不是工作日，和两个不同日期之间的转化。

处理工作日依赖于下面2个方法：

public bool IsWorkingDay(DayOfWeek dayOfWeek)

public bool IsWorkingDay(DateTime date)

第一个方法用来确定一周内的工作日，第二个方法作为第一个的扩展，来处理节假日。

由于有多种文化的工作日，所以定义了一个Name属性。

执行这些方法都有具体的策略 IWorkingDayOfWeekStrategy和IHolidayStrategy两个接口。这样设计师为了提高扩展性。

作为辅助功能，这个类能够定位，从约定和策略来实现上述两个接口。

默认情况下，策略是从CultureInfo类来定位的。

代码的使用：

下面的例子采用了最简单的方式来使用扩展：

[Test]

public void simple_calculation() {

    var friday = new DateTime(,,); // A friday

    var friday_plus_two_working_days = friday.AddWorkingDays(); // friday + 2 working days  

    Assert.IsTrue(friday_plus_two_working_days == friday.AddDays());

    Assert.IsTrue(friday_plus_two_working_days.DayOfWeek == DayOfWeek.Tuesday);

}

版本1.1中还有一个扩展来列出一年中的所有节假日：

IDictionary<DateTime, Holiday> AllYearHolidays(this DateTime date)

通过这个DateTime扩展，能够获得给定文化中一年的节假日。就像下面的例子：

[Test]

public void get_this_year_holidays_in_portugal() {

    var portugalDateTimeCultureInfo = new DateTimeCultureInfo("pt-PT");

    var today = DateTime.Today;

    var holidays = today.AllYearHolidays();

    Assert.IsTrue(holidays.Count == );

    foreach (DateTime holidayDate in holidays.Keys) {

        var holiday = holidays[holidayDate];

        Assert.IsTrue(holidayDate.IsWorkingDay(portugalDateTimeCultureInfo) == false, "holiday {0} shouln't be working day in Portugal", holiday.Name);

    }

}

目前支持的环境：

pt-PT
da-DK

pt-BR

fi-FI

en-US

is-IS

en-GB

nb-NO

fr-FR

nl-NL

de-DE

sv-SE

es-ES

es-AR

es-MX

en-AU

en-ZA

fr-CA (en-CA)

ar-SA

it-IT

en-NZ

en-GD

en-IE

sl-SL

扩展：

下面是扩展的两个要点。首先要实现自定义的IHolidayStrategy 和IWorkingDayOfWeekStrategy接口。其次是实现所有的自定义IWorkingDayCultureInfo接口。最终2个的结果应该是相同的。

下面是实现一个自定义的IHolidayStrategy接口，定义了一个今天永远是假日的方法。

public class CustomHolidayStrategy : IHolidayStrategy {

    public bool IsHoliDay(DateTime day) {

        if (day.Date == DateTime.Today)

            return true;

        return false;

    }

    public IEnumerable<Holiday> Holidays {

        get { return null;  }

    }

}

[Test]

public void provide_custom_strategies() {

    var customDateTimeCultureInfo = new DateTimeCultureInfo() {

        LocateHolidayStrategy = (name) => new CustomHolidayStrategy() ,

    };

    Assert.IsTrue(DateTime.Today.IsWorkingDay(customDateTimeCultureInfo) == false);

    Assert.IsTrue(DateTime.Today.AddDays().IsWorkingDay(customDateTimeCultureInfo) == true);

}

下面这个例子定义了一个方法，能够实现一周有3天假期（即使这个具体的例子和实际生活中有所不同，轮流转多出来的一天假中会是在周末以外）：

public class CustomDateTimeCultureInfo : IDateTimeCultureInfo {

    public bool IsWorkingDay(DateTime date) {

        return true;

    }

    public bool IsWorkingDay(DayOfWeek dayOfWeek) {

        switch (dayOfWeek) {

            case DayOfWeek.Sunday:

            case DayOfWeek.Saturday:

            case DayOfWeek.Friday:

            return false;

        default:

            return true;

        }

    }

    public IEnumerable<Holiday> Holidays {

        get {

            return null;

        }

    }

    public string Name {

        get { return "Hello World!"; }

    }

}

[Test]

public void provide_custom_culture() {

    var customDateTimeCultureInfo = new CustomDateTimeCultureInfo();

    var today = DateTime.Today;

    var next_friday = today.NextDayOfWeek(DayOfWeek.Friday);

    Assert.IsTrue(next_friday.IsWorkingDay(customDateTimeCultureInfo) == false);

}

致谢：~~~~~~~~~

巴特西

译：Datetime类型的扩展

简介：

背景：

代码的使用：

目前支持的环境：

扩展：

最新文章

热门文章