C# 内置 DateTime类详解

C# 内置 DateTime类详解

---

摘抄自微软官方文档，用来方便自己查阅：网址：https://msdn.microsoft.com/zh-cn/library/system.datetime(v=vs.110).aspx

构造函数

 

 

	名称	说明
	DateTime(Int32, Int32, Int32)	将 DateTime 结构的新实例初始化为指定的年、月和日。
	DateTime(Int32, Int32, Int32, Calendar)	将 DateTime 结构的新实例初始化为指定日历的指定年、月和日。
	DateTime(Int32, Int32, Int32, Int32, Int32, Int32)	将 DateTime 结构的新实例初始化为指定的年、月、日、小时、分钟和秒。
	DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	将 DateTime 结构的新实例初始化为指定日历的年、月、日、小时、分钟和秒。
	DateTime(Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	将 DateTime 结构的新实例初始化为指定年、月、日、小时、分钟、秒和协调世界时 (UTC) 或本地时间。
	DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	将 DateTime 结构的新实例初始化为指定的年、月、日、小时、分钟、秒和毫秒。
	DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	将 DateTime 结构的新实例初始化为指定日历的指定年、月、日、小时、分钟、秒和毫秒。
	DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)	将 DateTime 结构的新实例初始化为指定日历的指定年、月、日、小时、分钟、秒、毫秒和协调世界时 (UTC) 或本地时间。
	DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	将 DateTime 结构的新实例初始化为指定年、月、日、小时、分钟、秒、毫秒和协调世界时 (UTC) 或本地时间。
	DateTime(Int64)	将 DateTime 结构的新实例初始化为指定的刻度数。
	DateTime(Int64, DateTimeKind)	将 DateTime 结构的新实例初始化为指定的计时周期数以及协调世界时 (UTC) 或本地时间。

---

属性

 

 

	名称	说明
	Date	获取此实例的日期部分。
	Day	获取此实例所表示的日期为该月中的第几天。
	DayOfWeek	获取此实例所表示的日期是星期几。
	DayOfYear	获取此实例所表示的日期是该年中的第几天。
	Hour	获取此实例所表示日期的小时部分。
	Kind	获取一个值，该值指示由此实例表示的时间是基于本地时间、协调世界时 (UTC)，还是两者皆否。
	Millisecond	获取此实例所表示日期的毫秒部分。
	Minute	获取此实例所表示日期的分钟部分。
	Month	获取此实例所表示日期的月份部分。
	Now	获取一个 DateTime 对象，该对象设置为此计算机上的当前日期和时间，表示为本地时间。
	Second	获取此实例所表示日期的秒部分。
	Ticks	获取表示此实例的日期和时间的计时周期数。
	TimeOfDay	获取此实例的当天的时间。
	Today	获取当前日期。
	UtcNow	获取一个 DateTime 对象，该对象设置为此计算机上的当前日期和时间，表示为协调通用时间 (UTC)。
	Year	获取此实例所表示日期的年份部分。

---

 

 

