在 .NET 中，日期和時間通常使用 DateTime 或 DateTimeOffset 來表示。這兩種數據類型都可以表示日期和時間，但它們之間有一些明顯的區別。DateTime 是不帶時區信息的，而 DateTimeOffset 是帶時區偏移量的，可以用來表示一個特定的時刻。

在現代 web 應用中，我們經常需要將日期和時間數據序列化為 JSON 格式，以便在客戶端和服務端之間進行通信。.NET 提供了多種方法來實現 JSON 序列化，其中 System.Text.Json 庫是 .NET Core 3.0 以后推出的新型 JSON 序列化器，它比早期的 DataContractJsonSerializer 和 Newtonsoft.Json 更快，更輕量，并且提供了更為豐富的功能。

在本文中，我們將探討如何在 System.Text.Json 中將 DateTimeOffset 序列化為時間戳。

代碼示例

下面是一個簡單的 .NET Core 控制臺應用，它演示了如何使用 System.Text.Json 庫將 DateTimeOffset 序列化為時間戳。

using?System;
using?System.Text.Json;namespace?JsonSerialization
{class?Program{static?void?Main(string[]?args){//?創建一個?DateTimeOffset?對象var?dateTimeOffset?=?new?DateTimeOffset(2020,?10,?25,?10,?15,?0,?TimeSpan.FromHours(8));//?序列化?DateTimeOffset?對象為?JSONvar?json?=?JsonSerializer.Serialize(dateTimeOffset,?new?JsonSerializerOptions{//?設置時間戳格式Converters?=?{?new?DateTimeOffsetConverter()?}});//?輸出結果Console.WriteLine(json);//?等待用戶輸入Console.ReadKey();}}//?定義?DateTimeOffset?轉換器public?class?DateTimeOffsetConverter?:?JsonConverter<DateTimeOffset>{public?override?DateTimeOffset?Read(ref?Utf8JsonReader?reader,?Type?typeToConvert,?JsonSerializerOptions?options){return?DateTimeOffset.FromUnixTimeMilliseconds(reader.GetInt64());}public?override?void?Write(Utf8JsonWriter?writer,?DateTimeOffset?value,?JsonSerializerOptions?options){writer.WriteNumberValue(value.ToUnixTimeMilliseconds());}}
}

運行結果如下：

1603592100000

可以看到，DateTimeOffset 對象已經被序列化為時間戳形式的 JSON 數據。

使用建議

在實際應用中，建議將 DateTimeOffsetConverter 類定義為一個單獨的文件，例如 DateTimeOffsetConverter.cs，這樣就可以輕松地在多個項目中復用該轉換器。

另外，在實際項目中，可能需要對時間戳的格式進行進一步的自定義。

總結

本文介紹了如何使用 System.Text.Json 庫將 DateTimeOffset 序列化為時間戳。實際應用中，序列化為時間戳可以使客戶端更容易處理日期和時間數據，而且能夠提高數據傳輸的效率。

參考資料

• System.Text.Json

• DateTimeOffset

• JsonConverter

本文采用 Chat OpenAI 輔助注水澆筑而成，如有雷同，完全有可能。