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结构包含以下将日期和时间转换为字符串的方法。
方法 | 描述 |
---|---|
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 为不同格式的字符串。
示例: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");