DateTime，就是一個世界的大融合。

日期和時間，在我們開發中非常重要。DateTime在C#中，專門用來表達和處理日期和時間。

本文算是多年使用DateTime的一個總結，包括DateTime對象的整體應用，以及如何處理不同的區域、時區、格式等內容。

一、什么是DateTime

跟我們想的不一樣，DateTime不是一個類(class)，而是一個結構(struct)，它存在于System命名空間下，在Dotnet Core中，處于System.Runtime.dll中。

看一下DateTime的定義：

public?struct?DateTime?:?IComparable,?IComparable,?IConvertible,?IEquatable,?IFormattable,?System.Runtime.Serialization.ISerializable

從定義可以知道，DateTime實現了IComparable、IConvertible、IEquatable、IFormattable、ISerializable。因此，DateTime可以讓我們使用有關日期和時間的很多相關信息。

二、構造

初始化一個DateTime對象，C#提供了11種方式進行初始化，根據需要，可以使用年月日時分秒，以及Ticks。

Ticks是C#里一個獨特的定義，它是以公歷0001年1月1日00:00:00.000以來所經歷的以100納秒為間隔的間隔數。我們知道，納秒、微秒、毫秒和秒之間都是1000倍的關系，所以，1毫秒等于10000Ticks。這個數字很重要。在C#到Javascript時間轉換時，需要很清楚這個對應關系。

DateTime?date1?=?new?DateTime(2020,?7,?14);
DateTime?date2?=?new?DateTime(2020,?7,?14,?14,?23,?40);
DateTime?date3?=?new?DateTime(637303334200000000);

三、靜態字段

DateTime包括三個靜態字段：

MinValue - DateTime的最小值，對應公歷0001年1月1日00:00:00.000，Ticks為0；

MaxValue - DateTime的最大值，對應公歷9999看12月31日23:59:59.999，Ticks為3155378975999999999；

UnixEpoch - Unix、Javascript下的時間起點，對應公歷1970年1月1日00:00:00.000，Ticks為621355968000000000；

在Javascript中，時間保存的是從UnixEpoch開始，即從1970年1月1日00:00:00.000開始到現在的毫秒數。所以，C#時間到Javascript時間的轉換，可以用以下代碼：

public?static?long?ToUnixTicks(this?DateTime?time){
????return?(long)TimeSpan.FromTicks(time.Ticks?-?DateTime.UnixEpoch.Ticks).TotalMilliseconds?-?TimeZoneInfo.Local.GetUtcOffset(time).Hours?*?60?*?60?*?1000;
}

在Javascript中引入時間：

var?time?=?new?Date().setTime(unix_ticks);

就完成了轉換。

四、方法

DateTime提供了很多種方法來操作DateTime對象，用于處理諸如向日期添加天數、小時、分鐘、秒、日期差異、從字符串解析到datetime對象、獲得通用時間等等。這兒就不詳細說了，需要了可以查微軟文檔，很詳細。

給幾個例子：

TimeSpan?duration?=?new?System.TimeSpan(30,?0,?0,?0);
DateTime?newDate1?=?DateTime.Now.Add(duration);

DateTime?today?=?DateTime.Now;
DateTime?newDate2?=?today.AddDays(30);

string?dateString?=?"2020-07-14?14:23:40";
DateTime?dateTime12?=?DateTime.Parse(dateString);

DateTime?date1?=?new?System.DateTime(2020,?7,?13,?14,?20,?10);
DateTime?date2?=?new?System.DateTime(2020,?7,?14,?14,?25,?40);
DateTime?date3?=?new?System.DateTime(2020,?7,?14,?14,?25,?40);

TimeSpan?diff1?=?date2.Subtract(date1);
DateTime?date4?=?date3.Subtract(diff1);
TimeSpan?diff2?=?date3?-?date2;

DateTime?date5?=?date2?-?diff1;

五、屬性

DateTime提供了年月日時分秒、以及其它一些屬性，用來方便提取日期中的細節。

DateTime?myDate?=?new?DateTime(2020,?7,?14,?14,?23,?40);
int?year?=?myDate.Year;?
int?month?=?myDate.Month;
int?day?=?myDate.Day;
int?hour?=?myDate.Hour;
int?minute?=?myDate.Minute;
int?second?=?myDate.Second;
int?weekDay?=?(int)myDate.DayOfWeek;
string?weekString?=?myDate.DayOfWeek.ToString();

其中，DayOfWeek，是用來判斷日期是星期幾的，它是一個枚舉值。注意，按照慣例，一周是從周日開始的，所以，0表示周日，6表示周六。

DateTimeKind，用來定義實例表示的時間是基于本地時間(LocalTime)、UTC時間(UTC)或是不指定(Unspecified)。

在大多數情況下，我們定義時間就直接定義年月日時分秒，例如下面：

DateTime?myDate?=?new?DateTime(2020,?7,?14,?14,?23,?40);

這種定義下，這個時間就是Unspecified的。

在使用時，如果應用過程中不做時間轉換，始終以這種方式用，那不會有任何問題。但在某些情況下，時間有可能會發生轉換，例如跨國應用的時間處理，再例如MongoDB，在數據庫保存數據時，強制使用UTC時間。這種情況下，處理時間就必須采用LocalTime或UTC時間：

DateTime?myDate?=?new?DateTime(2020,?7,?14,?14,?23,?40,?DateTimeKind.Local);

或

DateTime?myDate?=?new?DateTime(2020,?7,?14,?14,?23,?40,?DateTimeKind.Unspecified);

否則，在時間類型不確定的情況下，時間轉換會出現問題。

看看下面的例子：

DateTime?myDate?=?new?DateTime(2020,?7,?14,?14,?23,?40);

var?date1?=?myDate.ToLocalTime();
Console.WriteLine(date1.ToString());
/*?7/14/2020?22:23:40?PM?*/

var?date2?=?myDate.ToUniversalTime();
Console.WriteLine(date2.ToString());
/*?7/14/2020?6:23:40?AM?*/

當使用ToLocalTime方法時，Unspecified時間會認為自己是UTC時間，而當使用ToUniversalTime時，Unspecified時間又會認為自己是LocalTime時間，導致時間上的轉換錯誤。

關于MongoDB處理時間的相關內容，可以去看我的另一個文章：MongoDB via Dotnet Core數據映射詳解

六、時間對象的加減及比較

DateTime時間對象的加減及比較非常方便。看例子：

DateTime?date1?=?new?System.DateTime(2020,?7,?14);

TimeSpan?timeSpan?=?new?System.TimeSpan(10,?5,?5,?1);
DateTime?addResult?=?date1?+?timeSpan;
DateTime?substarctResult?=?date1?-?timeSpan;?

DateTime?date2?=?new?DateTime(2020,?7,?14);
DateTime?date3?=?new?DateTime(2020,?7,?15);

bool?isEqual?=?date2?==?date3;

七、日期的格式化

日期的格式化是相關DateTime網上詢問和查找最多的內容。

有這么一個表：

對照這個表就可以：

date.ToString("yyyy-MM-dd?HH:mm:ss");

八、陰歷

DateTime本身依賴于日歷Calendar類。Calendar是一個抽象類，在System.Globalization命名空間下，也在System.Runtime.dll中。而在Calendar類下面，提供了很多不同類型的日歷。跟我們有關系的，是中國的陰歷ChineseLunisolarCalendar。

使用也很簡單：

Calendar?calendar?=?new?ChineseLunisolarCalendar();

DateTime?date?=?new?DateTime(2020,?06,?24,?calendar);
/*?7/14/2020?00:00:00?AM?*/

嗯嗯，經常看陰歷的伙伴們會看出一點問題：今天是陰歷5月24，為什么這兒寫的是6月24呢？這個是因為今天閏4月，所以，陰歷5月實際是這一個陰歷年的第6個月。

那如何判斷哪個月是否閏月呢？

Calendar?calendar?=?new?ChineseLunisolarCalendar();

bool?is_leapYear?=?calendar.IsLeapYear(2020);
bool?is_leapMonth?=?calendar.IsLeapMonth(2020,?5);
bool?is_leapDay?=?calendar.IsLeapDay(2020,?5,?26);

同樣，我們也可以用公歷轉陰歷：

DateTime?date?=?DateTime.Now;

Calendar?calendar?=?new?ChineseLunisolarCalendar();

int?year?=?calendar.GetYear(date);
/*?2020?*/
int?month?=?calendar.GetMonth(date);
/*?6?*/
int?day?=?calendar.GetDayOfMonth(date);
/*?24?*/

以上就是全部內容了。

有沒有發現，微軟實現的功能，比我們想像的要多？

(全文完)

喜歡就來個三連，讓更多人因你而受益