1. 認識 DateTime 型別
日期和時間是所有商業邏輯的基本磚塊,連最簡單的專案都不能忽略。有時候你會想知道用戶什麼時候註冊、什麼時候要寄信、正確處理航班時刻表、時區問題——到處都是日期!但實際上,處理日期和時間在程式設計裡超級陰險。😅
C# 給你兩個超重要的時間型別:DateTime 跟 DateTimeOffset。簡單說,一個適合簡單情境,另一個適合需要時區和精確時間儲存的場合。
什麼是 DateTime?
DateTime 是一個在 System 命名空間裡的 struct。它可以儲存日期和時間,精確到 100 奈秒(十億分之一秒)。
- 值型別(struct),也就是複製時是值複製。
- 同時包含日期和時間。
- 可以只存日期(2025-05-24),也可以存日期加時間(2025-05-24 15:17:42)。
- 「不知道」時區,除非你明確指定。
2. 建立 DateTime
有幾種方式,來看重點。
1. 目前日期和時間
DateTime now = DateTime.Now; // 電腦本地時間
DateTime utcNow = DateTime.UtcNow; // 格林威治時間 (UTC)
- Now —— 就是「你電腦上的時間」,會考慮 Windows 的本地時區。
- UtcNow —— 「全域」時間,也就是世界協調時間。很適合存進資料庫或全球系統。
2. 建構子
// 年、月、日
var date1 = new DateTime(2025, 5, 24);
// 年、月、日、時、分、秒
var date2 = new DateTime(2025, 5, 24, 12, 0, 0);
// 年、月、日、時、分、秒、毫秒
var date3 = new DateTime(2025, 5, 24, 12, 0, 0, 500);
月份不是從零開始算的! 也就是說一月是 1,十二月是 12。
3. 從字串解析
超常見的情境是日期是字串!比如用戶手動輸入日期。
string userInput = "2025-05-24 18:30";
DateTime parsed = DateTime.Parse(userInput); // 可能會丟出例外!
想要安全解析——用 TryParse:
string input = "2025-05-24 18:30";
if (DateTime.TryParse(input, out DateTime result))
{
Console.WriteLine($"轉換成功: {result}");
}
else
{
Console.WriteLine("無法將字串轉成日期。");
}
4. 取得「只有日期」的值
DateTime today = DateTime.Today; // 今天,時間 = 00:00:00
取出日期和時間的元件
所有屬性都能很快拿到:
var dt = new DateTime(2025, 5, 24, 15, 17, 42);
int year = dt.Year; // 2025
int month = dt.Month; // 5(五月)
int day = dt.Day; // 24
int hour = dt.Hour; // 15
int minute = dt.Minute; // 17
int second = dt.Second; // 42
DayOfWeek dow = dt.DayOfWeek; // 星期五
3. 操作 DateTime 型別
日期加減
時間在程式裡跑很快,想知道「離 deadline 還有幾小時」就用這些方法:
DateTime now = DateTime.Now;
DateTime tomorrow = now.AddDays(1); // 明天
DateTime afterFiveHours = now.AddHours(5); // 五小時後
DateTime inTenMinutes = now.AddMinutes(10); // 十分鐘後
兩個日期的差:TimeSpan
兩個日期的差是一個獨立的型別,叫 TimeSpan:
DateTime deadline = new DateTime(2026, 6, 1);
DateTime now = DateTime.Now;
TimeSpan untilDeadline = deadline - now;
Console.WriteLine($"離 deadline 還有天數: {untilDeadline.Days}");
Console.WriteLine($"離 deadline 還有小時: {untilDeadline.TotalHours:N2}");
TimeSpan 是「差值」,不是「具體日期/時間」!
檢查日期在未來還是過去
if (deadline > now)
Console.WriteLine("Deadline 還沒到!");
else
Console.WriteLine("Deadline 已經過了!快交作業!");
4. 日期在底層怎麼存
為了方便日期加減,工程師決定把所有日期 存成從公元元年開始過了幾秒。範圍如下:
| 屬性 | 值 |
|---|---|
| 最小日期 | = 0001-01-01 00:00:00 |
| 最大日期 | = 9999-12-31 23:59:59.9999999 |
| 單位 | 1 tick = 100 奈秒 |
DateTime 存的不是單純的秒數,而是「tick」(ticks),從一個特別的日期——公元 0001 年 1 月 1 日(對,工程師不認識恐龍,他們的紀元很嚴格)開始。一個 tick = 100 奈秒。
5. DateTimeOffset 型別
有時 DateTime 不夠用。來看經典情境:公司在兩個國家有分部,時區不同,所有會議都要「照我的時間」排。怎麼辦?
用 DateTime 記錄的時間通常是「抽象」的:就是一串數字和 tick,除非你明確說這是哪個時區。比如你拿到 "2025-05-24 15:00",你根本不知道這是奈洛比?巴格達?柏林?(如果還有夏令時間就更刺激了!)
所以如果你要記錄精確時刻,而不是單純「日曆上的日期」,就有了 DateTimeOffset。建立 DateTimeOffset 時可以指定時差(比如奈洛比 +3 小時):
var localTime = new DateTimeOffset(2025, 5, 24, 15, 0, 0, TimeSpan.FromHours(3));
如果你遇到以下情境,請用 DateTimeOffset:
- 你需要知道精確時刻(比如 log 裡的事件,跟伺服器時間有關)。
- 你的程式有來自不同時區的用戶。
- 你要儲存/傳遞帶時區的時間(比如交易、事件、行程表)。
6. 怎麼建立 DateTimeOffset?
- 目前時刻
DateTimeOffset now = DateTimeOffset.Now; // 本地時間 + 時差 DateTimeOffset utc = DateTimeOffset.UtcNow; // UTC(時差 0) - 明確建立
// 年、月、日、時、分、秒、時差(例如 +2 小時) DateTimeOffset custom = new DateTimeOffset(2025, 5, 24, 20, 0, 0, TimeSpan.FromHours(2)); - 從 DateTime 轉換
DateTime dt = DateTime.Now; DateTimeOffset dto = new DateTimeOffset(dt); // 會自動抓本地時差
取出元件
DateTimeOffset dto = DateTimeOffset.Now;
var datePart = dto.Date; // 只有日期
var timePart = dto.TimeOfDay; // 只有時間
var offset = dto.Offset; // 相對 UTC 的時差,例如 03:00:00
時區轉換
時差魔法:
// 取得 UTC 時間
var now = DateTimeOffset.Now;
var utc = now.ToUniversalTime();
Console.WriteLine(utc); // 格林威治時間
// 轉換到其他時區
var berlinTime = utc.ToOffset(TimeSpan.FromHours(2));
Console.WriteLine(berlinTime); // 柏林時間(CET +2)
7. 什麼時候用 DateTime,什麼時候用 DateTimeOffset?
選擇哲學
如果只是單純本地用途——比如生日、文章發表日、問卷截止到 15:00,通常 DateTime 就夠了。這種情況下絕對時間不重要,只要事件發生在某天某時,不用管時區。
但如果你要記錄精確時刻和時區,比如 log、交易或分散式系統——最好用 DateTimeOffset。這樣在不同系統間傳遞時間時就不會搞混,尤其是跨時區的時候。
| 情境 | 型別 | 原因 |
|---|---|---|
| 生日 | |
只在意日期,時區通常不重要 |
| 登入時間 | |
要知道精確時刻和時差 |
| 商品有效期限 | |
只在意結束日期,時區不重要 |
| log 事件時間 | |
最好永遠帶時差一起存 |
GO TO FULL VERSION