Idioma

DateOnly Estrutura

Definição

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
DateOnly
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)

Desconstrui DateOnly por Year, Monthe Day.

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 dateTime.

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.

Aplica-se a