Partilhar via


Date Classe

Definição

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

[Android.Runtime.Register("java/util/Date", DoNotGenerateAcw=true)]
public class Date : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable, Java.Lang.ICloneable, Java.Lang.IComparable
[<Android.Runtime.Register("java/util/Date", DoNotGenerateAcw=true)>]
type Date = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICloneable
    interface IComparable
Herança
Date
Derivado
Atributos
Implementações

Comentários

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

Antes do JDK  1.1, a turma Date tinha duas funções adicionais. Permitiu a interpretação das datas como ano, mês, dia, hora, minuto e segundos valores. Ele também permitiu a formatação e análise de cadeias de caracteres de data. Infelizmente, a API para essas funções não era passível de internacionalização. A partir de JDK  1.1, a Calendar classe deve ser usada para converter entre campos de data e hora e a DateFormat classe deve ser usada para formatar e analisar cadeias de caracteres de data. Os métodos correspondentes em Date foram preteridos.

Embora a classe se destine a refletir o Date tempo universal coordenado (UTC), ela pode não fazer isso exatamente, dependendo do ambiente de host da Java Virtual Machine. Quase todos os sistemas operacionais modernos assumem que 1  dia = 24  &horários;   60  &horários;   60 = 86400 segundos em todos os casos. No UTC, no entanto, cerca de uma vez a cada ano ou dois há um segundo extra, chamado de "segundo bissexto". O segundo bissexto é sempre adicionado como o último segundo do dia, e sempre em 31 de dezembro ou 30 de junho. Por exemplo, o último minuto do ano de 1995 teve 61 segundos, graças a um salto adicional. A maioria dos relógios de computador não são precisos o suficiente para serem capazes de refletir a distinção de segundo bissexto.

Alguns padrões computacionais são definidos em termos de tempo médio de Greenwich (GMT), que é equivalente ao tempo universal (UT). GMT é o nome "civil" para a norma; UT é o nome "científico" para o mesmo padrão. A distinção entre UTC e UT é que UTC é baseado em um relógio atômico e UT é baseado em observações astronômicas, que para todos os fins práticos é um cabelo invisivelmente fino para dividir. Como a rotação da Terra não é uniforme (ela desacelera e acelera de maneiras complicadas), a UT nem sempre flui uniformemente. Os segundos bissextos são introduzidos conforme necessário no UTC de modo a manter o UTC dentro de 0,9 segundos do UT1, que é uma versão do UT com certas correções aplicadas. Existem outros sistemas de data e hora também; por exemplo, a escala de tempo usada pelo sistema de posicionamento global (GPS) baseado em satélite é sincronizada com UTC, mas não é ajustada para segundos bissextos. Uma fonte interessante de mais informações é o Observatório Naval dos Estados Unidos (USNO): <blockquote>

<a href="http://www.usno.navy.mil/USNO">http://www.usno.navy.mil/USNO</a>

</blockquote>

e o material sobre "Sistemas de Tempo" em: <blockquote>

<a href="http://www.usno.navy.mil/USNO/time/master-clock/systems-of-time">http://www.usno.navy.mil/USNO/time/master-clock/systems-of-time</a>

</blockquote>

que tem descrições de vários sistemas de tempo diferentes, incluindo UT, UT1 e UTC.

Em todos os métodos de classe Date que aceitam ou retornam valores de ano, mês, data, horas, minutos e segundos, as seguintes representações são usadas: <ul><li>Um ano y é representado pelo inteiro y - 1900. <li>Um mês é representado por um inteiro de 0 a 11, 0 é janeiro, 1 é fevereiro e assim por diante, portanto, 11 é dezembro. <li>Uma data (dia do mês) é representada por um inteiro de 1 a 31 da maneira usual. <li>Uma hora é representada por um inteiro de 0 a 23. Assim, o horário da meia-noite à 1h é a hora 0, e o horário do meio-dia às 13h é a hora 12. <li>Um minuto é representado por um inteiro de 0 a 59 da maneira usual. <li>Um segundo é representado por um inteiro de 0 a 61, os valores 60 e 61 ocorrem apenas para segundos bissextos e, mesmo assim, apenas em implementações Java que realmente rastreiam segundos bissextos corretamente. Devido à maneira como os segundos bissextos são atualmente introduzidos, é extremamente improvável que dois segundos bissextos ocorram no mesmo minuto, mas essa especificação segue as convenções de data e hora para ISO C. </Ul>

Em todos os casos, os argumentos apresentados aos métodos para estes fins não têm de se enquadrar nos intervalos indicados; por exemplo, uma data pode ser especificada como 32 de janeiro e é interpretada como significando 1º de fevereiro.

Adicionado em 1.0.

Documentação Java para java.util.Date.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Construtores

Date()

Aloca um Date objeto e o inicializa de modo que ele represente o tempo em que ele foi alocado, medido até o milissegundo mais próximo.

Date(Int32, Int32, Int32)
Obsoleto.

Aloca um Date objeto e o inicializa para que ele represente meia-noite, hora local, no início do dia especificado pelos yearargumentos , monthe date .

Date(Int32, Int32, Int32, Int32, Int32)
Obsoleto.

Aloca um Date objeto e o inicializa para que ele represente o instante no início do minuto especificado pelos yearargumentos , month, , datehrs, e min no fuso horário local.

Date(Int32, Int32, Int32, Int32, Int32, Int32)
Obsoleto.

Aloca um Date objeto e o inicializa para que ele represente o instante no início do segundo especificado pelos yearargumentos , month, , datehrsmin, , e sec no fuso horário local.

Date(Int64)

Aloca um Date objeto e o inicializa para representar o número especificado de milissegundos desde a hora base padrão conhecida como "a época", ou seja, 1º de janeiro de 1970, 00:00:00 GMT.

Date(IntPtr, JniHandleOwnership)

Um construtor usado ao criar representações gerenciadas de objetos JNI; chamado pelo tempo de execução.

Date(String)
Obsoleto.

Aloca um Date objeto e o inicializa para que ele represente a data e a hora indicadas pela cadeia de caracteres s, que é interpretada como se fosse pelo Date#parse método.

Propriedades

Class

Retorna a classe de tempo de execução deste Object.

(Herdado de Object)
Day
Obsoleto.

Retorna o dia da semana representado por essa data.

Handle

O identificador para a instância subjacente do Android.

(Herdado de Object)
Hours
Obsoleto.

Retorna a hora representada por esse Date objeto. -ou- Define a hora deste Date objeto para o valor especificado.

JniIdentityHashCode

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

(Herdado de Object)
JniPeerMembers

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

Minutes
Obsoleto.

Retorna o número de minutos após a hora representada por essa data, conforme interpretado no fuso horário local. -ou- Define os minutos deste Date objeto para o valor especificado.

Month
Obsoleto.

Retorna um número que representa o mês que contém ou começa com o instante no tempo representado por esse Date objeto. -ou- Define o mês desta data para o valor especificado.

PeerReference

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

(Herdado de Object)
Seconds
Obsoleto.

Retorna o número de segundos após o minuto representado por essa data. -ou- Define os segundos disso Date para o valor especificado.

ThresholdClass

Esta API suporta a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código.

ThresholdType

Esta API suporta a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código.

Time

Retorna o número de milissegundos desde 1º de janeiro de 1970, 00:00:00 GMT representado por este Date objeto. -ou- Define este Date objeto para representar um ponto no tempo que é time milissegundos após 1 de janeiro de 1970 00:00:00 GMT.

TimezoneOffset
Obsoleto.

Retorna o deslocamento, medido em minutos, para o fuso horário local em relação ao UTC que é apropriado para a hora representada por esse Date objeto.

Year
Obsoleto.

Retorna um valor que é o resultado da subtração de 1900 do ano que contém ou começa com o instante no tempo representado por esse Date objeto, conforme interpretado no fuso horário local. -ou- Define o ano deste Date objeto como sendo o valor especificado mais 1900.

Métodos

After(Date)

Testa se essa data for posterior à data especificada.

Before(Date)

Testa se essa data for anterior à data especificada.

Clone()

Retornar uma cópia deste objeto.

CompareTo(Date)

Compara duas Datas para pedido.

Dispose()

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

(Herdado de Object)
Dispose(Boolean)

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

(Herdado de Object)
Equals(Object)

Indica se algum outro objeto é "igual" a este.

(Herdado de Object)
From(Instant)

Obtém uma instância de Date de um Instant objeto.

GetDate()
Obsoleto.

Retorna o dia do mês representado por esse Date objeto.

GetHashCode()

Retorna um valor de código hash para o objeto.

(Herdado de Object)
JavaFinalize()

Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto.

(Herdado de Object)
Notify()

Ativa um único thread que está aguardando no monitor deste objeto.

(Herdado de Object)
NotifyAll()

Ativa todos os threads que estão aguardando no monitor deste objeto.

(Herdado de Object)
Parse(String)
Obsoleto.

Tenta interpretar a cadeia de caracteres s como uma representação de uma data e hora.

SetDate(Int32)
Obsoleto.

Define o dia do mês deste Date objeto para o valor especificado.

SetHandle(IntPtr, JniHandleOwnership)

Define a propriedade Handle.

(Herdado de Object)
ToArray<T>()

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

(Herdado de Object)
ToGMTString()
Obsoleto.

Cria uma representação de cadeia de caracteres deste Date objeto do formulário: <blockquote>

ToInstant()

Converte esse Date objeto em um Instantarquivo .

ToLocaleString()
Obsoleto.

Cria uma representação de cadeia de caracteres desse Date objeto em um formulário dependente da implementação.

ToString()

Retorna uma representação de cadeia de caracteres do objeto.

(Herdado de Object)
UnregisterFromRuntime()

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

(Herdado de Object)
UTC(Int32, Int32, Int32, Int32, Int32, Int32)
Obsoleto.

Determina a data e a hora com base nos argumentos.

Wait()

Faz com que o thread atual aguarde até que ele seja ativado, normalmente sendo <em notificado</em> ou <em>interrompido</em>>.

(Herdado de Object)
Wait(Int64)

Faz com que o thread atual aguarde até que ele seja despertado, normalmente sendo <em>notificado</em> ou <em interrompido</em>, ou até que>uma certa quantidade de tempo real tenha decorrido.

(Herdado de Object)
Wait(Int64, Int32)

Faz com que o thread atual aguarde até que ele seja despertado, normalmente sendo <em>notificado</em> ou <em interrompido</em>, ou até que>uma certa quantidade de tempo real tenha decorrido.

(Herdado de Object)

Implantações explícitas de interface

IComparable.CompareTo(Object)

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

IJavaPeerable.Disposed()

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

(Herdado de Object)
IJavaPeerable.DisposeUnlessReferenced()

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

(Herdado de Object)
IJavaPeerable.Finalized()

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

(Herdado de Object)
IJavaPeerable.JniManagedPeerState

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

(Herdado de Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

(Herdado de Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

(Herdado de Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

(Herdado de Object)

Métodos de Extensão

JavaCast<TResult>(IJavaObject)

Executa uma conversão de tipo verificada em tempo de execução do Android.

JavaCast<TResult>(IJavaObject)

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

GetJniTypeName(IJavaPeerable)

A classe Date representa um instante específico no tempo, com precisão de milissegundos.

Aplica-se a