DateFormat 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.
DateFormat est une classe abstraite pour les sous-classes de mise en forme de date/heure qui met en forme et analyse les dates ou l’heure de manière indépendante de la langue.
[Android.Runtime.Register("java/text/DateFormat", DoNotGenerateAcw=true)]
public abstract class DateFormat : Java.Text._Format[<Android.Runtime.Register("java/text/DateFormat", DoNotGenerateAcw=true)>]
type DateFormat = class
inherit _Format- Héritage
- Dérivé
- Attributs
Remarques
DateFormat est une classe abstraite pour les sous-classes de mise en forme de date/heure qui met en forme et analyse les dates ou l’heure de manière indépendante de la langue. La sous-classe de mise en forme de date/heure, telle que SimpleDateFormat, permet la mise en forme (par exemple, le texte de date et de date), l’analyse (texte &rarr ; date) et la normalisation. La date est représentée en tant qu’objet Date ou en millisecondes depuis le 1er janvier 1970, 00:00:00 GMT.
DateFormat fournit de nombreuses méthodes de classe pour obtenir des formateurs de date/heure par défaut en fonction des paramètres régionaux par défaut ou d’un certain nombre de styles de mise en forme. Les styles de mise en forme incluent #FULL, #LONG, #MEDIUMet #SHORT. Des détails supplémentaires et des exemples d’utilisation de ces styles sont fournis dans les descriptions de méthode.
DateFormat vous permet de mettre en forme et d’analyser des dates pour tous les paramètres régionaux. Votre code peut être complètement indépendant des conventions de paramètres régionaux pendant des mois, des jours de la semaine ou même du format de calendrier : lunaire et solaire.
Pour mettre en forme une date pour les paramètres régionaux actuels, utilisez l’une des méthodes de fabrique statiques : <blockquote>
{@code
myString = DateFormat.getDateInstance().format(myDate);
}
</blockquote>
Si vous mettez en forme plusieurs dates, il est plus efficace d’obtenir le format et de l’utiliser plusieurs fois afin que le système n’ait pas besoin d’extraire les informations sur la langue locale et les conventions de pays plusieurs fois. <blockquote>
{@code
DateFormat df = DateFormat.getDateInstance();
for (int i = 0; i < myDate.length; ++i) {
output.println(df.format(myDate[i]) + "; ");
}
}
</blockquote>
Pour mettre en forme une date pour un autre paramètre régional, spécifiez-la dans l’appel à #getDateInstance(int, Locale) getDateInstance().
<blockquote>
{@code
DateFormat df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE);
}
</blockquote>
Vous pouvez également utiliser un DateFormat pour analyser. <blockquote>
{@code
myDate = df.parse(myString);
}
</blockquote>
Permet getDateInstance d’obtenir le format de date normal pour ce pays. Il existe d’autres méthodes de fabrique statique disponibles. Permet getTimeInstance d’obtenir le format d’heure pour ce pays. Permet getDateTimeInstance d’obtenir un format de date et d’heure. Vous pouvez transmettre différentes options à ces méthodes de fabrique pour contrôler la longueur du résultat ; de #SHORT jusqu’à #MEDIUM#LONG#FULL . Le résultat exact dépend des paramètres régionaux, mais généralement : <ul><li>#SHORT est complètement numérique, tel que 12.13.52 ou 3:30pm<li>#MEDIUM est plus long, tel queJan 12, 1952< li>#LONG est plus long, tel que li est plus long, tel que January 12, 1952 ou 3:30:32pm<li>#FULL est assez complètement spécifié, tel que .Tuesday, April 12, 1952 AD or 3:30:42pm PST
</ul>
Vous pouvez également définir le fuseau horaire au format si vous le souhaitez. Si vous souhaitez un contrôle encore plus sur le format ou l’analyse (ou que vous souhaitez donner plus de contrôle à vos utilisateurs), vous pouvez essayer de passer des DateFormat méthodes d’usine à un SimpleDateFormat. Cela fonctionnera pour la majorité des pays ; n’oubliez pas de le placer dans un try bloc au cas où vous rencontrez un élément inhabituel.
Vous pouvez également utiliser des formes d’analyse et de mise en forme avec ParsePosition et FieldPosition pour vous permettre d’analyser <progressivement les><>parties d’une chaîne.
<li>alignez un champ particulier ou découvrez où il s’agit de la sélection à l’écran.
</ul>
<h2>"synchronization">Synchronization</h2>
Les formats de date ne sont pas synchronisés. Il est recommandé de créer des instances de format distinctes pour chaque thread. Si plusieurs threads accèdent simultanément à un format, il doit être synchronisé en externe.
Ajouté dans la version 1.1.
Java documentation pour java.text.DateFormat.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.
Constructeurs
| Nom | Description |
|---|---|
| DateFormat() |
Créez un format de date. |
| DateFormat(IntPtr, JniHandleOwnership) |
Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime. |
Champs
| Nom | Description |
|---|---|
| AmPmField |
Constante utile pour l’alignement des champs AM_PM. |
| DateField |
Constante utile pour l’alignement des champs DATE. |
| DayOfWeekField |
Constante utile pour l’alignement des champs DAY_OF_WEEK. |
| DayOfWeekInMonthField |
Constante utile pour l’alignement des champs DAY_OF_WEEK_IN_MONTH. |
| DayOfYearField |
Constante utile pour l’alignement des champs DAY_OF_YEAR. |
| Default |
Constante pour le modèle de style par défaut. |
| EraField |
Constante utile pour l’alignement des champs ERA. |
| Full |
Constante pour le modèle de style complet. |
| Hour0Field |
Constante utile pour l’alignement du champ HOUR de base zéro. |
| Hour1Field |
Constante utile pour l’alignement des champs HOUR d’une base. |
| HourOfDay0Field |
Constante utile pour l’alignement de champ de base zéro HOUR_OF_DAY. |
| HourOfDay1Field |
Constante utile pour l’alignement de champ à base unique HOUR_OF_DAY. |
| Long |
Constante pour le modèle de style long. |
| Medium |
Constante pour le modèle de style moyen. |
| MillisecondField |
Constante utile pour l’alignement des champs MILLISECOND. |
| MinuteField |
Constante utile pour l’alignement des champs MINUTE. |
| MonthField |
Constante utile pour l’alignement des champs MONTH. |
| SecondField |
Constante utile pour l’alignement des champs SECOND. |
| Short |
Constante pour le modèle de style court. |
| TimezoneField |
Constante utile pour l’alignement des champs TIMEZONE. |
| WeekOfMonthField |
Constante utile pour l’alignement des champs WEEK_OF_MONTH. |
| WeekOfYearField |
Constante utile pour l’alignement des champs WEEK_OF_YEAR. |
| YearField |
Constante utile pour l’alignement des champs YEAR. |
Propriétés
| Nom | Description |
|---|---|
| Calendar |
Obtient le calendrier associé à ce formateur de date/heure. -ou- Définissez le calendrier à utiliser par ce format de date. |
| Class |
Retourne la classe runtime de ce |
| DateInstance |
Obtient le formateur de date avec le style de mise en forme par défaut pour les paramètres régionaux par défaut |
| DateTimeInstance |
Obtient le formateur de date/heure avec le style de mise en forme par défaut pour les paramètres régionaux par défaut |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| Instance |
Obtenez un formateur de date/heure par défaut qui utilise le style SHORT pour la date et l’heure. |
| JniIdentityHashCode |
Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object) |
| JniManagedPeerState |
|
| JniPeerMembers |
|
| Lenient |
Indiquez si l’analyse de date/heure doit être lent. -ou- Spécifiez si l’analyse date/heure doit être léniente ou non. |
| NumberFormat |
Obtient le formateur numérique utilisé par ce formateur de date/heure pour mettre en forme et analyser une heure. -ou- Vous permet de définir le formateur numérique. |
| PeerReference |
Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object) |
| 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. |
| TimeInstance |
Obtient le formateur de temps avec le style de mise en forme par défaut pour les paramètres régionaux par défaut |
| TimeZone |
Obtient le fuseau horaire. -ou- Définit le fuseau horaire du calendrier de cet |
Méthodes
| Nom | Description |
|---|---|
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de _Format) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
|
| Dispose() |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| Dispose(Boolean) |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| DisposeUnlessReferenced() |
|
| Equals(Object) |
|
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| Format(Date, StringBuffer, FieldPosition) |
Met en forme une |
| Format(Date) |
Met en forme une |
| Format(Object, StringBuffer, FieldPosition) |
Met en forme l’élément donné |
| Format(Object) |
Met en forme un objet pour produire une chaîne. (Hérité de _Format) |
| FormatToCharacterIterator(Object) |
Met en forme un objet produisant un |
| GetAvailableLocales() |
Retourne un tableau de tous les paramètres régionaux pour lesquels les |
| GetDateInstance(Int32, Locale) |
Obtient le formateur de date avec le style de mise en forme donné pour les paramètres régionaux donnés. |
| GetDateInstance(Int32) |
Obtient le formateur de date avec le style de mise en forme donné pour les paramètres régionaux par défaut |
| GetDateTimeInstance(Int32, Int32, Locale) |
Obtient le formateur de date/heure avec les styles de mise en forme donnés pour les paramètres régionaux donnés. |
| GetDateTimeInstance(Int32, Int32) |
Obtient le formateur de date/heure avec les styles de mise en forme de date et d’heure donnés pour les paramètres régionaux par défaut |
| GetHashCode() |
Retourne une valeur de code de hachage pour l’objet. (Hérité de Object) |
| GetTimeInstance(Int32, Locale) |
Obtient le formateur de temps avec le style de mise en forme donné pour les paramètres régionaux donnés. |
| GetTimeInstance(Int32) |
Obtient le formateur de temps avec le style de mise en forme donné pour les paramètres régionaux par défaut |
| 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, ParsePosition) |
Analysez une chaîne de date/heure en fonction de la position d’analyse donnée. |
| Parse(String) |
Analyse le texte à partir du début de la chaîne donnée pour produire une date. |
| ParseObject(String, ParsePosition) |
Analyse le texte d’une chaîne pour produire un |
| ParseObject(String) |
Analyse le texte à partir du début de la chaîne donnée pour produire un objet. (Hérité de _Format) |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
|
| ToArray<T>() |
Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object) |
| ToString() |
Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object) |
| UnregisterFromRuntime() |
Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object) |
| 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, 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) |
| 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) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniObjectReferenceControlBlock |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
| IJavaPeerable.UnregisterFromRuntime() |
|
Méthodes d’extension
| Nom | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |