译：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(2011,5,13); // A friday  
    var friday_plus_two_working_days = friday.AddWorkingDays(2); // friday + 2 working days  

    Assert.IsTrue(friday_plus_two_working_days == friday.AddDays(4));  
    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 == 13);

    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(1).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);
}

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