C#中的時間戳

什麼是時間戳

時間戳預設是Unix時間戳。

首先要清楚JavaScript與Unix的時間戳的區別：

JavaScript時間戳：是指格林威治時間1970年01月01日00時00分00秒(北京時間1970年01月01日08時00分00秒)起至現在的總毫秒數。

Unix時間戳：是指格林威治時間1970年01月01日00時00分00秒(北京時間1970年01月01日08時00分00秒)起至現在的總秒數。

可以看出JavaScript時間戳是總毫秒數，Unix時間戳是總秒數。

比如同樣是的 2016/11/03 12:30:00 ，轉換為JavaScript時間戳為 1478147400000；轉換為Unix時間戳為 1478147400。

從上面也可以看出時間戳與時區無關。

Unix時間戳相互轉換

C# DateTime轉換為Unix時間戳

.NET 4.6新方法

只能在 .NET 4.6及更高版本里才能使用。

long timeStamp = DateTimeOffset.Now.ToUnixTimeSeconds(); // 相差秒數
Console.WriteLine(timeStamp);

通用的老方法

System.DateTime startTime = TimeZone.CurrentTimeZone.ToLocalTime(new System.DateTime(1970, 1, 1)); // 當地時區
long timeStamp = (long)(DateTime.Now - startTime).TotalSeconds; // 相差秒數
System.Console.WriteLine(timeStamp);

Unix時間戳轉換為C# DateTime

.NET 4.6新方法

由時間戳轉換的DateTimeOffset的時區預設是+00:00，此時我們需要轉為本地時區，否則後續使用可能會有問題。

轉為本地時區：DateTimeOffset.LocalDateTime。

示例代碼如下：

//預設為UTC時間：{2019/11/14 1:53:26 +00:00}
DateTimeOffset dto = DateTimeOffset.FromUnixTimeMilliseconds(1573696406184);
//預設為UTC時間：{2019/11/14 1:53:26}
DateTime dt01 = dto.DateTime;
//轉為本地時區：{2019/11/14 9:53:26}
DateTime dt02 = dto.LocalDateTime;

通用的老方法

long unixTimeStamp = 1478162177;
System.DateTime startTime = TimeZone.CurrentTimeZone.ToLocalTime(new System.DateTime(1970, 1, 1)); // 當地時區
DateTime dt = startTime.AddSeconds(unixTimeStamp);
System.Console.WriteLine(dt.ToString("yyyy/MM/dd HH:mm:ss:ffff"));

備註

DateTimeOffset使用Now還是UtcNow

對於DateTimeOffset，發現有2個獲取當前時間的屬性：DateTimeOffset.Now和DateTimeOffset.UtcNow。

如果只是獲取時間戳，這2個使用哪個都可以，得到的值是一樣的。

因為DateTimeOffset裡面有時區信息，獲取時間戳時會使用時區進行轉換的，所以獲得的時間戳一樣。

而也是因為時區的原因，DateTimeOffset的其他操作可能會不一樣。例如DateTimeOffset.DateTime就不一樣，此時推薦使用DateTimeOffset.LocalDateTime來獲得本地時區的時間。

測試代碼如下：

//none：2019/6/14 15:17:43 +08:00
Console.WriteLine("none：{0}", DateTimeOffset.Now);
//utc：2019/6/14 7:17:43 +00:00
Console.WriteLine("utc：{0}", DateTimeOffset.UtcNow);

//none：1560496663
Console.WriteLine("none：{0}", DateTimeOffset.Now.ToUnixTimeSeconds());
//utc：1560496663
Console.WriteLine("utc：{0}", DateTimeOffset.UtcNow.ToUnixTimeSeconds());

DateTime轉換為DateTimeOffset

可以直接把DateTime賦值給DateTimeOffset，內部會自動進行隱式轉換。這裡涉及到時區，請往下看。

DateTime的時區信息(Kind屬性)

DateTime的時區信息存放在Kind屬性里。Kind屬性的數據類型是DateTimeKind枚舉，只有3個值：

• Unspecified：未指定/未規定
• Utc：UTC時間
• Local：本地時區

不同情況下得到的DateTime的Kind是不同的，具體如下：

• DateTime.Now：DateTime.Kind是 Local(本地時區)。
• DateTime.UtcNow：DateTime.Kind是 Utc。

• DateTime.Parse()：

  • 【預設】在未指定時區時，DateTime.Kind是 Unspecified

  • 指定時區：指定時區後DateTime.Kind就是相對應的值。

    指定時區有2種方式：
    • 【預設+優先】待轉換的字元串里有時區信息。例如：2019/11/24 17:40:32 +08:00
    • 使用DateTimeStyles參數來指定時區。DateTimeStyles是枚舉類型，更多信息自己查看定義，這裡不再多說。

Local和Utc都會把相應的時區傳遞過去。對於 Unspecified(未指定)，會被當做本地時區來處理（結果已驗證，源碼沒看懂）。

測試代碼

//dtNow：2019/11/24 17:40:32(Kind：Local)
DateTime dtNow = DateTime.Now;
//dtUtcNow：2019/11/24 9:40:32(Kind：Utc)
DateTime dtUtcNow = DateTime.UtcNow;
//dtParse：2019/11/24 17:40:13(Kind：Unspecified)
DateTime dtParse = DateTime.Parse("2019-11-24 17:40:13");

//dtoNow：2019/11/24 17:40:32 +08:00
DateTimeOffset dtoNow = dtNow;
//dtoUtcNow：2019/11/24 9:40:32 +00:00
DateTimeOffset dtoUtcNow = dtUtcNow;
//dtoParse：2019/11/24 17:40:13 +08:00
DateTimeOffset dtoParse = dtParse;

Console.WriteLine("DateTime：");
Console.WriteLine("dtNow：{0}(Kind：{1})", dtNow, dtNow.Kind);
Console.WriteLine("dtUtcNow：{0}(Kind：{1})", dtUtcNow, dtUtcNow.Kind);
Console.WriteLine("dtParse：{0}(Kind：{1})", dtParse, dtParse.Kind);

Console.WriteLine();

Console.WriteLine("DateTimeOffset：");
Console.WriteLine("dtoNow：{0}", dtoNow);
Console.WriteLine("dtoUtcNow：{0}", dtoUtcNow);
Console.WriteLine("dtoParse：{0}", dtoParse);

輸出結果如下：

DateTime：
dtNow：2019/11/24 17:40:32(Kind：Local)
dtUtcNow：2019/11/24 9:40:32(Kind：Utc)
dtParse：2019/11/24 17:40:13(Kind：Unspecified)

DateTimeOffset：
dtoNow：2019/11/24 17:40:32 +08:00
dtoUtcNow：2019/11/24 9:40:32 +00:00
dtoParse：2019/11/24 17:40:13 +08:00

DateTimeOffset.Parse的預設時區

DateTimeOffset.Parse的預設時區是當前時區。

//parse：2019/6/14 15:38:49 +08:00
Console.WriteLine("parse：{0}", DateTimeOffset.Parse("2019-6-14 15:38:49"));

參考

1. C# DateTime與時間戳轉換：https://www.cnblogs.com/polk6/p/6024892.html
2. 如何將Unix時間戳轉換為DateTime，反之亦然？：https://stackoverflow.com/questions/249760/how-can-i-convert-a-unix-timestamp-to-datetime-and-vice-versa
3. DateTimeOffset源碼：https://source.dot.net/#System.Private.CoreLib/shared/System/DateTimeOffset.cs