CodeGym /課程 /C# SELF /實用型別:DateOnly 和 TimeOnly

實用型別:DateOnly 和 TimeOnly

C# SELF
等級 15, 課堂 1
開放

1. 前言

以前 C# 沒有專門只存日期或只存時間的型別。所以就算你只想存個日期——比如生日——也只能用 DateTime,還要加個「預設時間」。以前只存日期的老方法就是用 DateTime:


DateTime birthday = new DateTime(1985, 4, 20); // 1985年4月20日,00:00:00

但這樣很不方便。你明明只想要日期,卻還多了個時間(雖然是 0)。這很容易搞混:比如你在比對日期時,程式會連時間一起比,結果就會很莫名其妙。

反過來也是一樣:如果你只想處理時間(像是上班時間 08:00 到 17:00),還是得「編」個日期出來,但其實根本不重要。

現在 .NET 有了 DateOnly 跟 TimeOnly 這兩個專用型別,這些麻煩都解決啦!

新實用型別 DateOnly 和 TimeOnly

  • DateOnly — 只有日曆日期,沒有時間,也沒有時區資訊。
  • TimeOnly — 只有一天中的時間,沒有年、月、日,也一樣沒有時區。

時間型別比較表

型別 日期 時間 時區 用途
DateTime
✅ ✅ 🚫 幾乎什麼都能用(但不一定方便或安全)
DateTimeOffset
✅ ✅ ✅ 需要記錄時間點跟時區時用
DateOnly
✅ 🚫 🚫 生日、只有日期沒時間的資料
TimeOnly
🚫 ✅ 🚫 營業時間、排程、一天內的時段

2. 用 DateOnly 處理日期

宣告與建立

要建立 DateOnly 物件就像養成新習慣一樣簡單!例如:

// 年、月、日
DateOnly birthday = new DateOnly(1985, 4, 20);
用 DateOnly 建立生日日期

如果你已經有 DateTime 物件,可以用 DateOnly.FromDateTime:

DateTime now = DateTime.Now;
DateOnly today = DateOnly.FromDateTime(now);
// 現在 today 只剩日期,時間被丟掉了

主要屬性和方法

  • Year、Month、Day — 跟 DateTime 一樣好用。
  • .ToString() — 可以自訂格式來顯示日期。
Console.WriteLine($"生日:{birthday.Year} 年, {birthday.Month} 月, {birthday.Day} 日。");

Console.WriteLine(today.ToString("dd.MM.yyyy")); // 例如 30.07.2024

日期運算

可以輕鬆加天/月/年:

DateOnly tomorrow = today.AddDays(1);
DateOnly nextMonth = today.AddMonths(1);

試著把你專案裡只存日期的 DateTime 欄位都換成 DateOnly,你就更貼近現代 .NET 啦!

日期比較

可以直接用 <、>、== 來比:

if (birthday < today)
    Console.WriteLine("生日已經過了,或是很久以前 :)");

不會再有多餘的毫秒或分鐘搞亂你。

取得今天日期

DateOnly currentDate = DateOnly.FromDateTime(DateTime.Now);

3. 用 TimeOnly 處理時間

現在來聊聊只處理時間——哪個工程師沒遇過午餐時間排程的問題?

建立 TimeOnly

TimeOnly startWork = new TimeOnly(9, 0);    // 09:00
TimeOnly endWork = new TimeOnly(17, 30);    // 17:30

可以只拿小時、分鐘、秒:

Console.WriteLine($"上班時間:從 {startWork.Hour}:{startWork.Minute:D2} 到 {endWork.Hour}:{endWork.Minute:D2}");

從 DateTime 取得時間

DateTime now = DateTime.Now;
TimeOnly currentTime = TimeOnly.FromDateTime(now);
Console.WriteLine($"現在是 {currentTime}");

時間運算

TimeOnly breakStart = startWork.AddHours(4); // 4 小時後休息,也就是 13:00
TimeOnly breakEnd = breakStart.AddMinutes(30); // 午餐 30 分鐘

比較與判斷

if (currentTime >= startWork && currentTime <= endWork)
    Console.WriteLine("該工作啦 :)");
else
    Console.WriteLine("可以休息囉。");

4. 跟其他型別互動

DateOnly、TimeOnly 跟 DateTime 之間的轉換

有時候你還是得拿回 DateTime(像是要存進舊資料庫或相容性需求):


DateOnly datePart = new DateOnly(2024, 7, 30);
TimeOnly timePart = new TimeOnly(14, 15);
DateTime datetime = datePart.ToDateTime(timePart); // 2024-07-30 14:15:00

反過來也可以:

DateTime dt = DateTime.Now;
DateOnly justDate = DateOnly.FromDateTime(dt);
TimeOnly justTime = TimeOnly.FromDateTime(dt);

重要提醒跟常見錯誤

  • 如果你用舊方法像 DateTime.Parse() 只想解析日期或時間,很可能會出錯或結果怪怪的。這種情況要用專門的方法:DateOnly.Parse() 跟 TimeOnly.Parse()——它們才懂怎麼處理「只剩一半」的值。
  • 要記得:DateOnly 跟 TimeOnly 完全不知道什麼是時區。它們就是單純的日期或時間——跟時區一點關係都沒有。如果你要處理時區,記得要另外存這個資訊。
2
任務
C# SELF, 等級 15, 課堂 1
上鎖
使用 `DateOnly`
使用 `DateOnly`
2
任務
C# SELF, 等級 15, 課堂 1
上鎖
使用 `TimeOnly`
使用 `TimeOnly`
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION