DateTime Estrutura

Definição

Espaço de Nomes:: System

Assemblagens:: mscorlib.dll, System.Runtime.dll

Assemblagem:: mscorlib.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa um instante no tempo, normalmente expresso como uma data e hora do dia.

public value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable

public value class DateTime : IComparable, IConvertible, IFormattable

public value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System::Runtime::Serialization::ISerializable

public value class DateTime : IComparable, IComparable<DateTime>, IEquatable<DateTime>, IFormattable

public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable

[System.Serializable]
public struct DateTime : IComparable, IConvertible, IFormattable

[System.Serializable]
public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializable

public struct DateTime : IComparable, IComparable<DateTime>, IEquatable<DateTime>, IFormattable

public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializable

public readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializable

type DateTime = struct
    interface IConvertible
    interface IFormattable

[<System.Serializable>]
type DateTime = struct
    interface IFormattable
    interface IConvertible

[<System.Serializable>]
type DateTime = struct
    interface IFormattable
    interface IConvertible
    interface ISerializable

type DateTime = struct
    interface IFormattable

type DateTime = struct
    interface IConvertible
    interface IFormattable
    interface ISerializable

Public Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IFormattable

Public Structure DateTime
Implements IComparable, IConvertible, IFormattable

Public Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IFormattable, ISerializable

Public Structure DateTime
Implements IComparable, IComparable(Of DateTime), IEquatable(Of DateTime), IFormattable

Herança: Object

ValueType
DateTime

Atributos: SerializableAttribute

Implementações: IComparable IComparable<DateTime> IConvertible IEquatable<DateTime> IFormattable ISerializable

Observações

Para mais informações sobre esta API, consulte Observações suplementares da API para o DateTime.

Construtores

Name	Description
DateTime(Int32, Int32, Int32, Calendar)	Inicializa uma nova instância da DateTime estrutura para o ano, mês e dia especificados para o calendário especificado.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Inicializa uma nova instância da DateTime estrutura 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 DateTime estrutura para o ano, mês, dia, hora, minuto, segundo e Tempo Universal Coordenado (UTC) ou hora local especificados.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)	Inicializa uma nova instância da DateTime estrutura para o ano, mês, dia, hora, minuto, segundo, milissegundo e Tempo Universal Coordenado (UTC) ou hora local especificados para o calendário especificado.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)	Inicializa uma nova instância da DateTime estrutura 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, DateTimeKind)	Inicializa uma nova instância da DateTime estrutura para o ano, mês, dia, hora, minuto, segundo, milissegundo e Tempo Universal Coordenado (UTC) ou hora local especificados.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)	Inicializa uma nova instância da DateTime estrutura para o ano, mês, dia, hora, minuto, segundo e milissegundo especificados.
DateTime(Int32, Int32, Int32, Int32, Int32, Int32)	Inicializa uma nova instância da DateTime estrutura no ano, mês, dia, hora, minuto e segundo especificados.
DateTime(Int32, Int32, Int32)	Inicializa uma nova instância da DateTime estrutura para o ano, mês e dia especificados.
DateTime(Int64, DateTimeKind)	Inicializa uma nova instância da DateTime estrutura para um número especificado de ticks e para Tempo Universal Coordenado (UTC) ou hora local.
DateTime(Int64)	Inicializa uma nova instância da DateTime estrutura para um número especificado de ticks.

Campos

Name	Description
MaxValue	Representa o maior valor possível de DateTime. Este campo é só de leitura.
MinValue	Representa o menor valor possível de DateTime. Este campo é só de leitura.
UnixEpoch	O valor desta constante é equivalente a 00:00:00.0000000 UTC, 1 de janeiro de 1970, no calendário gregoriano. UnixEpoch define o momento no tempo em que o tempo Unix é igual a 0.

Propriedades

Name	Description
Date	Obtém o componente de data neste caso.
Day	Obtém o dia do mês representado por esta instância.
DayOfWeek	Recebe o dia da semana representado por esta situação.
DayOfYear	Recebe o dia do ano representado por esta instância.
Hour	Obtém o componente hora da data representada por esta instância.
Kind	Obtém um valor que indica se o tempo representado por esta instância é baseado na hora local, no Tempo Universal Coordenado (UTC) ou em nenhum dos dois.
Millisecond	Obtém o componente milissegundos da data representada por esta instância.
Minute	Obtém o componente minuto da data representada por esta instância.
Month	Obtém o componente mês da data representada por esta instância.
Now	Obtém um DateTime objeto definido para a data e hora atuais neste computador, expressas como a hora local.
Second	Obtém o componente de segundos da data representada por esta instância.
Ticks	Obtém o número de ticks que representam a data e hora desta instância.
TimeOfDay	Tem atenção neste caso.
Today	Recebe a data atual.
UtcNow	Obtém um DateTime objeto definido para a data e hora atuais neste computador, expressas como Tempo Universal Coordenado (UTC).
Year	Obtém o componente ano da data representada por esta instância.

