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是一个日期和时间,以自格里高利历00:00:00.000年1月1日以来的100纳秒间隔数表示。下面用刻度数初始化DateTime对象。
DateTime dt = new DateTime(636370000000000000); DateTime.MinValue.Ticks; //ticks 最小值 DateTime.MaxValue.Ticks; // ticks 最大值
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是一种结构,用于以天,小时,分钟,秒和毫秒为单位表示时间。
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结构包含以下将日期和时间转换为字符串的方法。
方法 | 描述 |
---|---|
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());
可以使用 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");