方法

 

 

	名称	说明
	Add(TimeSpan)	返回一个新的 DateTime，它将指定 TimeSpan 的值添加到此实例的值上。
	AddDays(Double)	返回一个新的 DateTime，它将指定的天数加到此实例的值上。
	AddHours(Double)	返回一个新的 DateTime，它将指定的小时数加到此实例的值上。
	AddMilliseconds(Double)	返回一个新的 DateTime，它将指定的毫秒数加到此实例的值上。
	AddMinutes(Double)	返回一个新的 DateTime，它将指定的分钟数加到此实例的值上。
	AddMonths(Int32)	返回一个新的 DateTime，它将指定的月数加到此实例的值上。
	AddSeconds(Double)	返回一个新的 DateTime，它将指定的秒数加到此实例的值上。
	AddTicks(Int64)	返回一个新的 DateTime，它将指定的刻度数加到此实例的值上。
	AddYears(Int32)	返回一个新的 DateTime，它将指定的年份数加到此实例的值上。
	Compare(DateTime, DateTime)	对两个 DateTime 的实例进行比较，并返回一个指示第一个实例是早于、等于还是晚于第二个实例的整数。
	CompareTo(DateTime)	将此实例的值与指定的 DateTime 值相比较，并返回一个整数，该整数指示此实例是早于、等于还是晚于指定的 DateTime 值。
	CompareTo(Object)	将此实例的值与包含指定的 DateTime 值的指定对象相比较，并返回一个整数，该整数指示此实例是早于、等于还是晚于指定的 DateTime 值。
	DaysInMonth(Int32, Int32)	返回指定年和月中的天数。
	Equals(DateTime)	返回一个值，该值指示此实例的值是否等于指定 DateTime 实例的值。
	Equals(DateTime, DateTime)	返回一个值，该值指示的两个 DateTime 实例是否具有同一个日期和时间值。
	Equals(Object)	返回一个值，该值指示此实例是否等于指定的对象。（覆盖 ValueType.Equals(Object)。）
	FromBinary(Int64)	反序列化一个 64 位二进制值，并重新创建序列化的 DateTime 初始对象。
	FromFileTime(Int64)	将指定的 Windows 文件时间转换为等效的本地时间。
	FromFileTimeUtc(Int64)	将指定的 Windows 文件时间转换为等效的 UTC 时间。
	FromOADate(Double)	返回与指定的 OLE 自动化日期等效的 DateTime。
	GetDateTimeFormats()	将此实例的值转换为标准日期和时间格式说明符支持的所有字符串表示形式。
	GetDateTimeFormats(Char)	将此实例的值转换为指定的标准日期和时间格式说明符支持的所有字符串表示形式。
	GetDateTimeFormats(Char, IFormatProvider)	将此实例的值转换为指定的标准日期和时间格式说明符和区域性特定格式信息支持的所有字符串表示形式。
	GetDateTimeFormats(IFormatProvider)	将此实例的值转换为标准日期和时间格式说明符和指定的区域性特定格式信息支持的所有字符串表示形式。
	GetHashCode()	返回此实例的哈希代码。（覆盖 ValueType.GetHashCode()。）
	GetType()	获取当前实例的 Type。（继承自 Object。）
	GetTypeCode()	返回值类型 TypeCode 的 DateTime。
	IsDaylightSavingTime()	指示此 DateTime 实例是否在当前时区的夏时制范围内。
	IsLeapYear(Int32)	返回指定的年份是否为闰年的指示。
	Parse(String)	将日期和时间的字符串表示形式转换为其等效的 DateTime。
	Parse(String, IFormatProvider)	使用指定的区域性特定格式设置信息，将日期和时间的字符串表示形式转换为其等效的DateTime。
	Parse(String, IFormatProvider, DateTimeStyles)	使用指定的区域性特定格式设置信息和格式类型，将日期和时间的字符串表示形式转换为其等效的 DateTime。
	ParseExact(String, String, IFormatProvider)	使用指定的格式和区域性特定格式信息，将日期和时间的指定字符串表示形式转换为其等效的 DateTime。 字符串表示形式的格式必须与指定的格式完全匹配。
	ParseExact(String, String, IFormatProvider, DateTimeStyles)	使用指定的格式、区域性特定的格式信息和样式将日期和时间的指定字符串表示形式转换为其等效的 DateTime。 字符串表示形式的格式必须与指定的格式完全匹配，否则会引发异常。
	ParseExact(String, String[], IFormatProvider, DateTimeStyles)	使用指定的格式数组、区域性特定格式信息和样式，将日期和时间的指定字符串表示形式转换为其等效的 DateTime。 字符串表示形式的格式必须至少与指定的格式之一完全匹配，否则会引发异常。
	SpecifyKind(DateTime, DateTimeKind)	创建新的 DateTime 对象，该对象具有与指定的 DateTime 相同的刻度数，但是根据指定的DateTimeKind 值的指示，指定为本地时间或协调世界时 (UTC)，或者两者皆否。
	Subtract(DateTime)	从此实例中减去指定的日期和时间。
	Subtract(TimeSpan)	从此实例中减去指定持续时间。
	ToBinary()	将当前 DateTime 对象序列化为一个 64 位二进制值，该值随后可用于重新创建 DateTime对象。
	ToFileTime()	将当前 DateTime 对象的值转换为 Windows 文件时间。
	ToFileTimeUtc()	将当前 DateTime 对象的值转换为 Windows 文件时间。
	ToLocalTime()	将当前 DateTime 对象的值转换为本地时间。
	ToLongDateString()	将当前 DateTime 对象的值转换为其等效的长日期字符串表示形式。
	ToLongTimeString()	将当前 DateTime 对象的值转换为其等效的长时间字符串表示形式。
	ToOADate()	将此实例的值转换为等效的 OLE 自动化日期。
	ToShortDateString()	将当前 DateTime 对象的值转换为其等效的短日期字符串表示形式。
	ToShortTimeString()	将当前 DateTime 对象的值转换为其等效的短时间字符串表示形式。
	ToString()	使用当前的区域性格式约定将当前 DateTime 对象的值转换为它的等效字符串表示形式。（覆盖 ValueType.ToString()。）
	ToString(IFormatProvider)	使用指定的区域性特定格式信息将当前 DateTime 对象的值转换为它的等效字符串表示形式。
	ToString(String)	使用指定的格式和当前区域性的格式约定将当前 DateTime 对象的值转换为它的等效字符串表示形式。
	ToString(String, IFormatProvider)	使用指定的格式和区域性特定格式信息将当前 DateTime 对象的值转换为它的等效字符串表示形式。
	ToUniversalTime()	将当前 DateTime 对象的值转换为协调世界时 (UTC)。
	TryParse(String, DateTime)	将日期和时间的指定字符串表示形式转换为其 DateTime 等效项，并返回一个指示转换是否成功的值。
	TryParse(String, IFormatProvider, DateTimeStyles, DateTime)	使用指定的区域性特定格式信息和格式设置样式，将日期和时间的指定字符串表示形式转换为其 DateTime 等效项，并返回一个指示转换是否成功的值。
	TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)	使用指定的格式、区域性特定的格式信息和样式将日期和时间的指定字符串表示形式转换为其等效的 DateTime。 字符串表示形式的格式必须与指定的格式完全匹配。 该方法返回一个指示转换是否成功的值。
	TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)	使用指定的格式数组、区域性特定格式信息和样式，将日期和时间的指定字符串表示形式转换为其等效的 DateTime。 字符串表示形式的格式必须至少与指定的格式之一完全匹配。 该方法返回一个指示转换是否成功的值。

 

 

