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)	從指定的日期和時間減去指定的時間間隔，返回新的日期和時間。