CodeGym /課程 /C# SELF /時間處理的基本型別

時間處理的基本型別

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

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. 日期在底層怎麼存

為了方便日期加減,工程師決定把所有日期 存成從公元元年開始過了幾秒。範圍如下:

屬性 值
最小日期
DateTime.MinValue
= 0001-01-01 00:00:00
最大日期
DateTime.MaxValue
= 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?

  1. 目前時刻
    DateTimeOffset now = DateTimeOffset.Now; // 本地時間 + 時差
    DateTimeOffset utc = DateTimeOffset.UtcNow; // UTC(時差 0)
    
  2. 明確建立
    // 年、月、日、時、分、秒、時差(例如 +2 小時)
    DateTimeOffset custom = new DateTimeOffset(2025, 5, 24, 20, 0, 0, TimeSpan.FromHours(2));
    
  3. 從 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。這樣在不同系統間傳遞時間時就不會搞混,尤其是跨時區的時候。

情境 型別 原因
生日
DateTime
只在意日期,時區通常不重要
登入時間
DateTimeOffset
要知道精確時刻和時差
商品有效期限
DateTime
只在意結束日期,時區不重要
log 事件時間
DateTimeOffset
最好永遠帶時差一起存
2
任務
C# SELF, 等級 15, 課堂 0
上鎖
以不同格式輸出當前日期和時間
以不同格式輸出當前日期和時間
2
任務
C# SELF, 等級 15, 課堂 0
上鎖
時間的加法與減法
時間的加法與減法
留言
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION