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

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

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

一、什么是DateTime

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

看一下DateTime的定義：

public struct DateTime : 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時間轉換時，需要很清楚這個對應關系，

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 */