DateOnly Estrutura
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa datas com valores que variam de 1º de janeiro de 0001 Anno Domini (Common Era) a 31 de dezembro de 9999 D.C. (C.E.) no calendário gregoriano.
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)
- Herança
- Implementações
Comentários
Os TryParse métodos e TryParseExact os métodos retornam false quando a entrada não corresponde a um formato válido. Em .NET 11 e posteriores, eles são gerados ArgumentException quando um especificador de formato ou valor fornecido DateTimeStyles é inválido.
Construtores
| Nome | Description |
|---|---|
| DateOnly(Int32, Int32, Int32, Calendar) |
Cria uma nova instância da DateOnly estrutura para o ano, mês e dia especificados para o calendário especificado. |
| DateOnly(Int32, Int32, Int32) |
Cria uma nova instância da DateOnly estrutura para o ano, mês e dia especificados. |
Propriedades
| Nome | Description |
|---|---|
| Day |
Obtém o componente de dia da data representada por essa instância. |
| DayNumber |
Obtém o número de dias desde 1º de janeiro de 0001 no calendário gregoriano proleptico representado por essa instância. |
| DayOfWeek |
Obtém o dia da semana representado por essa instância. |
| DayOfYear |
Obtém o dia do ano representado por essa instância. |
| MaxValue |
Obtém a data mais recente possível que pode ser criada. |
| MinValue |
Obtém a data mais antiga possível que pode ser criada. |
| Month |
Obtém o componente mensal da data representada por essa instância. |
| Year |
Obtém o componente de ano da data representada por essa instância. |
Métodos
| Nome | Description |
|---|---|
| AddDays(Int32) |
Adiciona o número especificado de dias ao valor dessa instância. |
| AddMonths(Int32) |
Adiciona o número especificado de meses ao valor dessa instância. |
| AddYears(Int32) |
Adiciona o número especificado de anos ao valor dessa instância. |
| CompareTo(DateOnly) |
Compara o valor dessa instância com um valor especificado DateOnly e retorna um inteiro que indica se essa instância é anterior, igual ou posterior ao valor especificado DateOnly . |
| CompareTo(Object) |
Compara o valor dessa instância com um objeto especificado que contém um valor especificado DateOnly e retorna um inteiro que indica se essa instância é anterior, igual ou posterior ao valor especificado DateOnly . |
| Deconstruct(Int32, Int32, Int32) | |
| Equals(DateOnly) |
Retorna um valor que indica se o valor dessa instância é igual ao valor da instância especificada DateOnly . |
| Equals(Object) |
Retorna um valor que indica se essa instância é igual a um objeto especificado. |
| FromDateTime(DateTime) |
Retorna uma DateOnly instância definida como a parte de data do especificado |
| FromDayNumber(Int32) |
Cria uma nova instância da DateOnly estrutura para o número de dias especificado. |
| GetHashCode() |
Devolve o código hash para esta instância. |
| Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) |
Converte um intervalo de memória que contém a representação de cadeia de caracteres de uma data em seu DateOnly equivalente usando informações de formato específicas da cultura e um estilo de formatação. |
| Parse(ReadOnlySpan<Char>, IFormatProvider) |
Analisa um intervalo de caracteres em um valor. |
| Parse(String, IFormatProvider, DateTimeStyles) |
Converte uma cadeia de caracteres que contém a representação de cadeia de caracteres de uma data em seu DateOnly equivalente usando informações de formato específicas da cultura e um estilo de formatação. |
| Parse(String, IFormatProvider) |
Analisa uma cadeia de caracteres em um valor. |
| Parse(String) |
Converte uma cadeia de caracteres que contém a representação de cadeia de caracteres de uma data em seu DateOnly equivalente usando as convenções da cultura atual. |
| ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) |
Converte a representação de intervalo especificada de uma data em seu DateOnly equivalente usando o formato especificado, as informações de formato específicas da cultura e o estilo. O formato da representação de cadeia de caracteres deve corresponder exatamente ao formato especificado ou uma exceção é gerada. |
| ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles) |
Converte a representação de intervalo especificada de uma data em seu DateOnly equivalente usando a matriz especificada de formatos, informações de formato específicas da cultura e estilo. O formato da representação de cadeia de caracteres deve corresponder a pelo menos um dos formatos especificados exatamente ou uma exceção é gerada. |
| ParseExact(ReadOnlySpan<Char>, String[]) |
Converte a representação de intervalo especificada de uma data em seu DateOnly equivalente usando a matriz de formatos especificada. O formato da representação de cadeia de caracteres deve corresponder a pelo menos um dos formatos especificados exatamente ou uma exceção é gerada. |
| ParseExact(String, String, IFormatProvider, DateTimeStyles) |
Converte a representação de cadeia de caracteres especificada de uma data em seu DateOnly equivalente usando o formato especificado, as informações de formato específicas da cultura e o estilo. O formato da representação de cadeia de caracteres deve corresponder exatamente ao formato especificado ou uma exceção é gerada. |
| ParseExact(String, String) |
Converte a representação de cadeia de caracteres especificada de uma data em seu DateOnly equivalente usando o formato especificado. O formato da representação de cadeia de caracteres deve corresponder exatamente ao formato especificado ou uma exceção é gerada. |
| ParseExact(String, String[], IFormatProvider, DateTimeStyles) |
Converte a representação de cadeia de caracteres especificada de uma data em seu DateOnly equivalente usando a matriz especificada de formatos, informações de formato específicas da cultura e estilo. O formato da representação de cadeia de caracteres deve corresponder a pelo menos um dos formatos especificados exatamente ou uma exceção é gerada. |
| ParseExact(String, String[]) |
Converte a representação de intervalo especificada de uma data em seu DateOnly equivalente usando a matriz de formatos especificada. O formato da representação de cadeia de caracteres deve corresponder a pelo menos um dos formatos especificados exatamente ou uma exceção é gerada. |
| ToDateTime(TimeOnly, DateTimeKind) |
Retorna uma DateTime instância com o tipo de entrada especificado definido como a data dessa DateOnly instância e a hora da hora de entrada especificada. |
| ToDateTime(TimeOnly) |
Retorna um DateTime que é definido como a data dessa DateOnly instância e a hora da hora de entrada especificada. |
| ToLongDateString() |
Converte o valor do objeto atual DateOnly em sua representação de cadeia de caracteres de data longa equivalente. |
| ToShortDateString() |
Converte o valor do objeto atual DateOnly em sua representação de cadeia de caracteres de data curta equivalente. |
| ToString() |
Converte o valor do objeto atual DateOnly em sua representação de cadeia de caracteres equivalente usando as convenções de formatação da cultura atual. O DateOnly objeto será formatado em formato curto. |
| ToString(IFormatProvider) |
Converte o valor do objeto atual DateOnly em sua representação de cadeia de caracteres equivalente usando as informações de formato específicas da cultura especificadas. |
| ToString(String, IFormatProvider) |
Converte o valor do objeto atual DateOnly em sua representação de cadeia de caracteres equivalente usando as informações de formato específicas da cultura especificadas. |
| ToString(String) |
Converte o valor do objeto atual DateOnly em sua representação de cadeia de caracteres equivalente usando o formato especificado e as convenções de formatação da cultura atual. |
| TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider) |
Tenta formatar o valor da instância atual como UTF-8 no intervalo de bytes fornecido. |
| TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) |
Tenta formatar o valor da instância atual DateOnly no intervalo de caracteres fornecido. |
| TryParse(ReadOnlySpan<Char>, DateOnly) |
Converte a representação de intervalo especificada de uma data em seu DateOnly equivalente e retorna um valor que indica se a conversão foi bem-sucedida. |
| TryParse(ReadOnlySpan<Char>, IFormatProvider, DateOnly) |
Tenta analisar um intervalo de caracteres em um valor. |
| TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateOnly) |
Converte a representação de intervalo especificada de uma data em seu DateOnly equivalente usando a matriz especificada de formatos, informações de formato específicas da cultura e estilo. E retorna um valor que indica se a conversão foi bem-sucedida. |
| TryParse(String, DateOnly) |
Converte a representação de cadeia de caracteres especificada de uma data em seu DateOnly equivalente e retorna um valor que indica se a conversão foi bem-sucedida. |
| TryParse(String, IFormatProvider, DateOnly) |
Tenta analisar uma cadeia de caracteres em um valor. |
| TryParse(String, IFormatProvider, DateTimeStyles, DateOnly) |
Converte a representação de cadeia de caracteres especificada de uma data em seu DateOnly equivalente usando a matriz especificada de formatos, informações de formato específicas da cultura e estilo. E retorna um valor que indica se a conversão foi bem-sucedida. |
| TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, DateOnly) |
Converte a representação de intervalo especificada de uma data em seu DateOnly equivalente usando o formato e o estilo especificados. O formato da representação de cadeia de caracteres deve corresponder exatamente ao formato especificado. O método retorna um valor que indica se a conversão foi bem-sucedida. |
| TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateOnly) |
Converte a representação de intervalo especificada de uma data em seu DateOnlyequivalente usando o formato especificado, as informações de formato específicas da cultura e o estilo. O formato da representação de cadeia de caracteres deve corresponder exatamente ao formato especificado. O método retorna um valor que indica se a conversão foi bem-sucedida. |
| TryParseExact(ReadOnlySpan<Char>, String[], DateOnly) |
Converte o intervalo de caracteres especificado de uma data em seu DateOnly equivalente e retorna um valor que indica se a conversão foi bem-sucedida. |
| TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateOnly) |
Converte o intervalo de caracteres especificado de uma data em seu DateOnly equivalente e retorna um valor que indica se a conversão foi bem-sucedida. |
| TryParseExact(String, String, DateOnly) |
Converte a representação de cadeia de caracteres especificada de uma data em seu DateOnly equivalente usando o formato e o estilo especificados. O formato da representação de cadeia de caracteres deve corresponder exatamente ao formato especificado. O método retorna um valor que indica se a conversão foi bem-sucedida. |
| TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateOnly) |
Converte a representação de intervalo especificada de uma data em seu DateOnly equivalente usando o formato especificado, as informações de formato específicas da cultura e o estilo. O formato da representação de cadeia de caracteres deve corresponder exatamente ao formato especificado. O método retorna um valor que indica se a conversão foi bem-sucedida. |
| TryParseExact(String, String[], DateOnly) |
Converte a cadeia de caracteres especificada de uma data em seu DateOnly equivalente e retorna um valor que indica se a conversão foi bem-sucedida. |
| TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateOnly) |
Converte a cadeia de caracteres especificada de uma data em seu DateOnly equivalente e retorna um valor que indica se a conversão foi bem-sucedida. |
Operadores
| Nome | Description |
|---|---|
| Equality(DateOnly, DateOnly) |
Determina se duas instâncias especificadas são iguais DateOnly . |
| GreaterThan(DateOnly, DateOnly) |
Determina se um especificado DateOnly é posterior a outro DateOnly especificado. |
| GreaterThanOrEqual(DateOnly, DateOnly) |
Determina se um DateOnly especificado representa uma data igual ou posterior a outra especificada DateOnly. |
| Inequality(DateOnly, DateOnly) |
Determina se duas instâncias especificadas não são iguais DateOnly . |
| LessThan(DateOnly, DateOnly) |
Determina se um especificado DateOnly é anterior a outro especificado DateOnly. |
| LessThanOrEqual(DateOnly, DateOnly) |
Determina se um especificado DateOnly representa uma data igual ou anterior a outra especificada DateOnly. |