DateTime Estrutura

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

DateTime.cs

Representa um momento no tempo, geralmente expresso como uma data e hora do dia.

public value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IParsable<DateTime>, ISpanFormattable, ISpanParsable<DateTime>, IUtf8SpanFormattable, System::Runtime::Serialization::ISerializable

public readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IParsable<DateTime>, ISpanFormattable, ISpanParsable<DateTime>, IUtf8SpanFormattable, System.Runtime.Serialization.ISerializable

type DateTime = struct
    interface IConvertible
    interface IFormattable
    interface IParsable<DateTime>
    interface ISpanFormattable
    interface ISpanParsable<DateTime>
    interface ISerializable
    interface IUtf8SpanFormattable

Public Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IParsable(Of DateTime), ISerializable, ISpanFormattable, ISpanParsable(Of DateTime), IUtf8SpanFormattable

Herança

Object

ValueType

DateTime

Implementações

IComparable IComparable<DateTime> IConvertible IEquatable<DateTime> IFormattable ISerializable ISpanFormattable IParsable<DateTime> IParsable<TSelf> ISpanParsable<DateTime> IUtf8SpanFormattable

Comentários

Para obter mais informações sobre essa API, consulte Comentários da API complementar para DateTime.

Construtores

DateTime(DateOnly, TimeOnly)	Inicializa uma nova instância da DateTime estrutura para o e o especificados DateOnlyTimeOnly. A nova instância terá o Unspecified tipo .
DateTime(DateOnly, TimeOnly, DateTimeKind)	Inicializa uma nova instância da DateTime estrutura para o especificado DateOnly e TimeOnly respeitando o especificado DateTimeKind.
DateTime(Int32, Int32, Int32)	Inicializa uma nova instância da estrutura DateTime para o ano, o mês e o dia especificados.
DateTime(Int32, Int32, Int32, Calendar)	Inicializa uma nova instância da estrutura DateTime para o ano, o mês e o dia especificados do calendário especificado.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32)	Inicializa uma nova instância da estrutura DateTime para o ano, mês, dia, hora, minuto e segundo especificados.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Inicializa uma nova instância da estrutura DateTime para o ano, mês, dia, hora, minuto e segundo especificados para o calendário especificado.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Inicializa uma nova instância da estrutura DateTime para o ano, o mês, o dia, a hora, o minuto, o segundo e o UTC (Tempo Universal Coordenado) especificados ou para a hora local.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Inicializa uma nova instância da estrutura DateTime para o ano, mês, dia, hora, minuto, segundo e milissegundo especificados.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Inicializa uma nova instância da estrutura DateTime para o ano, mês, dia, hora, minuto, segundo e milissegundo especificados para o calendário especificado.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)	Inicializa uma nova instância da estrutura DateTime com ano, mês, dia, hora, minuto, segundo, milissegundo e UTC (Tempo Universal Coordenado) ou hora local especificados para o calendário especificado.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Inicializa uma nova instância da estrutura DateTime com o ano, mês, dia, hora, minuto, segundo, milissegundo e UTC (Tempo Universal Coordenado) ou hora local especificados.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Inicializa uma nova instância da estrutura DateTime com ano, mês, dia, hora, minuto, segundo, milissegundo e UTC (Tempo Universal Coordenado) ou hora local especificados para o calendário especificado.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Inicializa uma nova instância da estrutura DateTime com ano, mês, dia, hora, minuto, segundo, milissegundo e UTC (Tempo Universal Coordenado) ou hora local especificados para o calendário especificado.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)	Inicializa uma nova instância da estrutura DateTime com ano, mês, dia, hora, minuto, segundo, milissegundo e UTC (Tempo Universal Coordenado) ou hora local especificados para o calendário especificado.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)	Inicializa uma nova instância da estrutura DateTime com ano, mês, dia, hora, minuto, segundo, milissegundo e UTC (Tempo Universal Coordenado) ou hora local especificados para o calendário especificado.
DateTime(Int64)	Inicializa uma nova instância da estrutura DateTime para um número especificado de tiques.
DateTime(Int64, DateTimeKind)	Inicializa uma nova instância da estrutura DateTime para o número de tiques especificado e para o UTC (Tempo Universal Coordenado) ou para a hora local.

