DateOnly 結構

定義

命名空間:

System

組件:

System.Runtime.dll

來源:

DateOnly.cs

代表日期，其值範圍從 0001 年 1 月 1 日 Anno Domini （Common Era） 到 9999 年 12 月 31 日 A.D. （C.E.） 在公曆中。

public value class DateOnly : IComparable, IComparable<DateOnly>, IEquatable<DateOnly>, IParsable<DateOnly>, ISpanFormattable, ISpanParsable<DateOnly>, IUtf8SpanFormattable

public readonly struct DateOnly : IComparable, IComparable<DateOnly>, IEquatable<DateOnly>, IParsable<DateOnly>, ISpanFormattable, ISpanParsable<DateOnly>, IUtf8SpanFormattable

type DateOnly = struct
    interface IFormattable
    interface IParsable<DateOnly>
    interface ISpanFormattable
    interface ISpanParsable<DateOnly>
    interface IUtf8SpanFormattable

Public Structure DateOnly
Implements IComparable, IComparable(Of DateOnly), IEquatable(Of DateOnly), IParsable(Of DateOnly), ISpanFormattable, ISpanParsable(Of DateOnly), IUtf8SpanFormattable

繼承

Object

ValueType

DateOnly

實作

IComparable IComparable<DateOnly> IEquatable<DateOnly> IFormattable IParsable<DateOnly> IParsable<TSelf> ISpanFormattable ISpanParsable<DateOnly> IUtf8SpanFormattable

建構函式

名稱	Description
DateOnly(Int32, Int32, Int32, Calendar)	為指定的曆法建立一個新的結構實例 DateOnly ，對應指定的年份、月份和日期。
DateOnly(Int32, Int32, Int32)	建立一個新的結構實例 DateOnly ，對應指定的年份、月份和日期。

屬性

名稱	Description
Day	取得此實例所代表日期的日期成分。
DayNumber	此例表示自公元前曆0001年1月1日起的天數。
DayOfWeek	會用這個例子代表星期幾。
DayOfYear	用這個例子表示年份的星期幾。
MaxValue	會獲得最晚可能的日期。
MinValue	會獲得最早的日期。
Month	獲取此實例所表示日期的月份元件。
Year	取得這個實例所表示日期的年份元件。

方法

