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 — 只有一天中的時間,沒有年、月、日,也一樣沒有時區。
時間型別比較表
| 型別 | 日期 | 時間 | 時區 | 用途 |
|---|---|---|---|---|
|
✅ | ✅ | 🚫 | 幾乎什麼都能用(但不一定方便或安全) |
|
✅ | ✅ | ✅ | 需要記錄時間點跟時區時用 |
|
✅ | 🚫 | 🚫 | 生日、只有日期沒時間的資料 |
|
🚫 | ✅ | 🚫 | 營業時間、排程、一天內的時段 |
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 完全不知道什麼是時區。它們就是單純的日期或時間——跟時區一點關係都沒有。如果你要處理時區,記得要另外存這個資訊。
GO TO FULL VERSION