Campos

MaxValue	Representa o maior valor possível de DateTime. Este campo é somente leitura.
MinValue	Representa o menor valor possível de DateTime. Este campo é somente leitura.
UnixEpoch	O valor dessa constante é equivalente a 00:00:00.0000000 UTC, 1º de janeiro de 1970, no calendário gregoriano. UnixEpoch define o ponto no tempo quando o horário do Unix é igual a 0.

Propriedades

Date	Obtém o componente de data da instância.
Day	Obtém o dia do mês 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.
Hour	Obtém o componente de hora da data representada por essa instância.
Kind	Obtém um valor que indica se a hora representada por essa instância é baseada na hora local, no UTC (Tempo Universal Coordenado) ou em nenhum dos dois.
Microsecond	O componente microssegundos, expresso como um valor entre 0 e 999.
Millisecond	Obtém o componente de milissegundos da data representada por essa instância.
Minute	Obtém o componente de minuto da data representada por essa instância.
Month	Obtém o componente de mês da data representada por essa instância.
Nanosecond	O componente nanossegundos, expresso como um valor entre 0 e 900 (em incrementos de 100 nanossegundos).
Now	Obtém um objeto DateTime definido como a data e hora atuais neste computador, expressas como a hora local.
Second	Obtém o componente de segundos da data representada por essa instância.
Ticks	Obtém o número de tiques que representam a data e hora dessa instância.
TimeOfDay	Obtém a hora do dia para esta instância.
Today	Obtém a data atual.
UtcNow	Obtém um objeto DateTime definido como a data e hora atual neste computador, expressas como o UTC (Tempo Universal Coordenado).
Year	Obtém o componente de ano da data representada por essa instância.

Métodos

Add(TimeSpan)	Retorna um novo DateTime que adiciona o valor do TimeSpan especificado ao valor dessa instância.
AddDays(Double)	Retorna um novo DateTime que adiciona o número especificado de dias ao valor dessa instância.
AddHours(Double)	Retorna um novo DateTime que adiciona o número especificado de horas ao valor dessa instância.
AddMicroseconds(Double)	Retorna um novo DateTime que adiciona o número especificado de microssegundos ao valor dessa instância.
AddMilliseconds(Double)	Retorna um novo DateTime que adiciona o número especificado de milissegundos ao valor dessa instância.
AddMinutes(Double)	Retorna um novo DateTime que adiciona o número especificado de minutos ao valor dessa instância.
AddMonths(Int32)	Retorna um novo DateTime que adiciona o número especificado de meses ao valor dessa instância.
AddSeconds(Double)	Retorna um novo DateTime que adiciona o número especificado de segundos ao valor dessa instância.
AddTicks(Int64)	Retorna uma nova DateTime que adiciona o número de tiques especificado no valor dessa instância.
AddYears(Int32)	Retorna um novo DateTime que adiciona o número especificado de anos ao valor dessa instância.
Compare(DateTime, DateTime)	Compara duas instâncias do DateTime e retorna um inteiro que indica se a primeira instância é anterior, a mesma ou posterior à segunda instância.
CompareTo(DateTime)	Compara o valor dessa instância com um valor DateTime especificado e retorna um inteiro que indica se essa instância é anterior, igual ou posterior ao valor DateTime especificado.
CompareTo(Object)	Compara o valor dessa instância com um objeto especificado que contém um valor DateTime especificado e retorna um inteiro que indica se essa instância é anterior, igual ou posterior ao valor DateTime especificado.
DaysInMonth(Int32, Int32)	Retorna o número de dias no ano e mês especificado.
Deconstruct(DateOnly, TimeOnly)	Desconstrói essa DateTime instância por DateOnly e TimeOnly.
Deconstruct(Int32, Int32, Int32)	Desconstrói essa DateOnly instância por Year, Monthe Day.
Equals(DateTime)	Retorna um valor que indica se o valor dessa instância é igual ao valor da instância DateTime especificada.
Equals(DateTime, DateTime)	Retorna um valor que indica se duas DateTime instâncias têm o mesmo valor de data e hora.
Equals(Object)	Retorna um valor que indica se a instância é igual a um objeto especificado.
FromBinary(Int64)	Desserializa um valor binário de 64 bits e recria um objeto de DateTime original serializado.
FromFileTime(Int64)	Converte a hora de arquivo do Windows especificada em uma hora local equivalente.
FromFileTimeUtc(Int64)	Converte a hora de arquivo Windows especificada em uma hora UTC equivalente.
FromOADate(Double)	Retorna um DateTime equivalente à Data de Automação OLE especificada.
GetDateTimeFormats()	Converte o valor dessa instância em todas as representações de cadeia de caracteres com suporte nos especificadores de formato de data e hora padrão.
GetDateTimeFormats(Char)	Converte o valor dessa instância em todas as representações de cadeia de caracteres com suporte no especificador de formato de data e hora padrão especificado.
GetDateTimeFormats(Char, IFormatProvider)	Converte o valor dessa instância para todas as representações de cadeia de caracteres com suporte pelos especificadores de formato de data e hora e as informações de formatação específicas da cultura especificadas.
GetDateTimeFormats(IFormatProvider)	Converte o valor dessa instância para todas as representações de cadeia de caracteres com suporte pelos especificadores de formato de data e hora padrão e as informações de formatação específicas da cultura especificadas.
GetHashCode()	Retorna o código hash para a instância.
GetTypeCode()	Retorna o TypeCode para tipo de valor DateTime.
IsDaylightSavingTime()	Indica se esta instância do DateTime está dentro do intervalo de horário de verão para o fuso horário atual.
IsLeapYear(Int32)	Retorna uma indicação se o ano especificado é um ano bissexto.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Analisa um intervalo de caracteres em um valor.
Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	Converte um intervalo de memória que contém uma representação de cadeia de caracteres de uma data e hora em seu DateTime equivalente usando as informações de formato e um estilo de formatação específicos da cultura.
Parse(String)	Converte a representação de cadeia de caracteres de uma data e hora em seu DateTime equivalente usando as convenções da cultura atual.
Parse(String, IFormatProvider)	Converte a representação da cadeia de caracteres de uma data e hora em seu equivalente DateTime usando as informações de formato específicas da cultura.
Parse(String, IFormatProvider, DateTimeStyles)	Converte a representação de cadeia de caracteres de uma data e hora em seu DateTime equivalente usando as informações de formato e um estilo de formatação específicos da cultura.
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	Converte a representação de intervalo especificada de data e hora em seu equivalente DateTime 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 deverá corresponder exatamente ao formato especificado ou uma exceção será gerada.
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles)	Converte a representação de intervalo especificada de data e hora em seu equivalente DateTime usando a matriz de formatos especificada, as informações de formato específicas da cultura e o estilo. O formato da representação de cadeia de caracteres deverá corresponder a, pelo menos, um dos formatos especificados exatamente ou uma exceção será gerada.
ParseExact(String, String, IFormatProvider)	Converte a representação de cadeia de caracteres especificada de data e hora em seu equivalente DateTime usando o formato especificado e as informações de formato específicas da cultura. O formato de representação da cadeia de caracteres deve corresponder exatamente ao formato especificado.
ParseExact(String, String, IFormatProvider, DateTimeStyles)	Converte a representação de cadeia de caracteres especificada de data e hora em seu equivalente DateTime 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 deverá corresponder exatamente ao formato especificado ou uma exceção será gerada.
ParseExact(String, String[], IFormatProvider, DateTimeStyles)	Converte a representação de cadeia de caracteres especificada de um data e hora no equivalente de DateTime usando a matriz de formatos, informações de formato específicas da cultura e estilo especificados. O formato da representação de cadeia de caracteres deverá corresponder a, pelo menos, um dos formatos especificados exatamente ou uma exceção será gerada.
SpecifyKind(DateTime, DateTimeKind)	Cria um novo objeto DateTime que tem o mesmo número de tiques que o DateTime especificado, mas é designado como hora local, UTC (Tempo Universal Coordenado) ou nenhum dos dois, conforme indicado pelo valor DateTimeKind especificado.
Subtract(DateTime)	Retorna um novo TimeSpan que subtrai a data e hora especificados do valor dessa instância.
Subtract(TimeSpan)	Retorna um novo DateTime que subtrai a duração especificada do valor dessa instância.
ToBinary()	Serializa o objeto DateTime atual como um valor binário de 64 bits que posteriormente pode ser usado para recriar o objeto DateTime.
ToFileTime()	Converte o valor do objeto DateTime atual para uma hora de arquivo do Windows.
ToFileTimeUtc()	Converte o valor do objeto DateTime atual para uma hora de arquivo do Windows.
ToLocalTime()	Converte o valor do objeto DateTime atual para a hora local.
ToLongDateString()	Converte o valor do atual objeto DateTime na representação de cadeia de caracteres de data completa equivalente.
ToLongTimeString()	Converte o valor do atual objeto DateTime na representação de cadeia de caracteres de hora completa equivalente.
ToOADate()	Converte o valor dessa instância na data de Automação OLE equivalente.
ToShortDateString()	Converte o valor do atual objeto DateTime na representação de cadeia de caracteres de data abreviada equivalente.
ToShortTimeString()	Converte o valor do objeto DateTime atual na representação de cadeia de caracteres de hora abreviada equivalente.
ToString()	Converte o valor do atual objeto DateTime na representação de cadeia de caracteres equivalente usando as convenções de formatação da cultura atual.
ToString(IFormatProvider)	Converte o valor do objeto DateTime atual para sua representação de cadeia de caracteres equivalente usando as informações de formato específicas da cultura especificada.
ToString(String)	Converte o valor do atual objeto DateTime na representação de cadeia de caracteres equivalente usando o formato especificado e as convenções de formatação da cultura atual.
ToString(String, IFormatProvider)	Converte o valor do atual objeto DateTime na representação de cadeia de caracteres equivalente usando o formato especificado e as informações de formato específicas da cultura.
ToUniversalTime()	Converte o valor do atual objeto DateTime em UTC (Tempo Universal Coordenado).
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 de datetime atual para o intervalo de caracteres fornecido.
TryParse(ReadOnlySpan<Char>, DateTime)	Converte o intervalo de caracteres especificado de uma data e hora no equivalente de DateTime e retorna um valor que indica se a conversão foi bem-sucedida.
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTime)	Tenta analisar um intervalo de caracteres em um valor.
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)	Converte a representação de intervalo de uma data e hora no equivalente de DateTime usando as informações de formato específicas da cultura e o estilo de formatação especificados e retorna um valor que indica se a conversão foi bem-sucedida.
TryParse(String, DateTime)	Converte a representação de cadeia de caracteres especificada de uma data e hora no equivalente de DateTime e retorna um valor que indica se a conversão foi bem-sucedida.
TryParse(String, IFormatProvider, DateTime)	Tenta analisar uma cadeia de caracteres em um valor.
TryParse(String, IFormatProvider, DateTimeStyles, DateTime)	Converte a representação de cadeia de caracteres especificada de uma data e hora no equivalente de DateTime usando as informações de formato específicas da cultura e estilo de formatação especificados e retorna um valor que indica se a conversão foi bem-sucedida.
TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)	Converte a representação de intervalo especificada de data e hora em seu equivalente DateTime usando o formato especificado, as informações de formato específicas da cultura e o estilo. O formato de representação da 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[], IFormatProvider, DateTimeStyles, DateTime)	Converte o intervalo de caracteres especificado de uma data e hora no equivalente de DateTime e retorna um valor que indica se a conversão foi bem-sucedida.
TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)	Converte a representação de cadeia de caracteres especificada de data e hora em seu equivalente DateTime usando o formato especificado, as informações de formato específicas da cultura e o estilo. O formato de representação da 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, DateTime)	Converte a representação de cadeia de caracteres especificada de um data e hora no equivalente de DateTime usando a matriz de formatos, informações de formato específicas da cultura e estilo especificados. O formato da representação da cadeia de caracteres deve corresponder exatamente a um dos formatos especificados pelo menos. O método retorna um valor que indica se a conversão foi bem-sucedida.