Métodos

Name	Description
Add(TimeSpan)	Devolve um novo DateTime que soma o valor do especificado TimeSpan ao valor desta instância.
AddDays(Double)	Devolve um novo DateTime que adiciona o número de dias especificado ao valor desta instância.
AddHours(Double)	Devolve um novo DateTime que adiciona o número de horas especificado ao valor desta instância.
AddMilliseconds(Double)	Retorna um novo DateTime que adiciona o número especificado de milissegundos ao valor desta instância.
AddMinutes(Double)	Devolve um novo DateTime que adiciona o número de minutos especificado ao valor desta instância.
AddMonths(Int32)	Devolve um novo DateTime que adiciona o número de meses especificado ao valor desta instância.
AddSeconds(Double)	Devolve um novo DateTime que adiciona o número especificado de segundos ao valor desta instância.
AddTicks(Int64)	Devolve um novo DateTime que adiciona o número especificado de ticks ao valor desta instância.
AddYears(Int32)	Devolve um novo DateTime que adiciona o número de anos especificado ao valor desta instância.
Compare(DateTime, DateTime)	Compara duas instâncias de DateTime e devolve um inteiro que indica se a primeira instância é anterior, igual ou posterior à segunda instância.
CompareTo(DateTime)	Compara o valor desta instância com um valor especificado DateTime e devolve um inteiro que indica se esta instância é anterior, igual ou posterior ao valor especificado DateTime .
CompareTo(Object)	Compara o valor desta instância com um objeto especificado que contém um valor especificado DateTime e devolve um inteiro que indica se esta instância é anterior, igual ou posterior ao valor especificado DateTime .
DaysInMonth(Int32, Int32)	Devolve o número de dias no mês e ano especificados.
Equals(DateTime, DateTime)	Devolve um valor que indica se duas DateTime instâncias têm o mesmo valor de data e hora.
Equals(DateTime)	Devolve um valor que indica se o valor desta instância é igual ao valor da instância especificada DateTime .
Equals(Object)	Devolve um valor que indica se esta instância é igual a um objeto especificado.
FromBinary(Int64)	Desserializa um valor binário de 64 bits e recria um objeto serializado DateTime original.
FromFileTime(Int64)	Converte o tempo especificado do ficheiro Windows para um tempo local equivalente.
FromFileTimeUtc(Int64)	Converte o tempo especificado do ficheiro Windows para um tempo equivalente UTC.
FromOADate(Double)	Devolve um DateTime equivalente à Data de Automação OLE especificada.
GetDateTimeFormats()	Converte o valor desta instância para todas as representações de cadeias suportadas pelos especificadores padrão de formato de data e hora.
GetDateTimeFormats(Char, IFormatProvider)	Converte o valor desta instância para todas as representações de strings suportadas pelo especificador de formato padrão de data e hora especificado e pela informação de formatação específica da cultura.
GetDateTimeFormats(Char)	Converte o valor desta instância para todas as representações de cadeias suportadas pelo especificador de formato padrão de data e hora.
GetDateTimeFormats(IFormatProvider)	Converte o valor desta instância para todas as representações de strings suportadas pelos especificadores padrão de formato de data e hora e pela informação de formatação específica da cultura.
GetHashCode()	Devolve o código de hash para esta instância.
GetTypeCode()	Devolve o TypeCode tipo DateTimede valor para .
IsDaylightSavingTime()	Indica se esta instância de DateTime está dentro do intervalo do horário de verão para o fuso horário atual.
IsLeapYear(Int32)	Devolve uma indicação se o ano especificado é um ano bissexto.
Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	Converte um espaço de memória que contém a representação em cadeia de uma data e hora para o seu DateTime equivalente, utilizando informação de formato específica para cultura e um estilo de formatação.
Parse(String, IFormatProvider, DateTimeStyles)	Converte a representação em cadeia de uma data e hora para o seu DateTime equivalente, utilizando informação de formato específica da cultura e um estilo de formatação.
Parse(String, IFormatProvider)	Converte a representação da cadeia de uma data e hora para o seu DateTime equivalente usando informação de formato específica para cada cultura.
Parse(String)	Converte a representação em cadeia de uma data e hora para o seu DateTime equivalente, usando as convenções da cultura atual.
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)	Converte a representação do intervalo especificada de uma data e hora para o seu DateTime equivalente usando o formato especificado, informação de formato específica da cultura e estilo. O formato da representação da cadeia deve corresponder exatamente ao formato especificado ou é lançada uma exceção.
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles)	Converte a representação de span especificada de uma data e hora para o seu DateTime equivalente usando o array especificado de formatos, informação de formato específica para cultura e estilo. O formato da representação da cadeia deve corresponder exatamente a um dos formatos especificados, caso contrário é lançada uma exceção.
ParseExact(String, String, IFormatProvider, DateTimeStyles)	Converte a representação em cadeia especificada de uma data e hora para o seu DateTime equivalente usando o formato especificado, informação de formato específica da cultura e estilo. O formato da representação da cadeia deve corresponder exatamente ao formato especificado ou é lançada uma exceção.
ParseExact(String, String, IFormatProvider)	Converte a representação de cadeias especificada de uma data e hora para o seu DateTime equivalente usando o formato especificado e a informação de formato específica da cultura. O formato da representação da cadeia deve corresponder exatamente ao formato especificado.
ParseExact(String, String[], IFormatProvider, DateTimeStyles)	Converte a representação de cadeias especificada de uma data e hora para o seu DateTime equivalente usando o array especificado de formatos, informação de formato específica de cultura e estilo. O formato da representação da cadeia deve corresponder exatamente a um dos formatos especificados, caso contrário é lançada uma exceção.
SpecifyKind(DateTime, DateTimeKind)	Cria um novo DateTime objeto que tem o mesmo número de ticks que o especificado DateTime, mas é designado como hora local, Tempo Universal Coordenado (UTC) ou nenhum, conforme indicado pelo valor especificado DateTimeKind .
Subtract(DateTime)	Devolve um novo TimeSpan que subtrai a data e hora especificadas do valor desta instância.
Subtract(TimeSpan)	Devolve um novo DateTime que subtrai a duração especificada ao valor desta instância.
ToBinary()	Serializa o objeto atual DateTime para um valor binário de 64 bits que posteriormente pode ser usado para recriar o DateTime objeto.
ToFileTime()	Converte o valor do objeto atual DateTime para um tempo de ficheiro Windows.
ToFileTimeUtc()	Converte o valor do objeto atual DateTime para um tempo de ficheiro Windows.
ToLocalTime()	Converte o valor do objeto atual DateTime para hora local.
ToLongDateString()	Converte o valor do objeto atual DateTime para a sua representação equivalente de cadeias de longa data.
ToLongTimeString()	Converte o valor do objeto atual DateTime para a sua representação equivalente de cordas de longo prazo.
ToOADate()	Converte o valor desta instância para a data equivalente de Automação OLE.
ToShortDateString()	Converte o valor do objeto atual DateTime para a sua representação equivalente de cadeias de curta data.
ToShortTimeString()	Converte o valor do objeto atual DateTime para a sua representação equivalente de cadeias de tempo curto.
ToString()	Converte o valor do objeto atual DateTime para a sua representação equivalente de cadeias usando as convenções de formatação da cultura atual.
ToString(IFormatProvider)	Converte o valor do objeto atual DateTime para a sua representação equivalente de cadeias usando a informação de formato específica para cultura.
ToString(String, IFormatProvider)	Converte o valor do objeto atual DateTime para a sua representação equivalente de cadeias usando o formato especificado e a informação específica de formato da cultura.
ToString(String)	Converte o valor do objeto atual DateTime para a sua representação equivalente de cadeias usando o formato especificado e as convenções de formatação da cultura atual.
ToUniversalTime()	Converte o valor do objeto atual DateTime para Tempo Universal Coordenado (UTC).
TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Tenta formatar o valor da instância de data-hora atual no intervalo fornecido de caracteres.
TryParse(ReadOnlySpan<Char>, DateTime)	Converte o intervalo de caracteres especificado de uma data e hora para o seu DateTime equivalente e devolve um valor que indica se a conversão foi bem-sucedida.
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)	Converte a representação span de uma data e hora para o seu DateTime equivalente usando a informação de formato e o estilo de formatação específicos da cultura, e devolve um valor que indica se a conversão foi bem-sucedida.
TryParse(String, DateTime)	Converte a representação de cadeia especificada de uma data e hora para o seu DateTime equivalente e devolve um valor que indica se a conversão foi bem-sucedida.
TryParse(String, IFormatProvider, DateTimeStyles, DateTime)	Converte a representação em cadeia especificada de uma data e hora para o seu DateTime equivalente usando a informação de formato e o estilo de formatação específicos da cultura, e devolve um valor que indica se a conversão foi bem-sucedida.
TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)	Converte a representação do intervalo especificada de uma data e hora para o seu DateTime equivalente usando o formato especificado, informação de formato específica da cultura e estilo. O formato da representação da cadeia deve corresponder exatamente ao formato especificado. O método devolve 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 para o seu DateTime equivalente e devolve um valor que indica se a conversão foi bem-sucedida.
TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)	Converte a representação em cadeia especificada de uma data e hora para o seu DateTime equivalente usando o formato especificado, informação de formato específica da cultura e estilo. O formato da representação da cadeia deve corresponder exatamente ao formato especificado. O método devolve um valor que indica se a conversão foi bem-sucedida.
TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)	Converte a representação de cadeias especificada de uma data e hora para o seu DateTime equivalente usando o array especificado de formatos, informação de formato específica de cultura e estilo. O formato da representação da cadeia deve corresponder exatamente a um dos formatos especificados. O método devolve um valor que indica se a conversão foi bem-sucedida.

