今日不可轉載,可在兒童節當天或之後在公衆號申請白名單。
千呼萬喚始出來
在.NET 6(preview 4)
中引入了兩個期待已久的類型,將作爲核心庫的一部分。DateOnly
和TimeOnly
允許開發人員表示DateTime
的日期或時間部分。這兩個類型爲值類型(struct type),可以在代碼中獨立處理日期或時間概念時使用,它們定義在System命名控件中,使用它們可以與數據庫中允許表示相同類型數據的方式保持一致。具體來說,這些類型與SQL Server數據庫中日期和時間類型可以很好的進行匹配。
注意:如果你要使用這兩種類型,需要下載並安裝.NET 6(preview 4)
和Visual Studio 16.11
(目前處於預覽版中)。如果你想測試一下如何使用,可以使用LinqPad
進行測試驗證。
在.NET 6
中使用DatetOnly
類型
根據字面意思可以很容易看出它所要表達的意思。當我們需要表示一個沒有時間信息的日期類型時,可以使用DateOnly
。例如,我們可以在應用程序中表示某人的出生日期。在這種情況下,我們很少需要使用到DateTime
類型的時間部分了。一個標準的解決方案時將時間設置爲:00:00:00.000。但是使用DateOnly
,我們可以更明確的表明我們想要的意圖。
我們可以通過年、月、日參數構建一個DateOnly
的實例。
var date = new DateOnly(2021, 5, 31);
這樣,我們就創建了一個表示2021年5月31日的日期類型。在內部,DataOnly
結構使用一個整數來跟蹤一個有效天數的時間範圍:0(映射爲0001年1月1日)-3652058(映射爲9999年12月31日)。
通常情況下,我們會從一個現有的DateTime
類型的實例開始,希望從它創建一個DateOnly
實例。爲了實現這一點,我們可以調用FromDateTime
方法。
var currentDateOnly = DateOnly.FromDateTime(DateTime.Now);
與現有的DateTime
類型一樣,我們也可以使用Parse
或TryParse
方法將表示日期的字符串解析爲DateOnly
類型,這兩個方法可能會拋出異常,或返回指示成功或失敗的bool
值。
if (DateOnly.TryParse("28/09/1984", new CultureInfo("en-GB"), DateTimeStyles.None, out var result))
{
Console.WriteLine($"{result.Year}-{result.Month}-{result.Day}");
}
上面的代碼嘗試從第一個參數(日期的字符串表示)解析日期。由於不同的國家和地區對日期的解釋不同,因此日期的解析可能或受到文化的影響。在這個例子中,明確提供CultureInfo
選項,以確保它使用日/月/年的格式從字符串中正確解析。
在成功解析成DateOnly實例的情況下,它將被寫入控制檯。再一次強調:CultureInfo
選擇在這裏扮演着重要角色。在本例中,將使用正在運行的線程的當前區域性來確定所使用的格式。根據系統配置,在應用程序線程在en-GB
下運行。因此字符串被正確格式化。在LinqPad
輸出結果:
我們還可以向DateOnly實例中調用AddDays
、AddMonths
和AddYears
方法,以創建一個新的日期類型的實例。
var newDateOnly = date.AddDays(1).AddMonths(1).AddYears(1);
在.NET 6
中使用TimeOnly
類型
TimeOnly
結構體用於表示一個與日期無關的一個時間類型。例如,想象創建一個鬧鐘應用程序,讓用戶創建一個重複出現的鬧鐘。在這種情況下,我們要存儲一天中報警應該想起的時間,但這個時間和日期是沒有關係的。
TimeOnly
類型有幾個構造方法重載。我認爲大多數開發者會使用的且更常見的方法是允許我們創建一個可以小時分鐘,小時分鐘秒數、小時分鐘秒數毫秒數方法的時間類型。
public TimeOnly(int hour, int minute)
public TimeOnly(int hour, int minute, int second)
public TimeOnly(int hour, int minute, int second, int millisecond)
例如,爲了表示上午10:30分,我們可以創建以下TimeOnly
的實例。
var startTime = new TimeOnly(10, 30);
在這裏,小時採用24
小時制格式,這樣 1 PM
就是13時
。
在內部,TimeOnly
存儲了一個long
類型,它表示自定義時間從凌晨後經過的Ticks
(100納秒一個tick)。例如,凌晨1點時一天中的第一個小時,因此,從凌晨開始就有360億個Tick(00:00:00.0000000)。雖然我們可以通過提供Ticks
作爲參數來構造TimeOnly
。但這個實現細節對於一般使用來說並不是必需的。
public TimeOnly(long ticks);
在定義了開始時間之後,我們可以使用另一個TimeOnly
實例定義一個結束時間爲5PM。
var endTime = new TimeOnly(17, 00, 00);
現在就可以對這些TimeOnly
實例進行數學操作,比如計算差。
var diff = endTime - startTime;
該操作返回類型是TimeSpan
,記錄了兩個TimeOnly
值之間相差的小時數。可以看LinqPad
的輸出結果。
我們可以執行的另一個檢查時識別特定的TimeOnly
是否在時間窗口內。例如,假設我們想要檢查當前時間是否在我們定義的開始時間和結束時間之間。與DateOnly
一樣,我們可以使用FromDateTime
靜態方法將現有的DateTime
轉化爲TimeOnly
。
var currentTime = TimeOnly.FromDateTime(DateTime.Now);
var isBetween = currentTime.IsBetween(startTime, endTime);
Console.WriteLine($"Current time {(isBetween ? "is" : "is not")} between start and end");
上面的代碼將輸出到控制檯,以確定當前時間是否在10:30(10:30 AM)
和17:00(5 PM)
之間。LinqPad輸出的結果進行了稍微的改變,用來輸出當前時間。
方法IsBetween()
可以接受兩個參數,正常的時間範圍,如我們前面的示例中使用的範圍。同樣可以接受跨凌晨的時間範圍,如22:00-02:00。
var startTime = new TimeOnly(22, 00);
var endTime = new TimeOnly(02, 00);
var now = new TimeOnly(23, 25);
var isBetween = now.IsBetween(startTime, endTime);
Console.WriteLine($"Current time {(isBetween ? "is" : "is not")} between start and end");
// Output = Current time is between start and end
LinqPad
中的最後一行的輸出內容。
TimeOnly
還包括用於比較使用循環時鐘的時間操作符。
var startTime = new TimeOnly(08, 00);
var endTime = new TimeOnly(09, 00);
Console.WriteLine($"{startTime < endTime}");
// Output = True
這段代碼檢查上午8點是否早於上午9點,顯然是早於9點的。
總結
面向 .NET 6
的新應用程序中,如果您的數據需要獨立表示日期或時間,那麼 DateOnly
和 TimeOnly
值得考慮。
你喜歡這篇文章嗎?覺得它有用嗎?如果有,請考慮支持我,關注一下我的公衆號