Date Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
La classe Date
représente un instant spécifique dans le temps, avec une précision en millisecondes.
[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
- Héritage
- Dérivé
- Attributs
- Implémente
Remarques
La classe Date
représente un instant spécifique dans le temps, avec une précision en millisecondes.
Avant JDK ; 1.1, la classe Date
avait deux fonctions supplémentaires. Elle permettait l’interprétation des dates comme année, mois, jour, heure, minute et seconde valeurs. Elle a également permis la mise en forme et l’analyse des chaînes de date. Malheureusement, l’API pour ces fonctions n’était pas aménable à l’internationalisation. A partir de JDK ; 1.1, la Calendar
classe doit être utilisée pour convertir entre les champs de dates et d’heure et la DateFormat
classe doit être utilisée pour mettre en forme et analyser les chaînes de date. Les méthodes correspondantes sont Date
déconseillées.
Bien que la Date
classe soit destinée à refléter l’heure universelle coordonnée (UTC), elle peut ne pas le faire exactement, en fonction de l’environnement hôte de la machine virtuelle Java. Presque tous les systèmes d’exploitation modernes supposent que 1 ; day ;= 24 ; × ; ; 60 ; × ; ; 60 ;= 86400 secondes dans tous les cas. Toutefois, en UTC, environ une fois par an ou deux, il y a une seconde supplémentaire, appelée « saut de seconde ». La seconde de saut est toujours ajoutée comme la dernière seconde de la journée, et toujours le 31 décembre ou le 30 juin. Par exemple, la dernière minute de l’année 1995 a duré 61 secondes, grâce à une seconde de saut supplémentaire. La plupart des horloges d’ordinateur ne sont pas suffisamment précises pour pouvoir refléter la distinction saut-seconde.
Certaines normes informatiques sont définies en termes de temps moyen de Greenwich (GMT), ce qui équivaut à l’heure universelle (UT). GMT est le nom « civil » de la norme ; L’UT est le nom « scientifique » pour la même norme. La distinction entre UTC et UT est que UTC est basé sur une horloge atomique et l’UT est basé sur des observations astronomiques, qui à tous les fins pratiques est un poil invisibble à fractionner. Étant donné que la rotation de la terre n’est pas uniforme (elle ralentit et accélère de manière compliquée), l’UT ne circule pas toujours uniformément. Les secondes bissextiles sont introduites en temps UTC afin de conserver l’heure UTC dans les 0,9 secondes de UT1, qui est une version d’UT avec certaines corrections appliquées. Il existe également d’autres systèmes d’heure et de date ; par exemple, l’échelle de temps utilisée par le système de positionnement global basé sur satellite (GPS) est synchronisée avec UTC, mais n’est pas ajustée pour les secondes bissextiles. Une source intéressante d’informations supplémentaires est l’observatoire naval États-Unis (USNO) : <blockquote>
<a href="http://www.usno.navy.mil/USNO">http://www.usno.navy.mil/USNO</a>
</blockquote>
et le matériel relatif aux « systèmes de temps » à : <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>
qui contient des descriptions de différents systèmes de temps, notamment UT, UT1 et UTC.
Dans toutes les méthodes de classe Date
qui acceptent ou retournent l’année, le mois, la date, les heures, les minutes et les secondes, les représentations suivantes sont utilisées : <ul><li>A year y est représenté par l’entier y ;- 1900
. <li>A mois est représenté par un entier compris entre 0 et 11 ; le 0 est le 1er janvier, le 1er février, et ainsi de suite ; donc le 11 décembre. <li>A date (jour du mois) est représentée par un entier compris entre 1 et 31 de la manière habituelle. <li>Une heure est représentée par un entier compris entre 0 et 23. Ainsi, l’heure de minuit à 1 h 0 est l’heure 0, et l’heure de midi à 13 h est l’heure 12. <li>A minute est représenté par un entier compris entre 0 et 59 de la manière habituelle. <li>A seconde est représentée par un entier compris entre 0 et 61 ; les valeurs 60 et 61 se produisent uniquement pendant les secondes bissextiles, et même seulement dans les implémentations Java qui effectuent le suivi correct des secondes de saut. En raison de la façon dont les secondes bissextiles sont actuellement introduites, il est extrêmement peu probable que deux secondes bissextiles se produisent dans la même minute, mais cette spécification suit les conventions de date et d’heure pour ISO C. </Ul>
Dans tous les cas, les arguments donnés aux méthodes à ces fins ne doivent pas se trouver dans les plages indiquées ; par exemple, une date peut être spécifiée comme le 32 janvier et est interprétée comme signifiant le 1er février.
Ajouté dans la version 1.0.
Documentation Java pour java.util.Date
.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.
Constructeurs
Date() |
Alloue un |
Date(Int32, Int32, Int32) |
Obsolète.
Alloue un |
Date(Int32, Int32, Int32, Int32, Int32) |
Obsolète.
Alloue un |
Date(Int32, Int32, Int32, Int32, Int32, Int32) |
Obsolète.
Alloue un |
Date(Int64) |
Alloue un |
Date(IntPtr, JniHandleOwnership) |
Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime. |
Date(String) |
Obsolète.
Alloue un |
Propriétés
Class |
Retourne la classe runtime de ce |
Day |
Obsolète.
Retourne le jour de la semaine représenté par cette date. |
Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
Hours |
Obsolète.
Retourne l’heure représentée par cet |
JniIdentityHashCode |
La classe |
JniPeerMembers |
La classe |
Minutes |
Obsolète.
Retourne le nombre de minutes passées par l’heure représentée par cette date, comme interprété dans le fuseau horaire local. -ou- Définit les minutes de cet |
Month |
Obsolète.
Retourne un nombre représentant le mois qui contient ou commence par l’instant dans le temps représenté par cet |
PeerReference |
La classe |
Seconds |
Obsolète.
Retourne le nombre de secondes passées par la minute représentée par cette date. -ou- Définit les secondes de cette |
ThresholdClass |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
ThresholdType |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
Time |
Retourne le nombre de millisecondes depuis le 1er janvier 1970, 00:00:00 GMT représenté par cet |
TimezoneOffset |
Obsolète.
Retourne le décalage, mesuré en minutes, pour le fuseau horaire local par rapport à l’heure UTC appropriée pour l’heure représentée par cet |
Year |
Obsolète.
Retourne une valeur qui est le résultat de la soustraction de 1900 de l’année qui contient ou commence par l’instant dans le temps représenté par cet |
Méthodes
After(Date) |
Teste si cette date est postérieure à la date spécifiée. |
Before(Date) |
Teste si cette date est antérieure à la date spécifiée. |
Clone() |
Retourne une copie de cet objet. |
CompareTo(Date) |
Compare deux dates pour la commande. |
Dispose() |
La classe |
Dispose(Boolean) |
La classe |
Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
From(Instant) |
Obtient une instance d’un |
GetDate() |
Obsolète.
Retourne le jour du mois représenté par cet |
GetHashCode() |
Retourne une valeur de code de hachage pour l'objet. (Hérité de Object) |
JavaFinalize() |
Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object) |
Notify() |
Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object) |
NotifyAll() |
Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object) |
Parse(String) |
Obsolète.
Tente d’interpréter la chaîne |
SetDate(Int32) |
Obsolète.
Définit le jour du mois de cet |
SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
ToArray<T>() |
La classe |
ToGMTString() |
Obsolète.
Crée une représentation sous forme de chaîne de cet |
ToInstant() |
Convertit cet |
ToLocaleString() |
Obsolète.
Crée une représentation sous forme dépendante de l’implémentation de cet |
ToString() |
Retourne une représentation de chaîne de l'objet. (Hérité de Object) |
UnregisterFromRuntime() |
La classe |
UTC(Int32, Int32, Int32, Int32, Int32, Int32) |
Obsolète.
Détermine la date et l’heure en fonction des arguments. |
Wait() |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object) |
Wait(Int64) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
Wait(Int64, Int32) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
Implémentations d’interfaces explicites
IComparable.CompareTo(Object) |
La classe |
IJavaPeerable.Disposed() |
La classe |
IJavaPeerable.DisposeUnlessReferenced() |
La classe |
IJavaPeerable.Finalized() |
La classe |
IJavaPeerable.JniManagedPeerState |
La classe |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
La classe |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
La classe |
IJavaPeerable.SetPeerReference(JniObjectReference) |
La classe |
Méthodes d’extension
JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
JavaCast<TResult>(IJavaObject) |
La classe |
GetJniTypeName(IJavaPeerable) |
La classe |