SimpleDateFormat Classe

Définition

[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

Object

Object

_Format

DateFormat

SimpleDateFormat

Attributs

RegisterAttribute

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

Champs

Propriétés

Méthodes

Implémentations d’interfaces explicites

Méthodes d’extension

S’applique à