---

字段

 

 

	名称	说明
	MaxValue	表示 DateTime 的最大可能值。 此字段为只读。
	MinValue	表示 DateTime 的最小可能值。 此字段为只读。

运算符

 

 

	名称	说明
	Addition(DateTime, TimeSpan)	将指定的时间间隔加到指定的日期和时间以生成新的日期和时间。
	Equality(DateTime, DateTime)	确定 DateTime 的两个指定的实例是否相等。
	GreaterThan(DateTime, DateTime)	确定指定的 DateTime 是否晚于另一个指定的 DateTime。
	GreaterThanOrEqual(DateTime, DateTime)	确定一个指定的 DateTime 表示的日期和时间等于还是晚于另一个指定的DateTime。
	Inequality(DateTime, DateTime)	确定 DateTime 的两个指定的实例是否不等。
	LessThan(DateTime, DateTime)	确定指定的 DateTime 是否早于另一个指定的 DateTime。
	LessThanOrEqual(DateTime, DateTime)	确定一个指定的 DateTime 表示的日期和时间等于还是早于另一个指定的DateTime。
	Subtraction(DateTime, DateTime)	将指定的日期和时间与另一个指定的日期和时间相减，返回一个时间间隔。
	Subtraction(DateTime, TimeSpan)	从指定的日期和时间减去指定的时间间隔，返回新的日期和时间。