Time.ToMillis(Boolean) Méthode

[Android.Runtime.Register("toMillis", "(Z)J", "GetToMillis_ZHandler")]
[System.Obsolete("deprecated")]
public virtual long ToMillis(bool ignoreDst);

[<Android.Runtime.Register("toMillis", "(Z)J", "GetToMillis_ZHandler")>]
[<System.Obsolete("deprecated")>]
abstract member ToMillis : bool -> int64
override this.ToMillis : bool -> int64

Paramètres

Retours

Attributs

RegisterAttribute ObsoleteAttribute

Remarques

Convertit cette fois en millisecondes. Convient pour interagir avec les bibliothèques Java standard. L’heure est en millisecondes UTC depuis l’époque. Cela effectue une normalisation implicite pour calculer les millisecondes, mais ne <>modifie pas< les> champs de cet objet Time. Si vous souhaitez normaliser les champs de cet objet Time et obtenir également les millisecondes, utilisez #normalize(boolean).

Si « ignoreDst » a la valeur false, cette méthode utilise le paramètre actuel du champ « isDst » et ajuste l’heure retournée si le champ « isDst » est incorrect pour l’heure donnée. Consultez l’exemple de code ci-dessous pour obtenir un exemple de ceci.

Si « ignoreDst » a la valeur true, cette méthode ignore le paramètre actuel du champ « isDst » dans cet objet Time et détermine à la place la valeur correcte de « isDst » (comme il le peut) à partir des champs de cet objet Time. Le seul cas où cette méthode ne peut pas déterminer la valeur correcte du champ « isDst » est le moment où l’heure est intrinsèquement ambiguë, car elle tombe dans l’heure qui est répétée lors du passage de Daylight-Saving heure à l’heure standard.

Voici un exemple où toMillis(true) ajuste le temps, en supposant que la DST change à 2h le dimanche 4 novembre 2007.

Time time = new Time();
            time.set(4, 10, 2007);  // set the date to Nov 4, 2007, 12am
            time.normalize(false);       // this sets isDst = 1
            time.monthDay += 1;     // changes the date to Nov 5, 2007, 12am
            millis = time.toMillis(false);   // millis is Nov 4, 2007, 11pm
            millis = time.toMillis(true);    // millis is Nov 5, 2007, 12am

Pour éviter ce problème, utilisez toMillis(true) après avoir ajouté ou soustrait des jours ou définissez explicitement le champ « monthDay ». En revanche, si vous ajoutez ou soustraitez des heures ou des minutes, vous devez utiliser toMillis(false).

Vous devez également utiliser toMillis(false) si vous souhaitez lire les mêmes millisecondes que celles que vous avez définies avec #set(long) ou #set(Time) après l’analyse d’une chaîne de date.

Cette méthode peut retourner -1 lorsque les champs date/heure ont été définis sur une heure locale qui est en conflit avec les informations de fuseau horaire disponibles. Par exemple, lorsque les transitions d’économies d’été entraînent l’interruption d’une heure : les heures comprises dans cette heure retournent -1 si isDst = -1.

Java documentation pour android.text.format.Time.toMillis(boolean).

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.