C# 日期和时间

C#包含DateTime可处理日期和时间的结构。

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

示例：创建DateTime对象

DateTime dt = new DateTime(); // 分配默认值 01/01/0001 00:00:00

DateTime 对象的默认值和最小值是0001年1月1日00:00:00（午夜）。最大值可以是9999年12月31日晚上11:59:59

使用 DateTime 结构的不同构造函数为 DateTime 对象分配初始值。

示例：设置日期和时间

//分配默认值01/01/0001 00:00:00
DateTime dt1 = new DateTime(); 

//分配年，月，日
DateTime dt2 = new DateTime(2015, 12, 31); 

//分配年，月，日, hour, min, seconds
DateTime dt3 = new DateTime(2015, 12, 31, 5, 10, 20);
 
//分配年，月，日, 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); //引发异常：天超出范围

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

Ticks

Ticks是一个日期和时间，以自格里高利历00:00:00.000年1月1日以来的100纳秒间隔数表示。下面用刻度数初始化DateTime对象。

示例：Ticks

DateTime dt = new DateTime(636370000000000000); 
DateTime.MinValue.Ticks;  //ticks 最小值
DateTime.MaxValue.Ticks; // ticks 最大值

DateTime 静态字段

DateTime结构包括静态字段，属性和方法。下面的示例演示重要的静态字段和属性。

示例：静电场

DateTime currentDateTime = DateTime.Now;  //返回当前日期和时间
DateTime todaysDate = DateTime.Today; // 返回今天的日期
DateTime currentDateTimeUTC = DateTime.UtcNow;// 返回当前UTC日期和时间

DateTime maxDateTimeValue = DateTime.MaxValue; // 返回DateTime的最大值
DateTime minDateTimeValue = DateTime.MinValue; // 返回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
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 转换为 String

DateTime结构包含以下将日期和时间转换为字符串的方法。

下面的示例演示如何转换 DateTime 为不同格式的字符串。

示例：DateTime到String

var dt = DateTime.Now;

Console.WriteLine("Date String Current Culture: " + dt.ToString("d"));
Console.WriteLine("MM/dd/yyyy Format: " + dt.ToString("MM/dd/yyyy"));
Console.WriteLine("dddd, dd MMMM yyyy Format: " + dt.ToString("dddd, dd MMMM yyyy"));
Console.WriteLine("MM/dd/yyyy h:mm tt Format: " + dt.ToString("MM/dd/yyyy h:mm tt"));
Console.WriteLine("MMMM dd Format:" + dt.ToString("MMMM dd"));
Console.WriteLine("HH:mm:ss Format: " + dt.ToString("HH:mm:ss"));
Console.WriteLine("hh:mm tt Format: " + dt.ToString("hh:mm tt"));
Console.WriteLine("Short Date String: " + dt.ToShortDateString());
Console.WriteLine("Long Date String: " + dt.ToLongDateString());
Console.WriteLine("Short Time String: " + dt.ToShortTimeString());
Console.WriteLine("Long Time String: " + dt.ToLongTimeString());

将字符串转换为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");

编程笔记 » C# 日期和时间