VENDAS: 1-800-867-1389
Informações
O tópico solicitado está sendo mostrado abaixo. No entanto, este tópico não está incluído nesta biblioteca.

Estrutura DateTime

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

Para procurar o código-fonte do.NET Framework para esse tipo, consulte Origem de referência.

Namespace:  System
Assembly:  mscorlib (em mscorlib.dll)

[SerializableAttribute]
public struct DateTime : IComparable, IFormattable, 
	IConvertible, ISerializable, IComparable<DateTime>, IEquatable<DateTime>

O tipo DateTime expõe os membros a seguir.

  NomeDescrição
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreDateTime(Int64)Inicializa uma nova instância da estrutura de DateTime a um número especificado de tiques.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreDateTime(Int64, DateTimeKind)Inicializa uma nova instância da estrutura de DateTime a um número especificado de tiques e para o Tempo Universal Coordenado (UTC) ou hora locais.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreDateTime(Int32, Int32, Int32)Inicializa uma nova instância da estrutura de DateTime ao ano, mês, dia e o especificados.
Método públicoCompatível com o XNA FrameworkDateTime(Int32, Int32, Int32, Calendar)Inicializa uma nova instância da estrutura de DateTime ao ano, mês, dia e o especificados para o calendário especificado.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreDateTime(Int32, Int32, Int32, Int32, Int32, Int32)Inicializa uma nova instância da estrutura de DateTime ao ano especificado, mês, dia, hora, minuto, segundo e em.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreDateTime(Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)Inicializa uma nova instância da estrutura de DateTime ao ano, mês, dia, hora, o minuto, o segundo, e o Tempo Universal Coordenado (UTC) ou a hora locais especificadas.
Método públicoCompatível com o XNA FrameworkDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Calendar)Inicializa uma nova instância da estrutura de DateTime ao ano especificado, mês, dia, hora, minuto e segundo, para o calendário especificado.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)Inicializa uma nova instância da estrutura de DateTime ao ano, mês, o dia, a hora, o minuto, o segundo, e o milissegundo especificados.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)Inicializa uma nova instância da estrutura de DateTime ao ano, mês, dia, hora, o minuto, o segundo, o milissegundo, e o Tempo Universal Coordenado (UTC) ou a hora locais especificadas.
Método públicoCompatível com o XNA FrameworkDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)Inicializa uma nova instância da estrutura de DateTime ao ano, mês, o dia, a hora, o minuto, o segundo, e o milissegundo especificados para o calendário especificado.
Método públicoCompatível com o XNA FrameworkDateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)Inicializa uma nova instância da estrutura de DateTime ao ano, mês, dia, hora, o minuto, o segundo, o milissegundo, e o Tempo Universal Coordenado (UTC) ou a hora locais especificadas para o calendário especificado.
Superior

  NomeDescrição
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreDateObtém o componente de data dessa instância.
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreDayObtém o dia do mês representado por essa instância.
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreDayOfWeekObtém o dia da semana representada por esta instância do.
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreDayOfYearObtém o dia do ano representada por esta instância do.
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreHourObtém o componente de hora de data representado por essa instância.
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreKindObtém um valor que indica se o tempo representados por essa instância se baseiam em hora local, no Tempo Universal Coordenado (UTC), ou em nenhum.
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreMillisecondObtém o componente de milissegundos de data representado por essa instância.
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreMinuteObtém o componente de minuto de data representado por essa instância.
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreMonthObtém o componente do mês da data representado por essa instância.
Propriedade públicaMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreNowObtém um objeto de DateTime que seja definido como a data e a hora neste computador, expresso como a hora local.
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreSecondObtém o componente de segundos de data representado por essa instância.
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreTicksObtém o número de tiques que representa a data e a hora dessa instância.
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreTimeOfDayObtém a hora dessa instância.
Propriedade públicaMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreTodayObtém a data atual.
Propriedade públicaMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreUtcNowObtém um objeto de DateTime que seja definido como a data e a hora neste computador, expresso como o Tempo Universal Coordenado (UTC).
Propriedade públicaCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreYearObtém o componente de data do ano representada por esta instância do.
Superior

  NomeDescrição
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreAddRetorna nova DateTime que associa o valor de TimeSpan especificado ao valor dessa instância.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreAddDaysRetorna nova DateTime que adiciona o número de dias especificado ao valor dessa instância.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreAddHoursRetorna nova DateTime que adiciona o número especificado de hora ao valor dessa instância.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreAddMillisecondsRetorna nova DateTime que adiciona o número especificado de milissegundos ao valor dessa instância.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreAddMinutesRetorna nova DateTime que adiciona o número especificado de minutos ao valor dessa instância.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreAddMonthsRetorna nova DateTime que adiciona o número de meses especificado ao valor dessa instância.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreAddSecondsRetorna nova DateTime que adiciona o número de segundos especificado ao valor dessa instância.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreAddTicksRetorna nova DateTime que adiciona o número especificado de tiques ao valor dessa instância.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreAddYearsRetorna nova DateTime que adiciona o número especificado de anos ao valor dessa instância.
Método públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreCompareCompara duas instâncias de DateTime e retorna um número inteiro que indica se a primeira instância é anterior, igual, ou posterior a segunda instância.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreCompareTo(DateTime)Compara o valor desta instância em um valor especificado de DateTime e retorna um inteiro que indica se esta instância for anterior ao, o mesmo que, ou posterior ao valor especificado de DateTime .
Método públicoCompatível com o XNA FrameworkCompareTo(Object)Compara o valor desta instância em um objeto especificado que contém um valor especificado de DateTime , e retorna um inteiro que indica se esta instância for anterior ao, o mesmo que, ou posterior ao valor especificado de DateTime .
Método públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreDaysInMonthRetorna o número de dias do mês e o ano especificados.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreEquals(DateTime)Retorna um valor que indica se o valor desta instância é igual ao valor da instância especificada do DateTime .
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreEquals(Object)Retorna um valor que indica se essa instância é igual a um objeto especificado. (Substitui ValueType.Equals(Object).)
Método públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreEquals(DateTime, DateTime)Retorna um valor que indica se duas instâncias de DateTime têm a mesma data e valor do tempo.
Método públicoMembro estáticoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreFromBinaryDesserializa um valor binário de 64 bits e recria um objeto serializado original de DateTime .
Método públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreFromFileTimeConverte o windows especificadas em tempo a hora locais equivalentes.
Método públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreFromFileTimeUtcConverte o windows especificadas em tempo a hora UTC equivalentes.
Método públicoMembro estáticoCompatível com o XNA FrameworkFromOADateRetorna um equivalente de DateTime à data especificada de Automação OLE.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreGetDateTimeFormats()Converte o valor desta instância em todas as representações de cadeia de caracteres com suporte dos especificadores padrão de formato de data e hora.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreGetDateTimeFormats(Char)Converte o valor desta instância em todas as representações de cadeia de caracteres com suporte pelo especificador padrão especificado de formato de data e hora.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreGetDateTimeFormats(IFormatProvider)Converte o valor desta instância em todas as representações de cadeia de caracteres com suporte dos especificadores padrão de formato de data e hora e pelas informações específicas à cultura específica especificada de formatação.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreGetDateTimeFormats(Char, IFormatProvider)Converte o valor desta instância em todas as representações de cadeia de caracteres com suporte pelo especificador padrão especificado de formato de data e hora e pelas informações específicas à cultura específica de formatação.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreGetHashCode Retorna o hash code para essa instância. (Substitui ValueType.GetHashCode().)
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreGetType Obtém o Type da instância atual. (Herdado de Object.)
Método públicoCompatível com o XNA FrameworkGetTypeCodeRetorna TypeCode para o tipo de valor DateTime.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreIsDaylightSavingTimeIndica se esta instância de DateTime estiver dentro do intervalo de horário de verão para o fuso horário atual.
Método públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreIsLeapYearRetorna um que indica se o ano especificado é um ano bissextos.
Método públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreParse(String)Converte a representação de cadeia de caracteres de uma data e hora para seu equivalente de DateTime .
Método públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreParse(String, IFormatProvider)Converte a representação de cadeia de caracteres de uma data e hora para seu equivalente de DateTime usando informações específicas à cultura específica de formato.
Método públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreParse(String, IFormatProvider, DateTimeStyles)Converte a representação de cadeia de caracteres de uma data e hora para seu equivalente de DateTime usando informações específicas à cultura específica de formato e formatação dos EUA.
Método públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreParseExact(String, String, IFormatProvider)Converte a representação de cadeia de caracteres especificada de uma data e hora para seu equivalente de DateTime usando o formato especificado e informações específicas à cultura específica de formato. O formato de representação da cadeia de caracteres deve corresponder exatamente ao formato especificado.
Método públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreParseExact(String, String, IFormatProvider, DateTimeStyles)Converte a representação de cadeia de caracteres especificada de uma data e hora para seu equivalente de DateTime usando o formato especificado, as informações específicas à cultura específica de formato, e o estilo. O formato de representação de cadeia de caracteres deve corresponder ao formato especificado exatamente ou uma exceção é gerada.
Método públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreParseExact(String, String[], IFormatProvider, DateTimeStyles)Converte a representação de cadeia de caracteres especificada de uma data e hora para seu equivalente de DateTime usando a matriz especificada de formatos, informações de cultura específica de formato, e de estilo. O formato de representação de cadeia de caracteres deve corresponder pelo menos um dos formatos especificado exatamente ou uma exceção é gerada.
Método públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreSpecifyKindCria um novo objeto a partir de DateTime que tem o mesmo número de tiques que DateTimeespecificado, mas é designado como hora local, Tempo Universal Coordenado (UTC), ou nenhum, conforme indicado pelo valor especificado de DateTimeKind .
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreSubtract(DateTime)Subtrai a data e hora especificadas dessa instância.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreSubtract(TimeSpan)Subtrai a duração especificada dessa instância.
Método públicoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreToBinarySerializa o objeto atual de DateTime a um valor binário de 64 bits que subsequentemente pode ser usado para recriar o objeto de DateTime .
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreToFileTimeConverte o valor do objeto atual de DateTime o windows ao arquivo tempo.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreToFileTimeUtcConverte o valor do objeto atual de DateTime o windows ao arquivo tempo.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreToLocalTimeConverte o valor do objeto atual de DateTime a hora local.
Método públicoCompatível com o XNA FrameworkToLongDateStringConverte o valor do objeto atual de DateTime em sua representação de cadeia de caracteres equivalente a longo prazo.
Método públicoCompatível com o XNA FrameworkToLongTimeStringConverte o valor do objeto atual de DateTime em sua representação de cadeia de caracteres equivalente de hora longo.
Método públicoCompatível com o XNA FrameworkToOADateConverte o valor dessa instância à data equivalente de Automação OLE.
Método públicoCompatível com o XNA FrameworkToShortDateStringConverte o valor do objeto atual de DateTime em sua representação de cadeia de caracteres curta equivalente de data.
Método públicoCompatível com o XNA FrameworkToShortTimeStringConverte o valor do objeto atual de DateTime em sua representação de cadeia de caracteres equivalente de curto período de tempo.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreToString()Converte o valor do objeto atual de DateTime em sua representação de cadeia de caracteres equivalente. (Substitui ValueType.ToString().)
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreToString(IFormatProvider)Converte o valor do objeto atual de DateTime em sua representação de cadeia de caracteres equivalente usando informações específicas à cultura específica especificada de formato.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreToString(String) Converte o valor de um objeto DateTime para a sua representação equivalente em sequência de caracteres(string) usando um formato especificado.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreToString(String, IFormatProvider)Converte o valor do objeto atual de DateTime em sua representação de cadeia de caracteres equivalente usando o formato especificado e informações específicas à cultura específica de formato.
Método públicoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreToUniversalTimeConverte o valor do objeto atual de DateTime para o Tempo Universal Coordenado (UTC).
Método públicoMembro estáticoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreTryParse(String, DateTime)Converte a representação de cadeia de caracteres especificada de uma data e hora para seu equivalente de DateTime e retorna um valor que indica se a conversão for bem-sucedida.
Método públicoMembro estáticoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreTryParse(String, IFormatProvider, DateTimeStyles, DateTime)Converte a representação de cadeia de caracteres especificada de uma data e hora para seu equivalente de DateTime usando informações específicas à cultura específica especificada de formato e formatação dos EUA, e retorna um valor que indica se a conversão for bem-sucedida.
Método públicoMembro estáticoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreTryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)Converte a representação de cadeia de caracteres especificada de uma data e hora para seu equivalente de DateTime usando o formato especificado, as informações específicas à cultura específica de formato, 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.
Método públicoMembro estáticoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreTryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)Converte a representação de cadeia de caracteres especificada de uma data e hora para seu equivalente de DateTime usando a matriz especificada de formatos, informações de cultura específica de formato, e de estilo. O formato de representação de cadeia de caracteres deve corresponder pelo menos um dos formatos especificados exatamente. O método retorna um valor que indica se a conversão foi bem-sucedida.
Superior

  NomeDescrição
