DateOnly Struktura
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentuje daty z wartościami od 1 stycznia 0001 Anno Domini (Common Era) do 31 grudnia 9999 R. (C.E.) w kalendarzu gregoriańskim.
public value class DateOnly : IComparable, IComparable<DateOnly>, IEquatable<DateOnly>, IParsable<DateOnly>, ISpanFormattable, ISpanParsable<DateOnly>, IUtf8SpanFormattable
public value class DateOnly : IComparable, IComparable<DateOnly>, IEquatable<DateOnly>, ISpanFormattable
public value class DateOnly : IComparable, IComparable<DateOnly>, IEquatable<DateOnly>, IParsable<DateOnly>, ISpanFormattable, ISpanParsable<DateOnly>
public readonly struct DateOnly : IComparable, IComparable<DateOnly>, IEquatable<DateOnly>, IParsable<DateOnly>, ISpanFormattable, ISpanParsable<DateOnly>, IUtf8SpanFormattable
public readonly struct DateOnly : IComparable, IComparable<DateOnly>, IEquatable<DateOnly>, ISpanFormattable
public readonly struct DateOnly : IComparable, IComparable<DateOnly>, IEquatable<DateOnly>, IParsable<DateOnly>, ISpanFormattable, ISpanParsable<DateOnly>
type DateOnly = struct
interface IFormattable
interface IParsable<DateOnly>
interface ISpanFormattable
interface ISpanParsable<DateOnly>
interface IUtf8SpanFormattable
type DateOnly = struct
interface ISpanFormattable
interface IFormattable
type DateOnly = struct
interface IFormattable
interface IParsable<DateOnly>
interface ISpanFormattable
interface ISpanParsable<DateOnly>
Public Structure DateOnly
Implements IComparable, IComparable(Of DateOnly), IEquatable(Of DateOnly), IParsable(Of DateOnly), ISpanFormattable, ISpanParsable(Of DateOnly), IUtf8SpanFormattable
Public Structure DateOnly
Implements IComparable, IComparable(Of DateOnly), IEquatable(Of DateOnly), ISpanFormattable
Public Structure DateOnly
Implements IComparable, IComparable(Of DateOnly), IEquatable(Of DateOnly), IParsable(Of DateOnly), ISpanFormattable, ISpanParsable(Of DateOnly)
- Dziedziczenie
- Implementuje
Uwagi
Metody TryParse i TryParseExact zwracają false dane wejściowe, gdy dane wejściowe nie są zgodne z prawidłowym formatem. W .NET 11 i nowszych zgłaszająArgumentException, gdy podany DateTimeStyles specyfikator wartości lub formatu jest nieprawidłowy.
Konstruktory
| Nazwisko | Opis |
|---|---|
| DateOnly(Int32, Int32, Int32, Calendar) |
Tworzy nowe wystąpienie DateOnly struktury do określonego roku, miesiąca i dnia dla określonego kalendarza. |
| DateOnly(Int32, Int32, Int32) |
Tworzy nowe wystąpienie DateOnly struktury do określonego roku, miesiąca i dnia. |
Właściwości
| Nazwisko | Opis |
|---|---|
| Day |
Pobiera składnik dnia daty reprezentowanej przez to wystąpienie. |
| DayNumber |
Pobiera liczbę dni od 1 stycznia 0001 w kalendarzu Proleptic Gregorian reprezentowanym przez to wystąpienie. |
| DayOfWeek |
Pobiera dzień tygodnia reprezentowany przez to wystąpienie. |
| DayOfYear |
Pobiera dzień roku reprezentowany przez to wystąpienie. |
| MaxValue |
Pobiera najnowszą możliwą datę, którą można utworzyć. |
| MinValue |
Pobiera najwcześniejszą możliwą datę, którą można utworzyć. |
| Month |
Pobiera składnik miesiąca daty reprezentowanej przez to wystąpienie. |
| Year |
Pobiera składnik roku daty reprezentowanej przez to wystąpienie. |
Metody
| Nazwisko | Opis |
|---|---|
| AddDays(Int32) |
Dodaje określoną liczbę dni do wartości tego wystąpienia. |
| AddMonths(Int32) |
Dodaje określoną liczbę miesięcy do wartości tego wystąpienia. |
| AddYears(Int32) |
Dodaje określoną liczbę lat do wartości tego wystąpienia. |
| CompareTo(DateOnly) |
Porównuje wartość tego wystąpienia z określoną DateOnly wartością i zwraca liczbę całkowitą wskazującą, czy to wystąpienie jest wcześniejsze niż, takie samo jak lub nowsze niż określona DateOnly wartość. |
| CompareTo(Object) |
Porównuje wartość tego wystąpienia z określonym obiektem zawierającym określoną DateOnly wartość i zwraca liczbę całkowitą wskazującą, czy to wystąpienie jest wcześniejsze niż, takie samo jak lub nowsze niż określona DateOnly wartość. |
| Deconstruct(Int32, Int32, Int32) | |
| Equals(DateOnly) |
Zwraca wartość wskazującą, czy wartość tego wystąpienia jest równa wartości określonego DateOnly wystąpienia. |
| Equals(Object) |
Zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. |
| FromDateTime(DateTime) |
DateOnly Zwraca wystąpienie ustawione na część daty określonego |
| FromDayNumber(Int32) |
Tworzy nowe wystąpienie DateOnly struktury do określonej liczby dni. |
| GetHashCode() |
Zwraca kod skrótu dla tego wystąpienia. |
| Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) |
Konwertuje zakres pamięci, który zawiera ciąg reprezentujący datę na jej DateOnly odpowiednik przy użyciu informacji o formacie specyficznym dla kultury i stylu formatowania. |
| Parse(ReadOnlySpan<Char>, IFormatProvider) |
Analizuje zakres znaków w wartości. |
| Parse(String, IFormatProvider, DateTimeStyles) |
Konwertuje ciąg zawierający ciąg reprezentujący datę na jej DateOnly odpowiednik przy użyciu informacji o formacie specyficznym dla kultury i stylu formatowania. |
| Parse(String, IFormatProvider) |
Analizuje ciąg w wartości. |
| Parse(String) |
Konwertuje ciąg zawierający ciąg reprezentujący datę na jej DateOnly odpowiednik przy użyciu konwencji bieżącej kultury. |
| ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) |
Konwertuje określoną reprezentację zakresu daty na równoważną DateOnly przy użyciu określonego formatu, informacji o formacie specyficznym dla kultury i stylu. Format reprezentacji ciągu musi być zgodny z określonym formatem lub zgłaszany jest wyjątek. |
| ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles) |
Konwertuje określoną reprezentację zakresu daty na równoważną DateOnly przy użyciu określonej tablicy formatów, informacji o formacie specyficznym dla kultury i stylu. Format reprezentacji ciągu musi być zgodny z co najmniej jednym z określonych formatów dokładnie lub zgłaszany jest wyjątek. |
| ParseExact(ReadOnlySpan<Char>, String[]) |
Konwertuje określoną reprezentację zakresu daty na równoważną DateOnly przy użyciu określonej tablicy formatów. Format reprezentacji ciągu musi być zgodny z co najmniej jednym z określonych formatów dokładnie lub zgłaszany jest wyjątek. |
| ParseExact(String, String, IFormatProvider, DateTimeStyles) |
Konwertuje określoną reprezentację ciągu daty na jej DateOnly odpowiednik przy użyciu określonego formatu, informacji o formacie specyficznym dla kultury i stylu. Format reprezentacji ciągu musi być zgodny z określonym formatem lub zgłaszany jest wyjątek. |
| ParseExact(String, String) |
Konwertuje określoną reprezentację ciągu daty na jej DateOnly odpowiednik przy użyciu określonego formatu. Format reprezentacji ciągu musi być zgodny z określonym formatem lub zgłaszany jest wyjątek. |
| ParseExact(String, String[], IFormatProvider, DateTimeStyles) |
Konwertuje określoną reprezentację ciągu daty na równoważną DateOnly przy użyciu określonej tablicy formatów, informacji o formacie specyficznym dla kultury i stylu. Format reprezentacji ciągu musi być zgodny z co najmniej jednym z określonych formatów dokładnie lub zgłaszany jest wyjątek. |
| ParseExact(String, String[]) |
Konwertuje określoną reprezentację zakresu daty na równoważną DateOnly przy użyciu określonej tablicy formatów. Format reprezentacji ciągu musi być zgodny z co najmniej jednym z określonych formatów dokładnie lub zgłaszany jest wyjątek. |
| ToDateTime(TimeOnly, DateTimeKind) |
Zwraca wystąpienie z określonym typem DateTime danych wejściowych ustawionym na datę tego DateOnly wystąpienia i godzinę określonego czasu wejściowego. |
| ToDateTime(TimeOnly) |
Zwraca wartość ustawioną DateTime na datę tego DateOnly wystąpienia i godzinę określonego czasu wejściowego. |
| ToLongDateString() |
Konwertuje wartość bieżącego DateOnly obiektu na równoważną reprezentację ciągu daty długiej. |
| ToShortDateString() |
Konwertuje wartość bieżącego DateOnly obiektu na równoważną reprezentację ciągu daty krótkiej. |
| ToString() |
Konwertuje wartość bieżącego DateOnly obiektu na równoważną reprezentację ciągu przy użyciu konwencji formatowania bieżącej kultury. Obiekt DateOnly zostanie sformatowany w krótkiej postaci. |
| ToString(IFormatProvider) |
Konwertuje wartość bieżącego DateOnly obiektu na równoważną reprezentację ciągu przy użyciu określonych informacji o formacie specyficznym dla kultury. |
| ToString(String, IFormatProvider) |
Konwertuje wartość bieżącego DateOnly obiektu na równoważną reprezentację ciągu przy użyciu określonych informacji o formacie specyficznym dla kultury. |
| ToString(String) |
Konwertuje wartość bieżącego DateOnly obiektu na równoważną reprezentację ciągu przy użyciu określonego formatu i konwencji formatowania bieżącej kultury. |
| TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider) |
Próbuje sformatować wartość bieżącego wystąpienia jako UTF-8 w podanym zakresie bajtów. |
| TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) |
Próbuje sformatować wartość bieżącego DateOnly wystąpienia w podanym zakresie znaków. |
| TryParse(ReadOnlySpan<Char>, DateOnly) |
Konwertuje określoną reprezentację zakresu daty na DateOnly równoważną i zwraca wartość wskazującą, czy konwersja zakończyła się pomyślnie. |
| TryParse(ReadOnlySpan<Char>, IFormatProvider, DateOnly) |
Próbuje przeanalizować zakres znaków w wartości. |
| TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateOnly) |
Konwertuje określoną reprezentację zakresu daty na równoważną DateOnly przy użyciu określonej tablicy formatów, informacji o formacie specyficznym dla kultury i stylu. Zwraca wartość wskazującą, czy konwersja zakończyła się pomyślnie. |
| TryParse(String, DateOnly) |
Konwertuje określoną reprezentację ciągu daty na równoważną DateOnly i zwraca wartość wskazującą, czy konwersja zakończyła się pomyślnie. |
| TryParse(String, IFormatProvider, DateOnly) |
Próbuje przeanalizować ciąg w wartości. |
| TryParse(String, IFormatProvider, DateTimeStyles, DateOnly) |
Konwertuje określoną reprezentację ciągu daty na równoważną DateOnly przy użyciu określonej tablicy formatów, informacji o formacie specyficznym dla kultury i stylu. Zwraca wartość wskazującą, czy konwersja zakończyła się pomyślnie. |
| TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, DateOnly) |
Konwertuje określoną reprezentację zakresu daty na jej DateOnly odpowiednik przy użyciu określonego formatu i stylu. Format reprezentacji ciągu musi być dokładnie zgodny z określonym formatem. Metoda zwraca wartość wskazującą, czy konwersja powiodła się. |
| TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateOnly) |
Konwertuje określoną reprezentację zakresu daty na równoważną DateOnlyprzy użyciu określonego formatu, informacji o formacie specyficznym dla kultury i stylu. Format reprezentacji ciągu musi być dokładnie zgodny z określonym formatem. Metoda zwraca wartość wskazującą, czy konwersja powiodła się. |
| TryParseExact(ReadOnlySpan<Char>, String[], DateOnly) |
Konwertuje określony zakres znaków daty na DateOnly odpowiednik i zwraca wartość wskazującą, czy konwersja zakończyła się pomyślnie. |
| TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateOnly) |
Konwertuje określony zakres znaków daty na DateOnly odpowiednik i zwraca wartość wskazującą, czy konwersja zakończyła się pomyślnie. |
| TryParseExact(String, String, DateOnly) |
Konwertuje określoną reprezentację ciągu daty na jej DateOnly odpowiednik przy użyciu określonego formatu i stylu. Format reprezentacji ciągu musi być dokładnie zgodny z określonym formatem. Metoda zwraca wartość wskazującą, czy konwersja powiodła się. |
| TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateOnly) |
Konwertuje określoną reprezentację zakresu daty na równoważną DateOnly przy użyciu określonego formatu, informacji o formacie specyficznym dla kultury i stylu. Format reprezentacji ciągu musi być dokładnie zgodny z określonym formatem. Metoda zwraca wartość wskazującą, czy konwersja powiodła się. |
| TryParseExact(String, String[], DateOnly) |
Konwertuje określony ciąg daty na odpowiednik DateOnly i zwraca wartość wskazującą, czy konwersja zakończyła się pomyślnie. |
| TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateOnly) |
Konwertuje określony ciąg daty na odpowiednik DateOnly i zwraca wartość wskazującą, czy konwersja zakończyła się pomyślnie. |
Operatory
| Nazwisko | Opis |
|---|---|
| Equality(DateOnly, DateOnly) |
Określa, czy dwa określone wystąpienia DateOnly są równe. |
| GreaterThan(DateOnly, DateOnly) |
Określa, czy określona wartość DateOnly jest późniejsza niż inna określona dataOnly. |
| GreaterThanOrEqual(DateOnly, DateOnly) |
Określa, czy jedna określona wartość DateOnly reprezentuje datę, która jest taka sama, jak lub nowsza niż inna określona wartość DateOnly. |
| Inequality(DateOnly, DateOnly) |
Określa, czy dwa określone wystąpienia DateOnly nie są równe. |
| LessThan(DateOnly, DateOnly) |
Określa, czy określony element DateOnly jest wcześniejszy niż inny określony DateOnly. |
| LessThanOrEqual(DateOnly, DateOnly) |
Określa, czy określony reprezentuje DateOnly datę, która jest taka sama, jak lub wcześniejsza niż inna określona DateOnly. |