Date Classe

Definição

Namespace:: Java.Util

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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.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: Object

JavaObject

Object
Date

Derivado: Java.Sql.Date

Java.Sql.Time

Java.Sql.Timestamp

Atributos: RegisterAttribute

Implementações: IJavaObject IJavaPeerable ISerializable ICloneable IComparable IDisposable

Comentários

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

Antes do JDK 1.1, a classe Date tinha duas funções adicionais. Permitiu a interpretação de datas como ano, mês, dia, hora, minuto e segundo valores. Também permitiu a formatação e a 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 do JDK 1.1, a Calendar classe deve ser usada para converter entre datas e campos de hora e a DateFormat classe deve ser usada para formatar e analisar cadeias de caracteres de data. Os métodos correspondentes são Date preteridos.

Embora a Date classe se destine a refletir utc (tempo universal coordenado), ela pode não fazê-lo exatamente, dependendo do ambiente de host do Java Máquina Virtual. Quase todos os sistemas operacionais modernos pressupõem que 1 dia = 24 &vezes; 60 &vezes; 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 salto". O segundo salto é 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 tinha 61 segundos, graças a um segundo salto adicional. A maioria dos relógios de computador não é precisa o suficiente para refletir a distinção de segundo bissexto.

Alguns padrões de computador são definidos em termos de GMT (tempo médio de Greenwich), que é equivalente ao tempo universal (UT). GMT é o nome "civil" para o padrão; 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 (desacelera e acelera de maneiras complicadas), a UT nem sempre flui uniformemente. Segundos bissextos são introduzidos conforme necessário em UTC, de modo a manter UTC dentro de 0,9 segundos de UT1, que é uma versão de UT com determinadas correções aplicadas. Há outros sistemas de data e hora também; por exemplo, a escala de tempo usada pelo GPS (sistema de posicionamento global) baseado em satélite é sincronizada com UTC, mas não é ajustada por segundos bissextos. Uma fonte interessante de mais informações é o Observatório Naval Estados Unidos (USNO): <blockquote>

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

</blockquote>

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

<a href="https://www.usno.navy.mil/USNO/time/master-clock/systems-of-time">https://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, a hora da meia-noite à 1 da manhã é hora 0, e a hora do meio-dia às 13:00 é 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 de Java que realmente acompanham os segundos bissextos corretamente. Devido à maneira como os segundos bissextos são introduzidos no momento, é 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 fornecidos aos métodos para essas finalidades não precisam 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.

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

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

Construtores

Nome	Description
Date()	Aloca um `Date` objeto e inicializa-o para que ele represente o tempo em que foi alocado, medido para o milissegundo mais próximo.
Date(Int32, Int32, Int32, Int32, Int32, Int32)	Obsoleto. Aloca um `Date` objeto e inicializa-o para que ele represente o instante no início do segundo especificado pelo `year`, `month`, `date`, , `hrsmin`e `sec` argumentos, no fuso horário local.
Date(Int32, Int32, Int32, Int32, Int32)	Obsoleto. Aloca um `Date` objeto e inicializa-o para que ele represente o instante no início do minuto especificado pelo `year`, `month`, `date`, `hrs`e `min` argumentos, no fuso horário local.
Date(Int32, Int32, Int32)	Obsoleto. Aloca um `Date` objeto e inicializa-o para que ele represente meia-noite, hora local, no início do dia especificado pelo `year`, `month`e `date` argumentos.
Date(Int64)	Aloca um `Date` objeto e o inicializa para representar o número especificado de milissegundos desde o horário base padrão conhecido 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 runtime.
Date(String)	Obsoleto. Aloca um `Date` objeto e inicializa-o 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

Nome	Description
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 como o valor especificado.
JniIdentityHashCode	Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade. (Herdado de Object)
JniManagedPeerState	A classe `Date` representa um instante específico no tempo, com precisão de milissegundos. (Herdado de JavaObject)
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 como 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 como o valor especificado.
PeerReference	Obtém a referência de objeto JNI para este par Java. (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` como o valor especificado.
ThresholdClass	Essa API é compatível com a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código.
ThresholdType	Essa API é compatível com 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 a UTC que é apropriado para o tempo representado 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 instantâneo no tempo representado por esse `Date` objeto, conforme interpretado no fuso horário local. -ou- Define o ano deste `Date` objeto como o valor especificado mais 1900.

Métodos

Nome	Description
After(Date)	Testa se essa data é após a data especificada.
Before(Date)	Testa se essa data está antes da data especificada.
Clone()	Retorne uma cópia deste objeto.
CompareTo(Date)	Compara duas Datas para ordenação.
Construct(JniObjectReference, JniObjectReferenceOptions)	A classe `Date` representa um instante específico no tempo, com precisão de milissegundos. (Herdado de JavaObject)
Dispose()	Libera os recursos mantidos por esse par Java. (Herdado de Object)
Dispose(Boolean)	Libera os recursos mantidos por esse par Java. (Herdado de Object)
DisposeUnlessReferenced()	A classe `Date` representa um instante específico no tempo, com precisão de milissegundos. (Herdado de JavaObject)
Equals(Object)	A classe `Date` representa um instante específico no tempo, com precisão de milissegundos. (Herdado de JavaObject)
Equals(Object)	Indica se algum outro objeto é "igual a" este. (Herdado de Object)
From(Instant)	Obtém uma instância de `Date` um `Instant` objeto.
GetDate()	Obsoleto. Retorna o dia do mês representado por este `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 desse 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 como o valor especificado.
SetHandle(IntPtr, JniHandleOwnership)	Define a propriedade Handle (Herdado de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	A classe `Date` representa um instante específico no tempo, com precisão de milissegundos. (Herdado de JavaObject)
ToArray<T>()	Cria uma matriz gerenciada com base nesse wrapper de matriz Java. (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 `Instant`.
ToLocaleString()	Obsoleto. Cria uma representação de cadeia de caracteres desse `Date` objeto em um formulário dependente de implementação.
ToString()	Retorna uma representação de cadeia de caracteres do objeto. (Herdado de Object)
UnregisterFromRuntime()	Cancela o registro desse par Java do runtime de interoperabilidade. (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 seja despertado, normalmente sendo <notificado></em> ou <em>interrompido</em>. (Herdado de Object)
Wait(Int64, Int32)	Faz com que o thread atual aguarde até que seja ativado, normalmente sendo <notificado></em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)
Wait(Int64)	Faz com que o thread atual aguarde até que seja ativado, normalmente sendo <notificado></em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido. (Herdado de Object)

Implantações explícitas de interface

Nome	Description
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 JavaObject)
IJavaPeerable.Finalized()	A classe `Date` representa um instante específico no tempo, com precisão de milissegundos. (Herdado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	A classe `Date` representa um instante específico no tempo, com precisão de milissegundos. (Herdado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	A classe `Date` representa um instante específico no tempo, com precisão de milissegundos. (Herdado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	A classe `Date` representa um instante específico no tempo, com precisão de milissegundos. (Herdado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	A classe `Date` representa um instante específico no tempo, com precisão de milissegundos. (Herdado de JavaObject)
IJavaPeerable.UnregisterFromRuntime()	A classe `Date` representa um instante específico no tempo, com precisão de milissegundos.

Métodos de Extensão

Nome	Description
GetJniTypeName(IJavaPeerable)	Obtém o nome JNI do tipo da instância `self`.
JavaAs<TResult>(IJavaPeerable)	Tente coagir a digitar `selfTResult`, verificando se a coerção é válida no lado Java.
JavaCast<TResult>(IJavaObject)	Executa uma conversão de tipo marcada por runtime do Android.
JavaCast<TResult>(IJavaObject)	A classe `Date` representa um instante específico no tempo, com precisão de milissegundos.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Tente coagir a digitar `selfTResult`, verificando se a coerção é válida no lado Java.

Aplica-se a