你真的清楚DateTime in C#嗎？

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

 

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

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

1、什麼是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可讓咱們使用有關日期和時間的不少相關信息。

    爲了防止不提供原網址的轉載，特在這裏加上原文連接：http://www.javashuo.com/article/p-aydjnjcp-mw.html

2、構造

初始化一個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);

3、靜態字段

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);

就完成了轉換。

4、方法

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;

5、屬性

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數據映射詳解

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

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;

7、日期的格式化

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

有這麼一個表：

對照這個表就能夠：

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

8、陰曆

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

 

以上就是所有內容了。

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

 

（全文完）

 

---

 

微信公衆號：老王Plus 掃描二維碼，關注我的公衆號，能夠第一時間獲得最新的我的文章和內容推送 本文版權歸做者全部，轉載請保留此聲明和原文連接