Operadores

Addition(DateTime, TimeSpan)	Subtrai um dado intervalo de tempo de uma data e hora especificada e retorna uma nova data e hora.
Equality(DateTime, DateTime)	Determina se duas instâncias especificadas do DateTime são iguais.
GreaterThan(DateTime, DateTime)	Determina se um DateTime especificado é posterior ao outro DateTime especificado.
GreaterThanOrEqual(DateTime, DateTime)	Determina se um DateTime especificado representa uma data e hora que seja igual ou posterior à outra DateTime especificada.
Inequality(DateTime, DateTime)	Determina se duas instâncias especificadas de DateTime não são iguais.
LessThan(DateTime, DateTime)	Determina se um DateTime especificado é anterior ao outro DateTime especificado.
LessThanOrEqual(DateTime, DateTime)	Determina se um DateTime especificado representa uma data e hora iguais ou anteriores à outra DateTime especificada.
Subtraction(DateTime, DateTime)	Subtrai uma data e hora especificada de outra data e hora especificada e retorna um intervalo de tempo.
Subtraction(DateTime, TimeSpan)	Subtrai um intervalo de tempo especificado de uma data e hora especificada e retorna uma nova data e hora.

Implantações explícitas de interface

IConvertible.ToBoolean(IFormatProvider)	Não há suporte para esta conversão. A tentativa de usar esse método lança um InvalidCastException.
IConvertible.ToByte(IFormatProvider)	Não há suporte para esta conversão. A tentativa de usar esse método lança um InvalidCastException.
IConvertible.ToChar(IFormatProvider)	Não há suporte para esta conversão. A tentativa de usar esse método lança um InvalidCastException.
IConvertible.ToDateTime(IFormatProvider)	Retorna o objeto DateTime atual.
IConvertible.ToDecimal(IFormatProvider)	Não há suporte para esta conversão. A tentativa de usar esse método lança um InvalidCastException.
IConvertible.ToDouble(IFormatProvider)	Não há suporte para esta conversão. A tentativa de usar esse método lança um InvalidCastException.
IConvertible.ToInt16(IFormatProvider)	Não há suporte para esta conversão. A tentativa de usar esse método lança um InvalidCastException.
IConvertible.ToInt32(IFormatProvider)	Não há suporte para esta conversão. A tentativa de usar esse método lança um InvalidCastException.
IConvertible.ToInt64(IFormatProvider)	Não há suporte para esta conversão. A tentativa de usar esse método lança um InvalidCastException.
IConvertible.ToSByte(IFormatProvider)	Não há suporte para esta conversão. A tentativa de usar esse método lança um InvalidCastException.
IConvertible.ToSingle(IFormatProvider)	Não há suporte para esta conversão. A tentativa de usar esse método lança um InvalidCastException.
IConvertible.ToType(Type, IFormatProvider)	Converte o objeto DateTime atual em um objeto de um tipo especificado.
IConvertible.ToUInt16(IFormatProvider)	Não há suporte para esta conversão. A tentativa de usar esse método lança um InvalidCastException.
IConvertible.ToUInt32(IFormatProvider)	Não há suporte para esta conversão. A tentativa de usar esse método lança um InvalidCastException.
IConvertible.ToUInt64(IFormatProvider)	Não há suporte para esta conversão. A tentativa de usar esse método lança um InvalidCastException.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Popula um objeto SerializationInfo com os dados necessários para serializar o objeto DateTime atual.

Acesso thread-safe

Todos os membros desse tipo são thread-safe. Os membros que aparentam modificar efetivamente o estado retornam uma nova instância inicializada com o novo valor. Assim como acontece com qualquer outro tipo, a leitura e a gravação em uma variável compartilhada que contém uma instância desse tipo devem ser protegidas por um bloqueio para garantir thread-safe.

Confira também

• DateTimeOffset
• TimeSpan
• Calendar
• GetUtcOffset(DateTime)
• TimeZoneInfo
• Escolhendo entre DateTime, DateTimeOffset, TimeSpan e TimeZoneInfo
• Trabalhando com calendários
• Amostra: Utilitário de Formatação do WinForms do .NET Core (C#)
• Amostra: Utilitário de Formatação do WinForms do .NET Core (Visual Basic)