C# 日期和时间(DateTime)

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

要在C#中使用日期和时间,请使用 new 关键字创建 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对象。

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是一种结构,用于以天,小时,分钟,秒和毫秒为单位表示时间。

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结构包含以下将日期和时间转换为字符串的方法。

方法描述
ToString

将 DateTime 值转换为当前区域性的指定格式的字符串。

ToShortDateString

将 DateTime 值转换为当前区域内的短日期字符串(M/d/yyyy 模式)。

ToShortTimeString

将 DateTime 值转换为当前区域性中的短时间字符串(h: mm: ss 模式)。

ToLongDateString

将 DateTime 值转换为当前区域性的长日期字符串(dddd, MMMM d, yyyy 模式)。

ToLongTimeString

将 DateTime 值转换为当前区域内的长时间字符串(h:mm:ss tt 模式)。

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

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");