名稱	Description
AddDays(Int32)	將指定天數加到該實例的值上。
AddMonths(Int32)	將指定月份數加到該實例的值上。
AddYears(Int32)	將指定年數加到該實例的價值上。
CompareTo(DateOnly)	將此實例的值與指定 DateOnly 值比較，並回傳一個整數，表示該實例是早於指定值、相同還是晚於指定 DateOnly 值。
CompareTo(Object)	將此實例的值與包含指定 DateOnly 值的指定物件比較，並回傳一個整數，表示該實例是早於、相同還是晚於指定 DateOnly 值。
Deconstruct(Int32, Int32, Int32)	由 DateOnlyYear、 Month和 Day分解出來。
Equals(DateOnly)	回傳一個值，表示該實例的值是否等於指定 DateOnly 實例的值。
Equals(Object)	傳回值，指出這個實例是否等於指定的物件。
FromDateTime(DateTime)	回傳 DateOnly 一個設定為指定日期部分 dateTime的實例。
FromDayNumber(Int32)	建立一個新的結構實例 DateOnly ，執行指定天數。
GetHashCode()	傳回這個實例的哈希碼。
Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	利用文化特定的格式資訊與格式風格，將包含日期字串表示的記憶體區間轉換為 DateOnly 對應的日期。
Parse(ReadOnlySpan<Char>, IFormatProvider)	將字元範圍剖析為值。
Parse(String, IFormatProvider, DateTimeStyles)	利用文化特有的格式資訊與格式風格，將包含日期字串表示的字串轉換為 DateOnly 其對應字串。
Parse(String, IFormatProvider)	將字串剖析成值。
Parse(String)	利用當前文化的慣例，將包含日期字串表示的字串轉換為其 DateOnly 等價物。
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	利用指定的格式、文化特定格式資訊及樣式，將指定的日期跨度表示轉換為 DateOnly 其對應的日期。 字串表示的格式必須完全符合指定格式，否則會拋出例外。
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles)	利用指定的格式陣列、文化特定格式資訊及樣式，將指定的日期跨度表示轉換為 DateOnly 對應的日期。 字串表示的格式必須至少符合其中一個指定格式，否則會拋出例外。
ParseExact(ReadOnlySpan<Char>, String[])	利用指定的格式陣列，將指定的日期區間表示轉換為 DateOnly 其等價值。 字串表示的格式必須至少符合其中一個指定格式，否則會拋出例外。
ParseExact(String, String, IFormatProvider, DateTimeStyles)	將指定的日期 DateOnly 字串表示轉換為其對應的日期，使用指定的格式、文化特定的格式資訊及樣式。 字串表示的格式必須完全符合指定格式，否則會拋出例外。
ParseExact(String, String)	將指定的日期字串表示轉換為 DateOnly 其對應的日期，並使用指定格式。 字串表示的格式必須完全符合指定格式，否則會拋出例外。
ParseExact(String, String[], IFormatProvider, DateTimeStyles)	利用指定的格式陣列、文化特定格式資訊及樣式，將指定的日期字串表示轉換為其 DateOnly 對應形式。 字串表示的格式必須至少符合其中一個指定格式，否則會拋出例外。
ParseExact(String, String[])	利用指定的格式陣列，將指定的日期區間表示轉換為 DateOnly 其等價值。 字串表示的格式必須至少符合其中一個指定格式，否則會拋出例外。
ToDateTime(TimeOnly, DateTimeKind)	回傳 DateTime 一個以指定輸入類型的實例，該實例設定為該 DateOnly 實例的日期及指定輸入時間。
ToDateTime(TimeOnly)	回傳 a DateTime ，該值設定為該 DateOnly 實例的日期及指定的輸入時間。
ToLongDateString()	將目前 DateOnly 物件的值轉換為其等效的長日期字串表示。
ToShortDateString()	將目前 DateOnly 物件的值轉換為其等效的短日期字串表示。
ToString()	利用當前文化的格式慣例，將當前 DateOnly 物件的值轉換為其等效的字串表示。 DateOnly物件會以簡短格式格式化。
ToString(IFormatProvider)	利用指定的文化特有格式資訊，將當前 DateOnly 物件的值轉換為其等效的字串表示。
ToString(String, IFormatProvider)	利用指定的文化特有格式資訊，將當前 DateOnly 物件的值轉換為其等效的字串表示。
ToString(String)	將當前 DateOnly 物件的值轉換為其等效字串表示，並依照指定格式及當前文化的格式慣例。
TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)	嘗試將目前實例的值格式化為UTF-8到提供的位元組範圍。
TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	嘗試將目前 DateOnly 實例的值格式化為所提供的字元範圍。
TryParse(ReadOnlySpan<Char>, DateOnly)	將指定的日期區間表示轉換為對 DateOnly 應值，並回傳一個值以表示轉換是否成功。
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateOnly)	嘗試將字元範圍剖析成值。
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateOnly)	利用指定的格式陣列、文化特定格式資訊及樣式，將指定的日期跨度表示轉換為 DateOnly 對應的日期。 並回傳一個表示轉換是否成功的值。
TryParse(String, DateOnly)	將指定的字串表示日期轉換為其 DateOnly 對應值，並回傳一個表示轉換是否成功的值。
TryParse(String, IFormatProvider, DateOnly)	嘗試將字串剖析成值。
TryParse(String, IFormatProvider, DateTimeStyles, DateOnly)	利用指定的格式陣列、文化特定格式資訊及樣式，將指定的日期字串表示轉換為其 DateOnly 對應形式。 並回傳一個表示轉換是否成功的值。
TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, DateOnly)	將指定的日期跨度表示轉換為 DateOnly 其對應的格式與樣式。 字串表示的格式必須完全符合指定的格式。 方法會傳回值，指出轉換是否成功。
TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateOnly)	利用指定的格式、文化特定格式資訊及樣式，將指定的日期跨度表示轉換為 DateOnly其對應的日期。 字串表示的格式必須完全符合指定的格式。 方法會傳回值，指出轉換是否成功。
TryParseExact(ReadOnlySpan<Char>, String[], DateOnly)	將指定的日期字元區間轉換為等 DateOnly 價值，並回傳一個值以表示轉換是否成功。
TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateOnly)	將指定的日期字元區間轉換為等 DateOnly 價值，並回傳一個值以表示轉換是否成功。
TryParseExact(String, String, DateOnly)	將指定的日期字串表示轉換為 DateOnly 其對應的日期，並使用指定的格式與樣式。 字串表示的格式必須完全符合指定的格式。 方法會傳回值，指出轉換是否成功。
TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateOnly)	利用指定的格式、文化特定格式資訊及樣式，將指定的日期跨度表示轉換為 DateOnly 其對應的日期。 字串表示的格式必須完全符合指定的格式。 方法會傳回值，指出轉換是否成功。
TryParseExact(String, String[], DateOnly)	將指定日期字串轉換為其 DateOnly 對應值，並回傳一個表示轉換是否成功的值。
TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateOnly)	將指定日期字串轉換為其 DateOnly 對應值，並回傳一個表示轉換是否成功的值。

操作員

名稱	Description
Equality(DateOnly, DateOnly)	判斷兩個指定的 實 DateOnly 例是否相等。
GreaterThan(DateOnly, DateOnly)	判斷某個指定 DateOnly 是否比另一個指定日期更晚。
GreaterThanOrEqual(DateOnly, DateOnly)	判斷某一指定日期僅代表與另一個指定 DateOnly日期相同或晚於 。
Inequality(DateOnly, DateOnly)	判斷兩個指定的 實 DateOnly 例是否不相等。
LessThan(DateOnly, DateOnly)	判斷一個指定 DateOnly 是否比另一個更 DateOnly早。
LessThanOrEqual(DateOnly, DateOnly)	判斷某一指定 DateOnly 日期是否與另一指定 DateOnly日期相同或更早。