SimpleDateFormat 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.
SimpleDateFormat est une classe concrète pour la mise en forme et l’analyse des dates de manière sensible aux paramètres régionaux.
[Android.Runtime.Register("java/text/SimpleDateFormat", DoNotGenerateAcw=true)]
public class SimpleDateFormat : Java.Text.DateFormat[<Android.Runtime.Register("java/text/SimpleDateFormat", DoNotGenerateAcw=true)>]
type SimpleDateFormat = class
inherit DateFormat- Héritage
- Attributs
Remarques
SimpleDateFormat est une classe concrète pour la mise en forme et l’analyse des dates de manière sensible aux paramètres régionaux. Il permet de mettre en forme (date &rarr ; texte), d’analyser (texte &rarr ; date) et de normaliser.
SimpleDateFormat vous permet de commencer par choisir les modèles définis par l’utilisateur pour la mise en forme de date-heure. Toutefois, vous êtes encouragé à créer un formateur date-heure avec l’un ou l’autre getTimeInstanceDateFormatdes éléments suivants getDateInstance:getDateTimeInstance Chacune de ces méthodes de classe peut retourner un formateur de date/heure initialisé avec un modèle de format par défaut. Vous pouvez modifier le modèle de format à l’aide des applyPattern méthodes souhaitées. Pour plus d’informations sur l’utilisation de ces méthodes, consultez DateFormat.
<Modèles< de date et d’heure h2>>
Les formats de date et d’heure sont spécifiés par <>les< chaînes de date et d’heure em>. Dans les chaînes de modèle de date et d’heure, les lettres non mises en guillemets de 'A' vers 'Z' et à 'z' partir 'a' sont interprétées comme des lettres de modèle représentant les composants d’une chaîne de date ou d’heure. Le texte peut être cité à l’aide de guillemets simples (') pour éviter l’interprétation. "''" représente un guillemet unique. Tous les autres caractères ne sont pas interprétés ; ils sont simplement copiés dans la chaîne de sortie pendant la mise en forme ou mis en correspondance avec la chaîne d’entrée pendant l’analyse.
Les lettres de motif suivantes sont définies (tous les autres caractères d’à 'A''Z' et de 'a' destination 'z' sont réservés) : <la table blockquote><class="striped"><caption style="display :none">Chart affiche les lettres de modèle, le composant date/heure, la présentation et les exemples.</caption>thead><tr><th scope="col » style="text-align :left"Letter <th scope=">col » style="text-align :left">Date or Time Component <th scope="col » style="text-align :left « Presentation <th scope="col » style="text-align :left">Examples <th scope="col » style="text-align :left">>Supported (Niveaux d’API) </thead><tbody<>tr<>th scope="row">G<td Era>< td Text<td td td>><AD1+</td><tr><th scope="row"<y>td>Year td Year <<td ;<96>1996><>td>1+</td><tr><th scope="row"<Y>td Week year <td>Year<td ; 09<>>2009td>24+</td<>tr><th scope="row"<>Mtd>Month in year (context sensitive) <td Month<td>July> ; ; Jul07<td>1+</td><tr><th scope="row"L><td>Month in year (forme autonome) <td>Month<tdJuly> ; ; Jul07<td>TBD</><td tr><th scope="row"><wtd>Week in year <td>>><27<1+</td<>tr<>th scope="row">W<td>Week in month <td<>td>><21+</td><tr><th scope="row"td">D<td>day in year td><<>189<td>1+</td><tr<>th scope="row">d<td Day in month td>1+</td<>tr><th scope="row">F<td>Day of week in month><<10<>>< td><td>><21+</td<>tr><th scope="row"<>Etd>Day name in week <td Text><td>Tuesday ; td 1+</td<>tr<>th scope="row"u<>td>Day number of week (1 = Monday, ..., 7 = Sunday) <td>number<td td<>>124+</td<>tr><th scope="row"<>atd>/pm marker <td Text<PM><>td>td 1+</td><tr><th scope="row"td><>H>Tue<Heure en jour (0-23) <td0<<>>>1+</td><tr><th scope="row"k<>td>Hour in day (1-24) <td>Number<td td24><>1+</td<>tr><th scope="row"K<>td>Hour in am/pm (0-11) <td>number<td td>0<>1+</td<>tr><th scope=« row"><htd>Hour in am/pm (1-12) <td>number<td td12>><1+</td<>tr<>th scope="row"td"m><minute>in hour <td>><30<>1+</td><tr<>th scope="row"s><td Second in minute <td<>>td td><>551+</td><Tr><th scope="row">S<td>Millisecond <td>number<td td>978><1+</td<>tr><th scope="row"z<>td Time Zone td>>General time zone<< tdPacific Standard Time> ; ; ; GMT-08:00<PSTtd>1+</td><tr<>th scope="row"<>Ztd Time Zone td>>RFC 822 time zone <<td td<>-0800>1+</td><tr><th scope="row">X<td Time Zone <td>ISO 8601 time zone<td> ;-08> ; ; -08:00<-0800td>24+</td<>/tbody></table<>/blockquote> Lettres de motif sont généralement répétées, car leur nombre détermine la présentation exacte : <ul><li><strong>"Text :></strong> Pour la mise en forme, si le nombre de lettres de motif est de 4 ou plus, le formulaire complet est utilisé ; sinon, un formulaire court ou abrégé est utilisé si disponible. Pour l’analyse, les deux formulaires sont acceptés, indépendamment du nombre de lettres de motif.</li strong><><>"number">Number :</strong> Pour la mise en forme, le nombre de lettres de motif est le nombre minimal de chiffres, et les nombres plus courts sont rembourrés à ce montant. Pour l’analyse, le nombre de lettres de modèle est ignoré, sauf s’il est nécessaire de séparer deux champs adjacents.</li strong><><>"year">Year :</strong> Si le formateur #getCalendar() Calendar est le calendrier grégorien, les règles suivantes sont appliquées. <ul><li>Pour la mise en forme, si le nombre de lettres de motif est de 2, l’année est tronquée à 2 chiffres ; sinon, elle est interprétée comme un nombre. <li>Pour l’analyse, si le nombre de lettres de motif est supérieur à 2, l’année est interprétée littéralement, quel que soit le nombre de chiffres. Ainsi, à l’aide du modèle « MM/dd/aaaa », « 01/11/12 » est analysé au 11 janvier 12 A.D. <Li>For analyse with the abbreviated year pattern (« y » ou « yy »), SimpleDateFormat doit interpréter l’année abrégée par rapport à un siècle. Pour ce faire, il ajuste les dates dans les 80 ans avant et 20 ans après la création de l’instance SimpleDateFormat . Par exemple, l’utilisation d’un modèle « MM/dd/aaaa » et d’une SimpleDateFormat instance créée le 1er janvier 1997, la chaîne « 01/11/12 » serait interprétée comme le 11 janvier 2012, tandis que la chaîne « 05/04/64 » serait interprétée comme le 4 mai 1964. Pendant l’analyse, seules les chaînes composées de deux chiffres exactement, comme défini par Character#isDigit(char), seront analysées dans le siècle par défaut. Toute autre chaîne numérique, telle qu’une chaîne à un chiffre, une chaîne à trois chiffres ou plus, ou une chaîne à deux chiffres qui n’est pas tous les chiffres (par exemple, « -1 »), est interprétée littéralement. Ainsi, « 01/02/3 » ou « 01/02/003 » sont analysés, à l’aide du même modèle, que le 2 janvier 3 AD. De même, « 01/02/-3 » est analysé comme le 2 janvier 4 BC. </ul> Sinon, les formulaires spécifiques au système de calendrier sont appliqués. Pour la mise en forme et l’analyse, si le nombre de lettres de motif est de 4 ou plus, un calendrier spécifique à Calendar#LONG est utilisé. Sinon, un calendrier spécifique Calendar#SHORT short ou abrégé est utilisé. <br> Si l’année 'Y' de semaine est spécifiée et que le calendrier #getCalendar() ne prend pas en charge les années de semaine, l’année civile ('y') est utilisée à la place. Le support des années de semaine peut être testé avec un appel à DateFormat#getCalendar() getCalendar().java.util.Calendar#isWeekDateSupported() isWeekDateSupported().</li strong><><>"month">Month :</strong> Si le nombre de lettres de motif est de 3 ou plus, le mois est interprété comme du texte ; sinon, il est interprété comme un nombre. <ul><li Letter <>em>M</em> produit des noms de mois sensibles au contexte, tels que la forme incorporée de noms. La lettre <em>M</em> respecte le contexte dans le sens où lorsqu’elle est utilisée dans le modèle autonome, par exemple « MMMM », elle donne la forme autonome d’un nom de mois et lorsqu’elle est utilisée dans le modèle contenant d’autres champs, par exemple « d MMMM », il donne la forme de format d’un nom de mois. Par exemple, janvier dans la langue catalane est « de gener » au format alors qu’il est « gener » dans la forme autonome. Dans ce cas, « MMMM » produit « gener » et la partie mois du « d MMMM » produit « de gener ». Si un DateFormatSymbols nom a été défini explicitement avec le constructeur #SimpleDateFormat(String,DateFormatSymbols) ou la méthode, les noms de mois donnés par le constructeur ou la DateFormatSymbols méthode #setDateFormatSymbols(DateFormatSymbols)sont utilisés.</li><li letter <>em>L</em> produit la forme autonome des noms de mois.</li></ul><br></li><><strong>"timezone">General time zone :</strong> Time zones sont interprétés comme du texte s’ils ont des noms. Pour les fuseaux horaires représentant une valeur de décalage GMT, la syntaxe suivante est utilisée :
<a id="GMTOffsetTimeZone"><i>GMTOffsetTimeZone:</i></a>
{@code GMT} <i>Sign</i> <i>Hours</i> {@code :} <i>Minutes</i>
<i>Sign:</i> one of
{@code + -}
<i>Hours:</i>
<i>Digit</i>
<i>Digit</i> <i>Digit</i>
<i>Minutes:</i>
<i>Digit</i> <i>Digit</i>
<i>Digit:</i> one of
{@code 0 1 2 3 4 5 6 7 8 9}
Les heures doivent être comprises entre 0 et 23, et les minutes doivent être comprises entre 00 et 59. Le format est indépendant des paramètres régionaux et les chiffres doivent être extraits du bloc latin de base de la norme Unicode.
Pour l’analyse, les fuseaux horaires RFC 822 sont également acceptés.</li li>><<strong>"rfc822timezone">RFC 822 fuseau horaire :</strong> Pour la mise en forme, le format de fuseau horaire RFC 822 à 4 chiffres est utilisé :
<i>RFC822TimeZone:</i>
<i>Sign</i> <i>TwoDigitHours</i> <i>Minutes</i>
<i>TwoDigitHours:</i>
<i>Digit Digit</i>
TwoDigitHours doit être compris entre 00 et 23. D’autres définitions sont identiques aux fuseaux horaires généraux.
Pour l’analyse, les fuseaux horaires généraux sont également acceptés. <li><strong>"iso8601timezone">ISO 8601 Time zone :</strong> Le nombre de lettres de modèle désigne le format pour la mise en forme et l’analyse comme suit :
<i>ISO8601TimeZone:</i>
<i>OneLetterISO8601TimeZone</i>
<i>TwoLetterISO8601TimeZone</i>
<i>ThreeLetterISO8601TimeZone</i>
<i>OneLetterISO8601TimeZone:</i>
<i>Sign</i> <i>TwoDigitHours</i>
{@code Z}
<i>TwoLetterISO8601TimeZone:</i>
<i>Sign</i> <i>TwoDigitHours</i> <i>Minutes</i>
{@code Z}
<i>ThreeLetterISO8601TimeZone:</i>
<i>Sign</i> <i>TwoDigitHours</i> {@code :} <i>Minutes</i>
{@code Z}
D’autres définitions concernent les fuseaux horaires généraux ou les fuseaux horaires RFC 822.
Pour la mise en forme, si la valeur de décalage de GMT est 0, "Z" elle est produite. Si le nombre de lettres de motif est 1, une fraction d’une heure est ignorée. Par exemple, si le modèle est "X" et que le fuseau horaire est , "+05" est "GMT+05:30"produit.
Pour l’analyse, la lettre "Z" est analysée en tant que dessinateur de fuseau horaire UTC (par conséquent "09:30Z" , est analysée en tant que "09:30 UTC". Les fuseaux horaires généraux ne sont pas< acceptés.><>
Si le nombre de lettres de motif est de 4 ou plus (par exempleXXXX), IllegalArgumentException est levée lors de "X" la construction d’un modèle ou d’un SimpleDateFormat #applyPattern(String). </ul>SimpleDateFormat prend également en charge <les chaînes de date et d’heure< localisées par> em>. Dans ces chaînes, les lettres de modèle décrites ci-dessus peuvent être remplacées par d’autres paramètres régionaux dépendants, lettres de modèle. SimpleDateFormat ne traite pas de la localisation du texte autre que les lettres de motif ; c’est jusqu’au client de la classe.
<exemples< h3>/h3>
Les exemples suivants montrent comment les modèles de date et d’heure sont interprétés dans les paramètres régionaux américains. La date et l’heure spécifiées sont 2001-07-04 12:08:56 heure locale dans le fuseau horaire du Pacifique des États-Unis. <blockquote><table class="striped"><caption style="display :none">Examples of date and time patterns interprétés in the U.S. locale</caption<>thead tr th scope="col » style="text-align :left">Date and Time Pattern <th scope="col » style="text-align :left">Result </thead><<>tbody<>tr<>><th scope="row"<"yyyy.MM.dd G 'at' HH:mm:ss z">td>2001.07.04 AD at 12:08:56 PDT<tr<>th scope="row » row »>"EEE, MMM d, ''yy"<Td>Wed, Jul 4, '01<tr>th scope="row""h:mm a"<>td12:08 PM<>tr<>th scope="row"><"hh 'o''clock' a, zzzz"td<>12 o'clock PM, Pacific Daylight Timetr<>th scope="row"<"K:mm a, z">td0:08 PM, PDT><tr><th scope="row">"yyyyy.MMMMM.dd GGG hh:mm aaa"<td>02001.July.04 AD 12:08 PM<tr><th scope="row"<>"EEE, d MMM yyyy HH:mm:ss Z"tdWed, 4 Jul 2001 12:08:56 -0700><tr<>th scope="row"td tr th scope="row"<"yyMMddHHmmssZ">td010704120856-0700><tr<>th scope="row"td2001-07-04T12:08:56.235-0700>>"yyyy-MM-dd'T'HH:mm:ss.SSSZ"<<<Tr><th scope="row">"yyyy-MM-dd'T'HH:mm:ss.SSSXXX"<td2001-07-04T12:08:56.235-07:00><tr><th scope="row""YYYY-'W'ww-u"><td><2001-W27-3/tbody<>/table></blockquote>
<h3>"synchronisation">Synchronisation</h3>
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.
Documentation Java pour java.text.SimpleDateFormat.
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
| SimpleDateFormat() |
Construit un |
| SimpleDateFormat(IntPtr, JniHandleOwnership) |
Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime. |
| SimpleDateFormat(String) |
Construit un |
| SimpleDateFormat(String, DateFormatSymbols) |
Construit un |
| SimpleDateFormat(String, Locale) |
Construit un |
Champs
| AmPmField |
Constante utile pour l’alignement des champs AM_PM. (Hérité de DateFormat) |
| DateField |
Constante utile pour l’alignement des champs DATE. (Hérité de DateFormat) |
| DayOfWeekField |
Constante utile pour l’alignement des champs DAY_OF_WEEK. (Hérité de DateFormat) |
| DayOfWeekInMonthField |
Constante utile pour l’alignement des champs DAY_OF_WEEK_IN_MONTH. (Hérité de DateFormat) |
| DayOfYearField |
Constante utile pour l’alignement des champs DAY_OF_YEAR. (Hérité de DateFormat) |
| Default |
Constante pour le modèle de style par défaut. (Hérité de DateFormat) |
| EraField |
Constante utile pour l’alignement des champs ERA. (Hérité de DateFormat) |
| Full |
Constante pour le modèle de style complet. (Hérité de DateFormat) |
| Hour0Field |
Constante utile pour l’alignement du champ HOUR de base zéro. (Hérité de DateFormat) |
| Hour1Field |
Constante utile pour l’alignement des champs HOUR d’une base. (Hérité de DateFormat) |
| HourOfDay0Field |
Constante utile pour l’alignement de champ de base zéro HOUR_OF_DAY. (Hérité de DateFormat) |
| HourOfDay1Field |
Constante utile pour l’alignement de champ à base unique HOUR_OF_DAY. (Hérité de DateFormat) |
| Long |
Constante pour le modèle de style long. (Hérité de DateFormat) |
| Medium |
Constante pour le modèle de style moyen. (Hérité de DateFormat) |
| MillisecondField |
Constante utile pour l’alignement des champs MILLISECOND. (Hérité de DateFormat) |
| MinuteField |
Constante utile pour l’alignement des champs MINUTE. (Hérité de DateFormat) |
| MonthField |
Constante utile pour l’alignement des champs MONTH. (Hérité de DateFormat) |
| SecondField |
Constante utile pour l’alignement des champs SECOND. (Hérité de DateFormat) |
| Short |
Constante pour le modèle de style court. (Hérité de DateFormat) |
| TimezoneField |
Constante utile pour l’alignement des champs TIMEZONE. (Hérité de DateFormat) |
| WeekOfMonthField |
Constante utile pour l’alignement des champs WEEK_OF_MONTH. (Hérité de DateFormat) |
| WeekOfYearField |
Constante utile pour l’alignement des champs WEEK_OF_YEAR. (Hérité de DateFormat) |
| YearField |
Constante utile pour l’alignement des champs YEAR. (Hérité de DateFormat) |
Propriétés
| Calendar |
Obtient le calendrier associé à ce formateur de date/heure. -ou- Définissez le calendrier à utiliser par ce format de date. (Hérité de DateFormat) |
| Class |
Retourne la classe runtime de ce |
| DateFormatSymbols |
Obtient une copie des symboles de format de date et d’heure de ce format de date. -ou- Définit les symboles de format de date et d’heure de ce format de date. |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| JniIdentityHashCode |
|
| JniPeerMembers |
|
| Lenient |
Indiquez si l’analyse de date/heure doit être léniente. -ou- Spécifiez si l’analyse date/heure doit être léniente ou non. (Hérité de DateFormat) |
| 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. (Hérité de DateFormat) |
| PeerReference |
|
| 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. |
| TimeZone |
Obtient le fuseau horaire. -ou- Définit le fuseau horaire du calendrier de cet |
Méthodes
| ApplyLocalizedPattern(String) |
Applique la chaîne de modèle localisée donnée à ce format de date. |
| ApplyPattern(String) |
Applique la chaîne de modèle donnée à ce format de date. |
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de _Format) |
| Dispose() |
|
| Dispose(Boolean) |
|
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| Format(Date) |
Met en forme une |
| Format(Date, 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) |
| Format(Object, StringBuffer, FieldPosition) |
Met en forme l’élément donné |
| FormatToCharacterIterator(Object) |
Met en forme un objet produisant un |
| Get2DigitYearStart() |
Retourne la date de début de la période de 100 ans à 2 chiffres est interprétée comme étant dans le délai. |
| 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) |
Analyse le texte à partir du début de la chaîne donnée pour produire une date. (Hérité de DateFormat) |
| Parse(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) |
| ParseObject(String, ParsePosition) |
Analyse le texte d’une chaîne pour produire un |
| Set2DigitYearStart(Date) |
Définit la période de 100 ans à 2 chiffres qui sera interprétée comme étant en cours de début à la date spécifiée par l’utilisateur. |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| ToArray<T>() |
|
| ToLocalizedPattern() |
Retourne une chaîne de modèle localisée décrivant ce format de date. |
| ToPattern() |
Retourne une chaîne de modèle décrivant ce format de date. |
| ToString() |
Retourne une représentation de chaîne de l'objet. (Hérité de Object) |
| UnregisterFromRuntime() |
|
| 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
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.DisposeUnlessReferenced() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniManagedPeerState |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
Méthodes d’extension
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
|
| GetJniTypeName(IJavaPeerable) |
|