Operador públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreAdditionAdiciona um intervalo de tempo especificado em uma data e hora especificadas, com um resultado uma nova data e hora.
Operador públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreEqualityDetermina se duas instâncias especificadas de DateTime são iguais.
Operador públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreGreaterThanDetermina se um DateTime especificado é posterior a outro DateTimeespecificado.
Operador públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreGreaterThanOrEqualDetermina se um DateTime especificado representa uma data e hora que serão iguais ou posterior a outro DateTimeespecificado.
Operador públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreInequalityDetermina se duas instâncias especificadas de DateTime não são iguais.
Operador públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreLessThanDetermina se um DateTime especificado for anterior ao outro DateTimeespecificado.
Operador públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreLessThanOrEqualDetermina se um DateTime especificado representa uma data e hora que serão iguais ou anteriores do que outro DateTimeespecificado.
Operador públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreSubtraction(DateTime, DateTime)Subtrai uma data e hora especificada de outra data e hora especificadas e retorna um intervalo de tempo.
Operador públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreSubtraction(DateTime, TimeSpan)Subtrai um intervalo de tempo especificado de uma data e hora especificadas e retorna uma nova data e hora.
Superior

  NomeDescrição
Campo públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreMaxValueRepresenta o maior valor possível de DateTime. Este campo é somente leitura.
Campo públicoMembro estáticoCompatível com o XNA FrameworkCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreMinValueRepresenta o menor valor possível de DateTime. Este campo é somente leitura.
Superior

  NomeDescrição
Implementação explícita da interfaceMétodo particularCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreIComparable.CompareToCompara a instância atual com outro objeto do mesmo tipo e retorna um inteiro que indica se esta instância precede, maneira, ou ocorrer na mesma posição na ordem de classificação que outro objeto.
Implementação explícita da interfaceMétodo particularCompatível com o XNA FrameworkIConvertible.ToBooleanInfraestrutura. Esta conversão não é suportada. A tentativa de usar esse método lança um InvalidCastException.
Implementação explícita da interfaceMétodo particularCompatível com o XNA FrameworkIConvertible.ToByteInfraestrutura. Esta conversão não é suportada. A tentativa de usar esse método lança um InvalidCastException.
Implementação explícita da interfaceMétodo particularCompatível com o XNA FrameworkIConvertible.ToCharInfraestrutura. Esta conversão não é suportada. A tentativa de usar esse método lança um InvalidCastException.
Implementação explícita da interfaceMétodo particularCompatível com o XNA FrameworkIConvertible.ToDateTimeInfraestrutura. Retorna o objeto atual de DateTime .
Implementação explícita da interfaceMétodo particularCompatível com o XNA FrameworkIConvertible.ToDecimalInfraestrutura. Esta conversão não é suportada. A tentativa de usar esse método lança um InvalidCastException.
Implementação explícita da interfaceMétodo particularCompatível com o XNA FrameworkIConvertible.ToDoubleInfraestrutura. Esta conversão não é suportada. A tentativa de usar esse método lança um InvalidCastException.
Implementação explícita da interfaceMétodo particularCompatível com o XNA FrameworkIConvertible.ToInt16Infraestrutura. Esta conversão não é suportada. A tentativa de usar esse método lança um InvalidCastException.
Implementação explícita da interfaceMétodo particularCompatível com o XNA FrameworkIConvertible.ToInt32Infraestrutura. Esta conversão não é suportada. A tentativa de usar esse método lança um InvalidCastException.
Implementação explícita da interfaceMétodo particularCompatível com o XNA FrameworkIConvertible.ToInt64Infraestrutura. Esta conversão não é suportada. A tentativa de usar esse método lança um InvalidCastException.
Implementação explícita da interfaceMétodo particularCompatível com o XNA FrameworkIConvertible.ToSByteInfraestrutura. Esta conversão não é suportada. A tentativa de usar esse método lança um InvalidCastException.
Implementação explícita da interfaceMétodo particularCompatível com o XNA FrameworkIConvertible.ToSingleInfraestrutura. Esta conversão não é suportada. A tentativa de usar esse método lança um InvalidCastException.
Implementação explícita da interfaceMétodo particularCompatível com o XNA FrameworkIConvertible.ToTypeInfraestrutura. Converte o objeto atual de DateTime a um objeto de um tipo especificado.
Implementação explícita da interfaceMétodo particularCompatível com o XNA FrameworkIConvertible.ToUInt16Infraestrutura. Esta conversão não é suportada. A tentativa de usar esse método lança um InvalidCastException.
Implementação explícita da interfaceMétodo particularCompatível com o XNA FrameworkIConvertible.ToUInt32Infraestrutura. Esta conversão não é suportada. A tentativa de usar esse método lança um InvalidCastException.
Implementação explícita da interfaceMétodo particularCompatível com o XNA FrameworkIConvertible.ToUInt64Infraestrutura. Esta conversão não é suportada. A tentativa de usar esse método lança um InvalidCastException.
Implementação explícita da interfaceMétodo particularISerializable.GetObjectDataPopula um objeto de SerializationInfo com os dados necessários para serializar o objeto atual de DateTime .
Superior

Para exibir o código-fonte do.NET Framework para esse tipo, consulte Origem de referência. Você pode navegar com o código-fonte online, baixe a referência para a exibição offline, e navegar pelas origens (inclusive patch e atualizações) durante a depuração; consulte instruções.

O tipo de valor de DateTime representar datas e horas com valores que variam de 00:00: 00 (meia-noite), o 1º de janeiro, 0001 Anno Domini (foi comum) a 11:59: 59 P.M., o 31 de dezembro, 9999 D.C. C.E (.) no calendário gregoriano.

Valores de hora são medidos em 100 unidades chamadas de nanossegundos tiques, e uma data específica é o número de tiques desde meia-noite de 12:00, o 1º de janeiro, 0001 D.C. C.E (.) no calendário de GregorianCalendar (exceto os tiques que serão adicionados em segundos intercalares). Por exemplo, um valor de tiques de 31241376000000000L representa a data, sexta-feira 1 de janeiro de 0100 12:00: meia-noite 00. Um valor de DateTime sempre é expresso no contexto de um calendário padrão explícito ou.

ObservaçãoObservação

Se você estiver trabalhando com tiques valor que você deseja converter em qualquer outro intervalo de tempo, como minutos ou segundos, você deve usar TimeSpan.TicksPerDay, TimeSpan.TicksPerHour, TimeSpan.TicksPerMinute, TimeSpan.TicksPerSecond, ou a constante de TimeSpan.TicksPerMillisecond para executar a conversão. Por exemplo, para adicionar o número de segundos representados por um número especificado de tiques do componente de Second de um valor de DateTime , você pode usar a expressão dateValue.Second + nTicks/Timespan.TicksPerSecond.

Nesta seção:

Criando uma instância de um objeto DateTime
Valores de data e hora e suas representações de cadeia de caracteres
Convertendo cadeias de caracteres em valores DateTime
Considerações da versão
Valores DateTime
Operações DateTime
DateTime x TimeSpan
Considerações de interoperabilidade COM

Criando uma instância de um objeto DateTime

Você pode criar um novo valor de DateTime em qualquer uma das seguintes formas:

  • Chamando qualquer as sobrecargas de construtor de DateTime que permitem que você especifique elementos específicos de data e valor de tempo (como o ano, mês e dia ou o número de tiques). A instrução a seguir ilustra uma chamada em um dos construtores DateTime para criar uma data com um ano específico, mês, dia, hora, minuto e segundo.

    
    DateTime date1 = new DateTime(2008, 5, 1, 8, 30, 52);
    
    
    
  • Usando qualquer sintaxe compilador-específicos para declarar valores de data e hora. Por exemplo, a instrução a seguir do Visual Basic inicializa um novo valor de DateTime .

    
    Dim date1 As Date = #5/1/2008 8:30:52AM#
    
    
    
  • Por como Autenticando o Objeto DateTime uma data e valor de tempo retornado por uma propriedade ou método. O exemplo a seguir atribui a data atual e tempo, a data atual Tempo Universal Coordenado (UTC) e tempo e a data atual às três variáveis DateTime novas.

    
    DateTime date1 = DateTime.Now;
    DateTime date2 = DateTime.UtcNow;
    DateTime date3 = DateTime.Today;
    
    
    
  • Ao analisar a representação de seqüência de caracteres de uma data e valor de tempo. O Parse, ParseExact, TryParse e TryParseExact converter uma seqüência de caracteres em sua data equivalente e valor de tempo. O exemplo a seguir usa o método de Parse para analisar uma cadeia de caracteres e para convertê-la em um valor de DateTime .

    
    string dateString = "5/1/2008 8:30:52 AM";
    DateTime date1 = DateTime.Parse(dateString, 
                              System.Globalization.CultureInfo.InvariantCulture); 
    
    
    

    Observe que os métodos de TryParse e de TryParseExact indica se uma cadeia de caracteres específica contém uma representação válida de um valor de DateTime além de executar a conversão.

  • Chamando o construtor padrão implícito para a estrutura de DateTime . (Para obter detalhes sobre o construtor padrão implícito de um tipo de valor, consulte Tipos de valor (Referência de C#).) Um equivalente aproximado, para os compiladores que o suporte, é declarando um valor de DateTime sem atribuir explicitamente uma data e hora. O exemplo a seguir ilustra uma chamada para o construtor padrão implícito de DateTime em Visual C# e, bem como uma declaração variável de DateTime sem a atribuição no Visual Basic.

    
    DateTime dat1 = new DateTime();
    // The following method call displays 1/1/0001 12:00:00 AM.
    Console.WriteLine(dat1.ToString(System.Globalization.CultureInfo.InvariantCulture));
    // The following method call displays True.
    Console.WriteLine(dat1.Equals(DateTime.MinValue));
    
    
    

Valores DateTime e as representações da cadeia de caracteres

Internamente, DateTime todos os valores são representados como o número de tiques (o número de intervalos-100 nanossegundos) que se passaram desde 12: 00: 00 meia-noite, 1 º de janeiro, 0001. O valor real DateTime é independente da maneira na qual esse valor aparece quando exibidas em um elemento de interface do usuário ou quando gravados em um arquivo. A aparência de um valor DateTime é o resultado de uma operação de formatação. A formatação é o processo de converter um valor em sua representação de cadeia de caracteres.

Como a aparência dos valores de data e hora é dependente de fatores como cultura, de padrões internacionais, requisitos do aplicativo e preferência pessoal, a estrutura DateTime oferece uma grande quantidade de flexibilidade na formatação valores de data e hora por meio de sobrecargas de seu método ToString. O método padrão DateTime.ToString() retorna a representação de seqüência de caracteres de uma data e valor de tempo usando da cultura atual de data curto e longo tempo padrão. O exemplo a seguir usa o método padrão de DateTime.ToString() para exibir a data e a hora usando o standard curto de data e de hora longo para pt-br E.U. a cultura, a cultura atual no computador no qual o exemplo foi executado.


DateTime date1 = new DateTime(2008, 3, 1, 7, 0, 0);
Console.WriteLine(date1.ToString());
// For en-US culture, displays 3/1/2008 7:00:00 AM


O método DateTime.ToString(IFormatProvider) retorna a representação de seqüência de caracteres de uma data e valor de tempo usando o Data curto e longo tempo padrão de uma cultura específica. O exemplo a seguir usa o método de DateTime.ToString(IFormatProvider) para exibir a data e a hora usando o standard curto de data e de hora longo para a cultura franco- FR.


DateTime date1 = new DateTime(2008, 3, 1, 7, 0, 0);
Console.WriteLine(date1.ToString(System.Globalization.CultureInfo.CreateSpecificCulture("fr-FR")));
// Displays 01/03/2008 07:00:00


O método DateTime.ToString(String) retorna a representação de seqüência de caracteres de data e hora em um formato definido por um padrão ou especificador de formato personalizado e usando as convenções de formatação da cultura atual. O exemplo a seguir usa o método DateTime.ToString(String) para exibir a data completa e tempo padrão para a cultura EN-US, a cultura atual no computador em que o exemplo foi executado.


DateTime date1 = new DateTime(2008, 3, 1, 7, 0, 0);
Console.WriteLine(date1.ToString("F"));
// Displays Saturday, March 01, 2008 7:00:00 AM


O método DateTime.ToString(String, IFormatProvider) retorna a representação de seqüência de caracteres de data e hora em um formato definido por um especificador de formato específicos e usando as convenções de formatação de uma cultura específica. O exemplo a seguir usa o método de DateTime.ToString(String, IFormatProvider) para exibir o padrão completo de data e hora para a cultura franco- FR.


DateTime date1 = new DateTime(2008, 3, 1, 7, 0, 0);
Console.WriteLine(date1.ToString("F", new System.Globalization.CultureInfo("fr-FR")));
// Displays samedi 1 mars 2008 07:00:00


Para obter mais informações sobre como formatar valores de DateTime , consulte Cadeias de formato padrão de data e hora e Cadeias de caracteres de formato personalizadas de data e hora.

Convertendo cadeias de caracteres em valores DateTime

A análise envolve converter a representação de cadeia de caracteres de uma data e hora para um valor de DateTime . Geralmente, as cadeias de caracteres de data e hora têm dois usos diferentes nos aplicativos:

  • Representa uma data e hora que podem adotar uma variedade de formatos e que reflitam as convenções de cultura atual ou de uma determinada cultura. Por exemplo, um aplicativo pode permitir que um usuário cuja cultura atual é pt-br E.U. para inserir um valor de data como “12/15/2013 " ou “15 de dezembro de 2013”, e permite que um usuário cuja cultura atual é en-gb para inserir um valor de data como “15/12/2013 " ou “15 de dezembro de 2013”.

  • Representa uma data e hora em um formato predefinido. Por exemplo, um aplicativo pode serializar uma data como “20130103 " independentemente de cultura no qual o aplicativo está sendo executado, ou pode exigir que uma entrada seja data no formato de data abreviada de cultura atual.

Você pode usar o método de Parse ou de TryParse para converter uma cadeia de caracteres que pode refletir um dos formatos comuns de data e hora usados por uma cultura como um valor de DateTime . O exemplo a seguir mostra como você pode usar TryParse para converter cadeias de caracteres de data em vários formatos específicos com diferentes para um valor de DateTime . Altera a cultura atual para inglês (grã-bretanha) e para chamar o método de GetDateTimeFormats() para gerar uma matriz de cadeias de caracteres de data e hora. Passa cada elemento na matriz ao método de TryParse . A saída de exemplo mostram que o método de análise foi possível converter com êxito cada uma das cadeias de caracteres específicos de cultura de data e hora.

Você pode usar os métodos de TryParse e de TryParseExact para converter uma cadeia de caracteres de data e hora que deve corresponder a um formato ou formatos específicos para um valor de DateTime . Você especifica o formato ou os formatos obrigatórios como um parâmetro para o método de análise usando uma ou mais cadeias de caracteres de formato padrão ou de data e hora de personalizadas . O exemplo a seguir usa o método de TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) para converter cadeias de caracteres que devem estar em um formato “yyyyMMdd” ou em um formato “HHmmss” para os valores de DateTime .

Os métodos de Parse e de ParseExact lança uma exceção se a cadeia de caracteres a ser convertida em um valor de DateTime não pode ser analisada. Os métodos de TryParse e de TryParseExact retornam um valor booliano que indica se a conversão bem-sucedida ou falhou. Por que a operação de análise para cadeias de caracteres de data e hora, especialmente se as cadeias de caracteres são registradas por usuários, tende a ter uma taxa alta de falhas e, como a manipulação de exceção é dispendiosa, você deve usar TryParse os métodos ou do TryParseExact em cenários em que o desempenho é importante ou as conversões estão sujeitas a uma taxa alta de falha.

Para obter mais informações sobre de valores de data e hora da análise, consulte Cadeias de caracteres de data e hora de análise.

Considerações da versão

Antes de para o .NET Framework versão 2.0, a estrutura DateTime contém um campo de 64 bits composto de um campo 2 bits não utilizado concatenado com um campo escalas particular, que é um campo que contém o número de tiques que representam a data e hora 62 bits sem sinal. O valor do campo de tiques pode ser obtido com a propriedade de Ticks .

Iniciando com o .NET Framework 2.0, a estrutura DateTime contém um campo de 64 bits composto de um campo particular Kind concatenado com o campo escalas. O campo Kind é um campo 2 bits que indica se a estrutura DateTime representa uma hora local, um Tempo Universal Coordenado (UTC) ou a hora em um zona de tempo não especificado. O campo Kind é usado durante a execução tempo conversões entre fusos horários, mas não para comparações tempo ou aritmética. O valor do campo de tipo pode ser obtido com a propriedade de Kind .

ObservaçãoObservação

Uma alternativa para a estrutura DateTime para trabalhar com valores de data e hora em particular fuso horário é a estrutura DateTimeOffset. A estrutura DateTimeOffset armazena informações sobre em um campo particular DateTime e o número de minutos pelo qual que data e hora difere do UTC em uma Private Int16 campo Data e hora. Isso possibilita para um valor DateTimeOffset para refletir o tempo em um determinado zona de tempo, enquanto um valor DateTime sem ambigüidade pode refletir somente UTC e o local zona de tempo do tempo. Para obter uma discussão sobre quando usar a estrutura de DateTime ou DateTimeOffset estruturar ao trabalhar com valores de data e hora, consulte Escolhendo entre DateTime, DateTimeOffset e TimeZoneInfo.

Valores DateTime

Descrições dos valores de hora no tipo de DateTime são geralmente expressos usando o padrão Tempo Universal Coordenado (UTC), que é o nome reconhecido internacionalmente de Greenwich (GMT). Tempo Universal Coordenado é a hora, medida em zero longitude graus, o ponto de origem UTC. O horário de verão não é aplicável ao UTC.

Hora Local é relativo a uma determinada zona de tempo. Um zona de tempo está associado com um deslocamento zona de tempo, que é o deslocamento de zona de tempo a medida em horas a partir do ponto de origem UTC. Além disso, a hora local, opcionalmente, é afetado por horário de verão, que adiciona ou retira uma hora do comprimento de um dia. Conseqüentemente, a hora local é calculado pela adicionando o deslocamento zona de tempo a UTC e ajustando para horário de verão, se necessário. O deslocamento de fuso horário no ponto de origem UTC será zero.

Hora UTC é adequada para cálculos, comparações, armazenamento datas e hora em arquivos. Horário local é adequado para exibição em interfaces de usuário de aplicativos de área de trabalho. Hora zona- aplicativos reconheçam (como muitos aplicativos Web) também precisam trabalhar com um número de outros fusos horários.

Se a propriedade de Kind de um objeto de DateTime é DateTimeKind.Unspecified, não será especificado se o tempo são representados hora local, a hora UTC, ou cada vez em qualquer outro fuso horário.

Operações DateTime

Um cálculo usando uma estrutura DateTime, como Add ou Subtract, não modifica o valor da estrutura. Em vez disso, o cálculo retorna uma nova estrutura DateTime cujo valor é o resultado do cálculo.

Operações de conversão entre fusos horários (tais como entre o UTC e a hora local, ou entre um zona de tempo e outro) horário de verão levar em conta, mas não operações aritmética e comparação. 

A estrutura DateTime próprio oferece suporte limitado para converter um zona de tempo para outro. Você pode usar o método ToLocalTime para converter UTC em horário local, ou você pode usar o método ToUniversalTime para converter a hora local em UTC. No entanto, um conjunto completo de métodos de conversão zona de tempo está disponível na classe TimeZoneInfo. Usando esses métodos, você pode converter a hora em qualquer um dos fusos horários do mundo a hora em qualquer outro fuso horário.

Cálculos e comparações de objetos DateTime são significativas somente se os objetos representam vezes o mesmo zona de tempo. Você pode usar um objeto de TimeZoneInfo para representar o fuso horário de um valor de DateTime , embora os dois sejam acoplados de forma flexível. (Isto é, um objeto de DateTime não tem uma propriedade que retorna um objeto que representa o fuso horário da data e do valor do tempo diferente da propriedade de Kind .) Por esse motivo, em um aplicativo zona- ciente de tempo, você deve confiar em qualquer mecanismo externa para determinar o fuso horário em que um objeto de DateTime foi criado. Por exemplo, você pode usar uma estrutura que é disposto tanto o valor DateTime e TimeZoneInfo Objeto que representa o valor do DateTime zona de tempo. Para obter detalhes sobre usando UTC em cálculos e comparações com DateTime valores, consulte Executando Operações Aritméticas com Datas e Horas.

Cada membro de DateTime usará implicitamente o calendário gregoriano para executar sua operação, com exceção dos construtores que especificam um calendário, e os métodos com um parâmetro derivado de IFormatProvider, como System.Globalization.DateTimeFormatInfo, que especifica implicitamente um calendário.

As operações por membros de tipo de DateTime levam em conta detalhes como anos bissextos e o número de dias do mês.

Duas outras operações comuns com os valores de DateTime envolvem converter um valor de data e hora para ou de sua representação de cadeia de caracteres. O processo de converter um valor de DateTime em sua representação de cadeia de caracteres é uma operação de formatação; para obter mais informações sobre de formatação, consulte Valores de data e hora e suas representações de cadeia de caracteres. O processo de converter a representação de cadeia de caracteres de uma data e hora para um valor de DateTime é uma operação de análise; para obter mais informações sobre a análise, consulte Convertendo cadeias de caracteres com os valores de data e hora.

DateTime x TimeSpan

O DateTime e TimeSpan tipos de valor são diferentes que um DateTime representa um instante no tempo enquanto um TimeSpan representa um intervalo de tempo. Isso significa, por exemplo, que você pode subtrair uma instância de DateTime a partir de outro para obter um objeto TimeSpan que representa o intervalo de tempo entre eles. Ou você pode adicionar TimeSpan de adição a DateTime atual para obter um valor de DateTime que representa uma data futura.

Você pode adicionar ou subtrair um intervalo de tempo de um objeto DateTime. Os intervalos de tempo podem ser positivos ou negativos, podem ser expressos em unidades como tiques ou segundos, ou podem ser expressas como um objeto de TimeSpan .

Considerações de interoperabilidade COM

Um valor DateTime que é transferido para um aplicativo COM, e é transferido de volta para um aplicativo gerenciado, é chamado para Round-trip. No entanto, um valor de DateTime que especifica somente uma hora não faz viagem de ida e volta como você poderia esperar.

Se você viagem de ida e volta apenas uma vez, como 3 P.M., o prazo e hora é o 30 de dezembro de 1899 C.E. a as 3:00 P.M., em vez de janeiro, 1, 0001. C.E a as 3:00 PM. Isso acontece porque o.NET Framework e COM assumem uma data padrão no qual apenas uma hora é especificado. Porém, o sistema de COM pressupõe uma data de base de 30 de dezembro de 1899 C.E. quando o.NET Framework suponha que uma data base de janeiro, 1, 0001. C.E.

Quando somente uma vez é passado do .NET Framework para COM, processamento especial é executado que converte o tempo para o formato usado pelo COM. Quando somente uma vez é passado para o .NET Framework de COM, nenhum processamento especial é executado porque que poderia corromper legítimas datas e horas em ou antes 30 de dezembro de 1899. Isso também significa se uma data inicia sua viagem de ida e volta do, COM o.NET Framework e preserva a data.

O comportamento do .NET Framework e COM significa que se seu aplicativo ciclos um DateTime que só especifica um tempo, seu aplicativo deve lembrar-se modificar ou ignorar a data a partir do objeto final DateTime errada.

O exemplo a seguir demonstra como comparar os valores equivalentes de aproximadamente DateTime , aceitando uma margem pequena de diferença ao declarar-los iguais.


using System;

class DateTimeTester 
{
   static bool RoughlyEquals(DateTime time, DateTime timeWithWindow, int windowInSeconds, int frequencyInSeconds)
   {
      long delta = (long)((TimeSpan)(timeWithWindow - time)).TotalSeconds 
                                                     % frequencyInSeconds;

      delta = delta > windowInSeconds ? frequencyInSeconds - delta : delta;

      return Math.Abs(delta) < windowInSeconds;
	}

	public static void Main() 
	{
      int window = 10;
      int freq = 60 * 60 * 2; // 2 hours;

      DateTime d1 = DateTime.Now;

      DateTime d2 = d1.AddSeconds(2 * window);
      DateTime d3 = d1.AddSeconds(-2 * window);
      DateTime d4 = d1.AddSeconds(window / 2);
      DateTime d5 = d1.AddSeconds(-window / 2);

      DateTime d6 = (d1.AddHours(2)).AddSeconds(2 * window);
      DateTime d7 = (d1.AddHours(2)).AddSeconds(-2 * window);
      DateTime d8 = (d1.AddHours(2)).AddSeconds(window / 2);
      DateTime d9 = (d1.AddHours(2)).AddSeconds(-window / 2);

      Console.WriteLine("d1 ({0}) ~= d1 ({1}): {2}",
                        d1, d1, RoughlyEquals(d1, d1, window, freq));
      Console.WriteLine("d1 ({0}) ~= d2 ({1}): {2}", 
                        d1, d2, RoughlyEquals(d1, d2, window, freq));
      Console.WriteLine("d1 ({0}) ~= d3 ({1}): {2}", 
                        d1, d3, RoughlyEquals(d1, d3, window, freq));
      Console.WriteLine("d1 ({0}) ~= d4 ({1}): {2}", 
                        d1, d4, RoughlyEquals(d1, d4, window, freq));
      Console.WriteLine("d1 ({0}) ~= d5 ({1}): {2}", 
                        d1, d5, RoughlyEquals(d1, d5, window, freq));

      Console.WriteLine("d1 ({0}) ~= d6 ({1}): {2}", 
                        d1, d6, RoughlyEquals(d1, d6, window, freq));
      Console.WriteLine("d1 ({0}) ~= d7 ({1}): {2}", 
                        d1, d7, RoughlyEquals(d1, d7, window, freq));
      Console.WriteLine("d1 ({0}) ~= d8 ({1}): {2}", 
                        d1, d8, RoughlyEquals(d1, d8, window, freq));
      Console.WriteLine("d1 ({0}) ~= d9 ({1}): {2}", 
                        d1, d9, RoughlyEquals(d1, d9, window, freq));
	}
}
// The example displays output similar to the following:
//    d1 (1/28/2010 9:01:26 PM) ~= d1 (1/28/2010 9:01:26 PM): True
//    d1 (1/28/2010 9:01:26 PM) ~= d2 (1/28/2010 9:01:46 PM): False
//    d1 (1/28/2010 9:01:26 PM) ~= d3 (1/28/2010 9:01:06 PM): False
//    d1 (1/28/2010 9:01:26 PM) ~= d4 (1/28/2010 9:01:31 PM): True
//    d1 (1/28/2010 9:01:26 PM) ~= d5 (1/28/2010 9:01:21 PM): True
//    d1 (1/28/2010 9:01:26 PM) ~= d6 (1/28/2010 11:01:46 PM): False
//    d1 (1/28/2010 9:01:26 PM) ~= d7 (1/28/2010 11:01:06 PM): False
//    d1 (1/28/2010 9:01:26 PM) ~= d8 (1/28/2010 11:01:31 PM): True
//    d1 (1/28/2010 9:01:26 PM) ~= d9 (1/28/2010 11:01:21 PM): True


.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Biblioteca de Classes Portátil

Com suporte em: Biblioteca de Classes Portátil

.NET para aplicativos da Windows Store

Com suporte em: Windows 8

.NET para aplicativos do Windows Phone

Com suporte em: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Todos os membros desse tipo são segmento seguro. Os membros que aparecem para modificar o estado da instância, na verdade, retornam uma nova instância inicializada com o novo valor. Como com qualquer outro tipo, leitura e gravação a uma variável compartilhada que contém uma instância desse tipo deve ser protegida por um bloqueio para garantir segurança de segmentos.

Observação de cuidadoCuidado

A atribuição de uma instância desse tipo não é thread-safe em todas as plataformas de hardware porque a representação binária dessa instância pode ser muito grande para ser atribuída em uma única operação atômica.

Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários

Contribuições da comunidade

A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2015 Microsoft