Operadores

Name	Description
Addition(DateTime, TimeSpan)	Adiciona um intervalo de tempo especificado a uma data e hora especificadas, produzindo uma nova data e hora.
Equality(DateTime, DateTime)	Determina se duas instâncias especificadas de DateTime são iguais.
GreaterThan(DateTime, DateTime)	Determina se um especificado DateTime é posterior ao outro especificado DateTime.
GreaterThanOrEqual(DateTime, DateTime)	Determina se um especificado DateTime representa uma data e hora que são iguais ou posteriores a outra especificada DateTime.
Inequality(DateTime, DateTime)	Determina se duas instâncias especificadas de DateTime não são iguais.
LessThan(DateTime, DateTime)	Determina se um especificado DateTime é anterior a outro especificado DateTime.
LessThanOrEqual(DateTime, DateTime)	Determina se uma especificada DateTime representa uma data e hora iguais ou anteriores a outra especificada DateTime.
Subtraction(DateTime, DateTime)	Subtrai uma data e hora especificadas de outra data e hora especificadas e devolve um intervalo de tempo.
Subtraction(DateTime, TimeSpan)	Subtrai um intervalo de tempo especificado de uma data e hora especificadas e devolve uma nova data e hora.

Implementações de Interface Explícita

Name	Description
IComparable.CompareTo(Object)	Compara a instância atual com outro objeto do mesmo tipo e devolve um inteiro que indica se a instância atual precede, segue ou ocorre na mesma posição na ordem de ordenação que o outro objeto.
IConvertible.GetTypeCode()	Devolve o TypeCode para este caso.
IConvertible.ToBoolean(IFormatProvider)	Esta conversão não é suportada. Tentar usar este método lança um InvalidCastException.
IConvertible.ToByte(IFormatProvider)	Esta conversão não é suportada. Tentar usar este método lança um InvalidCastException.
IConvertible.ToChar(IFormatProvider)	Esta conversão não é suportada. Tentar usar este método lança um InvalidCastException.
IConvertible.ToDateTime(IFormatProvider)	Devolve o objeto atual DateTime .
IConvertible.ToDecimal(IFormatProvider)	Esta conversão não é suportada. Tentar usar este método lança um InvalidCastException.
IConvertible.ToDouble(IFormatProvider)	Esta conversão não é suportada. Tentar usar este método lança um InvalidCastException.
IConvertible.ToInt16(IFormatProvider)	Esta conversão não é suportada. Tentar usar este método lança um InvalidCastException.
IConvertible.ToInt32(IFormatProvider)	Esta conversão não é suportada. Tentar usar este método lança um InvalidCastException.
IConvertible.ToInt64(IFormatProvider)	Esta conversão não é suportada. Tentar usar este método lança um InvalidCastException.
IConvertible.ToSByte(IFormatProvider)	Esta conversão não é suportada. Tentar usar este método lança um InvalidCastException.
IConvertible.ToSingle(IFormatProvider)	Esta conversão não é suportada. Tentar usar este método lança um InvalidCastException.
IConvertible.ToType(Type, IFormatProvider)	Converte o objeto atual DateTime num objeto de um tipo especificado.
IConvertible.ToUInt16(IFormatProvider)	Esta conversão não é suportada. Tentar usar este método lança um InvalidCastException.
IConvertible.ToUInt32(IFormatProvider)	Esta conversão não é suportada. Tentar usar este método lança um InvalidCastException.
IConvertible.ToUInt64(IFormatProvider)	Esta conversão não é suportada. Tentar usar este método lança um InvalidCastException.
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Preenche um SerializationInfo objeto com os dados necessários para serializar o objeto atual DateTime .

Aplica-se a

Segurança de Thread

Todos os membros deste tipo são seguros para fios. Os membros que parecem modificar o estado da instância retornam na verdade uma nova instância inicializada com o novo valor. Como em qualquer outro tipo, a leitura e escrita numa variável partilhada que contenha uma instância deste tipo deve ser protegida por um bloqueio para garantir a segurança do thread.

Ver também

Comentários

Esta página foi útil?