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

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

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

一、什麼是DateTime

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

看一下DateTime的定義：

publicstructDateTime:IComparable,IComparable<DateTime>,IConvertible,IEquatable<DateTime>,IFormattable,System.Runtime.Serialization.ISerializable
 

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

為了防止不提供原網址的轉載，特在這裡加上原文連結：https://www.cnblogs.com/tiger-wang/p/13303360.html

二、構造

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

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

DateTimedate1=newDateTime(2020,7,14);
DateTimedate2=newDateTime(2020,7,14,14,23,40);
DateTimedate3=newDateTime(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時間的轉換，可以用以下程式碼：

publicstaticlongToUnixTicks(thisDateTimetime)
{
return(long)TimeSpan.FromTicks(time.Ticks-DateTime.UnixEpoch.Ticks).TotalMilliseconds-TimeZoneInfo.Local.GetUtcOffset(time).Hours*60*60*1000;
}

在Javascript中引入時間：

vartime=newDate().setTime(unix_ticks);

就完成了轉換。

四、方法

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

給幾個例子：

TimeSpanduration=newSystem.TimeSpan(30,0,0,0);
DateTimenewDate1=DateTime.Now.Add(duration);

DateTimetoday=DateTime.Now;
DateTimenewDate2=today.AddDays(30);

stringdateString="2020-07-1414:23:40";
DateTimedateTime12=DateTime.Parse(dateString);

DateTimedate1=newSystem.DateTime(2020,7,13,14,20,10);
DateTimedate2=newSystem.DateTime(2020,7,14,14,25,40);
DateTimedate3=newSystem.DateTime(2020,7,14,14,25,40);

TimeSpandiff1=date2.Subtract(date1);
DateTimedate4=date3.Subtract(diff1);
TimeSpandiff2=date3-date2;

DateTimedate5=date2-diff1;

五、屬性

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

DateTimemyDate=newDateTime(2020,7,14,14,23,40);
intyear=myDate.Year;
intmonth=myDate.Month;
intday=myDate.Day;
inthour=myDate.Hour;
intminute=myDate.Minute;
intsecond=myDate.Second;
intweekDay=(int)myDate.DayOfWeek;
stringweekString=myDate.DayOfWeek.ToString();

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

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

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

DateTimemyDate=newDateTime(2020,7,14,14,23,40);

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

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

DateTimemyDate=newDateTime(2020,7,14,14,23,40,DateTimeKind.Local);

或

DateTimemyDate=newDateTime(2020,7,14,14,23,40,DateTimeKind.Unspecified);

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

看看下面的例子：

DateTimemyDate=newDateTime(2020,7,14,14,23,40);

vardate1=myDate.ToLocalTime();
Console.WriteLine(date1.ToString());
/*7/14/202022:23:40PM*/

vardate2=myDate.ToUniversalTime();
Console.WriteLine(date2.ToString());
/*7/14/20206:23:40AM*/

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

關於MongoDB處理時間的相關內容，可以去看我的另一個文章：MongoDB via Dotnet Core資料對映詳解

六、時間物件的加減及比較

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

DateTimedate1=newSystem.DateTime(2020,7,14);

TimeSpantimeSpan=newSystem.TimeSpan(10,5,5,1);
DateTimeaddResult=date1+timeSpan;
DateTimesubstarctResult=date1-timeSpan;

DateTimedate2=newDateTime(2020,7,14);
DateTimedate3=newDateTime(2020,7,15);

boolisEqual=date2==date3;

七、日期的格式化

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

有這麼一個表：

【圖片】

對照這個表就可以：

date.ToString("yyyy-MM-ddHH:mm:ss");

八、陰曆

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

使用也很簡單：

Calendarcalendar=newChineseLunisolarCalendar();

DateTimedate=newDateTime(2020,06,24,calendar);
/*7/14/202000:00:00AM*/

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

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

Calendarcalendar=newChineseLunisolarCalendar();

boolis_leapYear=calendar.IsLeapYear(2020);
boolis_leapMonth=calendar.IsLeapMonth(2020,5);
boolis_leapDay=calendar.IsLeapDay(2020,5,26);

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

DateTimedate=DateTime.Now;

Calendarcalendar=newChineseLunisolarCalendar();

intyear=calendar.GetYear(date);
/*2020*/
intmonth=calendar.GetMonth(date);
/*6*/
intday=calendar.GetDayOfMonth(date);
/*24*/

以上就是全部內容了。

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

（全文完）

微信公眾號：老王Plus 掃描二維碼，關注個人公眾號，可以第一時間得到最新的個人文章和內容推送 本文版權歸作者所有，轉載請保留此宣告和原文連結