在 C# 中使用日期和时间

C# 包含 `DateTime` 结构体来处理日期和时间。

要在 C# 中使用日期和时间，请使用 `new` 关键字创建 `DateTime` 结构体的一个对象。以下创建了一个具有默认值的 `DateTime` 对象。

示例：创建 DateTime 对象

DateTime dt = new DateTime(); // assigns default value 01/01/0001 00:00:00

一个 `DateTime` 对象的默认值和最小值是公元 0001 年 1 月 1 日 00:00:00（午夜）。最大值可以是公元 9999 年 12 月 31 日 23:59:59。

使用 `DateTime` 结构体的不同构造函数为 `DateTime` 对象赋初始值。

示例：设置日期和时间

//assigns default value 01/01/0001 00:00:00
DateTime dt1 = new DateTime(); 

//assigns year, month, day
DateTime dt2 = new DateTime(2015, 12, 31); 

//assigns year, month, day, hour, min, seconds
DateTime dt3 = new DateTime(2015, 12, 31, 5, 10, 20);
 
//assigns year, month, day, hour, min, seconds, UTC timezone
DateTime dt4 = new DateTime(2015, 12, 31, 5, 10, 20, DateTimeKind.Utc);

尝试一下

在上面的示例中，我们在构造函数中指定了年、月和日。年份可以是 0001 到 9999，月份可以是 1 到 12，日期可以是 1 到 31。设置这些范围之外的任何其他值都将导致运行时异常。

示例：无效日期

DateTime dt = new DateTime(2015, 12, 32); //throws exception: day out of range

使用不同的 DateTime 构造函数来设置日期、时间、时区、日历和区域性。

刻度 (Ticks)

刻度是自公元 0001 年 1 月 1 日 00:00:00.000（格里高利历）以来经过的 100 纳秒间隔的数量所表示的日期和时间。以下使用刻度数初始化一个 `DateTime` 对象。

示例：刻度

DateTime dt = new DateTime(636370000000000000); 
DateTime.MinValue.Ticks;  //min value of ticks
DateTime.MaxValue.Ticks; // max value of ticks

尝试一下

DateTime 静态字段

`DateTime` 结构体包含静态字段、属性和方法。以下示例演示了重要的静态字段和属性。

示例：静态字段

DateTime currentDateTime = DateTime.Now;  //returns current date and time
DateTime todaysDate = DateTime.Today; // returns today's date
DateTime currentDateTimeUTC = DateTime.UtcNow;// returns current UTC date and time

DateTime maxDateTimeValue = DateTime.MaxValue; // returns max value of DateTime
DateTime minDateTimeValue = DateTime.MinValue; // returns min value of DateTime

尝试一下

TimeSpan

TimeSpan 是一个结构体，用于表示以天、小时、分钟、秒和毫秒为单位的时间。

示例：TimeSpan

DateTime dt = new DateTime(2015, 12, 31);
           
TimeSpan ts = new TimeSpan(25,20,55);
 
DateTime newDate = dt.Add(ts);

Console.WriteLine(newDate);//1/1/2016 1:20:55 AM

尝试一下

两个日期的减法结果是 TimeSpan。

示例：日期相减

DateTime dt1 = new DateTime(2015, 12, 31); 
DateTime dt2 = new DateTime(2016, 2, 2);
TimeSpan result = dt2.Subtract(dt1);//33.00:00:00

尝试一下

运算符

`DateTime` 结构体重载了 +、-、==、!=、>、<、<=、>= 运算符，以简化日期的加法、减法和比较。这使得处理日期变得容易。

示例：运算符

DateTime dt1 = new DateTime(2015, 12, 20);
DateTime dt2 = new DateTime(2016, 12, 31, 5, 10, 20); 
TimeSpan time = new TimeSpan(10, 5, 25, 50);

Console.WriteLine(dt2 + time); // 1/10/2017 10:36:10 AM
Console.WriteLine(dt2 - dt1); //377.05:10:20
Console.WriteLine(dt1 == dt2); //False
Console.WriteLine(dt1 != dt2); //True
Console.WriteLine(dt1 > dt2); //False
Console.WriteLine(dt1 < dt2); //True
Console.WriteLine(dt1 >= dt2); //False
Console.WriteLine(dt1 <= dt2);//True

尝试一下

将字符串转换为 DateTime

可以使用 Parse()、ParseExact()、TryParse() 和 TryParseExact() 方法将有效的日期和时间字符串转换为 `DateTime` 对象。

如果指定的字符串不是日期和时间的有效表示，Parse() 和 ParseExact() 方法将抛出异常。因此，建议使用 TryParse() 或 TryParseExact() 方法，因为如果字符串无效，它们会返回 false。

示例

var str = "5/12/2020";
DateTime dt;
            
var isValidDate = DateTime.TryParse(str, out dt);

if(isValidDate)
    Console.WriteLine(dt);
else
    Console.WriteLine($"{str} is not a valid date string");

尝试一下