Date.Parse(String) Méthode

[Android.Runtime.Register("parse", "(Ljava/lang/String;)J", "")]
[System.Obsolete("deprecated")]
public static long Parse(string? s);

[<Android.Runtime.Register("parse", "(Ljava/lang/String;)J", "")>]
[<System.Obsolete("deprecated")>]
static member Parse : string -> int64

Paramètres

Retours

nombre de millisecondes depuis le 1er janvier 1970, 00:00:00 GMT représenté par l’argument de chaîne.

Attributs

RegisterAttribute ObsoleteAttribute

Remarques

Tente d’interpréter la chaîne s comme une représentation d’une date et d’une heure. Si la tentative réussit, l’heure indiquée est retournée sous forme de distance, mesurée en millisecondes, de cette heure à partir de l’époque (00:00:00 GMT le 1er janvier 1970). Si la tentative échoue, une IllegalArgumentException opération est levée.

Il accepte de nombreuses syntaxes ; en particulier, il reconnaît la syntaxe de date standard IETF : « Sat, 12 août 1995 13:30:00 GMT ». Il comprend également les abréviations de fuseau horaire des États-Unis continentaux, mais pour une utilisation générale, un décalage de fuseau horaire doit être utilisé : « Sat, 12 août 1995 13:30:00 GMT+0430 » (4 heures, 30 minutes à l’ouest du méridien de Greenwich). Si aucun fuseau horaire n’est spécifié, le fuseau horaire local est supposé. GMT et UTC sont considérés comme équivalents.

La chaîne s est traitée de gauche à droite, à la recherche de données intéressantes. Tout matériau qui s se trouve dans les parenthèses ( ASCII et ) est ignoré. Les parenthèses peuvent être imbriquées. Dans le cas contraire, les seuls caractères autorisés sont s les caractères ASCII suivants : <blockquote>

abcdefghijklmnopqrstuvwxyz
            ABCDEFGHIJKLMNOPQRSTUVWXYZ
            0123456789,+-:/

</blockquote> et espaces blancs.

Une séquence consécutive de chiffres décimaux est traitée comme un nombre décimal :<ul><li>Si un nombre est précédé + ou - qu’une année a déjà été reconnue, le nombre est un décalage de fuseau horaire. Si le nombre est inférieur à 24, il s’agit d’un décalage mesuré en heures. Dans le cas contraire, il est considéré comme un décalage en minutes, exprimé dans un format de temps de 24 heures sans ponctuation. Un précédent - signifie un décalage vers l’ouest. Les décalages de fuseau horaire sont toujours relatifs à UTC (Greenwich). Ainsi, par exemple, -5 se produisant dans la chaîne signifierait « cinq heures à l’ouest de Greenwich » et +0430 signifierait « quatre heures et trente minutes à l’est de Greenwich ». Il est autorisé pour la chaîne à spécifier GMT, UTou UTC de manière redondante, par exemple, GMT-5 ou utc+0430. <li>Le nombre est considéré comme un numéro d’année si l’une des conditions suivantes est true : <ul><li>Le nombre est égal ou supérieur à 70 et suivi d’un espace, d’une virgule, d’une barre oblique ou d’une fin de chaîne <li>Le nombre est inférieur à 70, et un mois et un jour du mois ont déjà été reconnus/li></ul> Si le numéro d’année reconnu< est inférieur à 100, il est interprété comme une année abrégée par rapport à un siècle dont les dates sont comprises dans les 80 ans avant et 19 ans après l’heure à laquelle la classe Date est initialisée. Après avoir ajusté le numéro d’année, 1900 est soustrait de celui-ci. Par exemple, si l’année en cours est de 1999, les années comprises entre 19 et 99 sont supposées être comprises entre 1919 et 1999, tandis que les années comprises entre 0 et 18 sont supposées être comprises entre 2000 et 2018. Notez que cela est légèrement différent de l’interprétation des années inférieures à 100 utilisées dans java.text.SimpleDateFormat. <li>Si le nombre est suivi d’un signe deux-points, il est considéré comme une heure, sauf si une heure a déjà été reconnue, auquel cas elle est considérée comme une minute. <li>Si le nombre est suivi d’une barre oblique, il est considéré comme un mois (il est diminué de 1 pour produire un nombre dans la plage 0 à 11), sauf si un mois a déjà été reconnu, auquel cas il est considéré comme un jour du mois. <li>Si le nombre est suivi d’un espace blanc, d’une virgule, d’un trait d’union ou d’une fin de chaîne, alors si une heure a été reconnue, mais pas une minute, elle est considérée comme une minute ; sinon, si une minute a été reconnue mais pas une seconde, elle est considérée comme une seconde ; sinon, elle est considérée comme un jour du mois. </ul>

Une séquence consécutive de lettres est considérée comme un mot et traitée comme suit :<ul><li>Un mot qui correspond AM, ignorant la casse, est ignoré (mais l’analyse échoue si une heure n’a pas été reconnue ou est inférieure 1 ou supérieure à 12). <li>Mot qui correspond PM, ignorant le cas, ajoute 12 à l’heure (mais l’analyse échoue si une heure n’a pas été reconnue ou est inférieure 1 ou supérieure à 12). <li>Tout mot qui correspond à n’importe quel préfixe de SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, ou SATURDAY, en ignorant le cas, est ignoré. Par exemple, sat, Friday, TUEet Thurs sont ignorés. <li>Sinon, tout mot qui correspond à n’importe quel préfixe de JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, ou DECEMBER, ignorant le cas, et en les considérant dans l’ordre donné ici, est reconnu comme spécifiant un mois et est converti en un nombre (0 en 11). Par exemple, aug, Sept, aprilet NOV sont reconnus comme des mois. Donc, c’est Ma, qui est reconnu comme MARCH, pas MAY. <li>Tout mot qui correspond GMT, UT, ou UTC, ignorant le cas, est traité comme faisant référence à UTC. <Li>Tout mot qui correspond EST, CST, MST, ou PST, ignorant le cas, est reconnu comme faisant référence au fuseau horaire en Amérique du Nord qui est de cinq, six, sept ou huit heures à l’ouest de Greenwich, respectivement. Tout mot qui correspond EDT, CDT, MDT, ou PDT, ignorant la casse, est reconnu comme faisant référence au même fuseau horaire, respectivement, pendant l’heure d’été.</ul>

Une fois que la chaîne entière a été analysée, elle est convertie en un résultat temporel de l’une des deux manières. Si un décalage de fuseau horaire ou de fuseau horaire a été reconnu, l’année, le mois, le jour du mois, l’heure, la minute et la seconde sont interprétés au format UTC, puis le décalage de fuseau horaire est appliqué. Sinon, l’année, le mois, le jour du mois, l’heure, la minute et la seconde sont interprétés dans le fuseau horaire local.

Ce membre est déconseillé. À compter de JDK version 1.1, remplacée par DateFormat.parse(String s).

Documentation Java pour java.util.Date.parse(java.lang.String).

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.