Time.ToMillis(Boolean) Metodo

Definizione

Spazio dei nomi:: Android.Text.Format

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Converte questa volta in millisecondi.

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

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

Parametri

ignoreDst: Boolean

Valori restituiti

Int64

Attributi: RegisterAttribute

Commenti

Converte questa volta in millisecondi. Adatto per interagire con le librerie Java standard. L'ora è espressa in millisecondi UTC dall'epoca. In questo modo viene eseguita una normalizzazione implicita per calcolare i millisecondi, ma non <><> modifica uno dei campi in questo oggetto Time. Se si desidera normalizzare i campi in questo oggetto Time e ottenere anche i millisecondi, usare #normalize(boolean).

Se "ignoreDst" è false, questo metodo usa l'impostazione corrente del campo "isDst" e regola l'ora restituita se il campo "isDst" non è corretto per il tempo specificato. Per un esempio, vedere il codice di esempio seguente.

Se "ignoreDst" è true, questo metodo ignora l'impostazione corrente del campo "isDst" in questo oggetto Time e capirà invece il valore corretto di "isDst" (come meglio può) dai campi in questo oggetto Time. L'unico caso in cui questo metodo non è in grado di determinare il valore corretto del campo "isDst" è quando l'ora è intrinsecamente ambigua perché rientra nell'ora ripetuta quando si passa da Daylight-Saving Time a Ora solare.

Di seguito è riportato un esempio in cui toMillis(true) viene modificato l'orario, presupponendo che l'ora del DST cambi alle 2:00 di domenica 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

Per evitare questo problema, usare toMillis(true) dopo l'aggiunta o la sottrazione di giorni o impostare in modo esplicito il campo "monthDay". D'altra parte, se si aggiungono o sottraendo ore o minuti, è consigliabile usare toMillis(false).

È consigliabile usare toMillis(false) anche se si desidera leggere gli stessi millisecondi impostati con #set(long) o #set(Time) dopo l'analisi di una stringa di data.

Questo metodo può restituire -1 quando i campi di data/ora sono stati impostati su un'ora locale in conflitto con le informazioni sul fuso orario disponibili. Ad esempio, quando le transizioni di ora legale causano un'ora da ignorare: le ore entro tale ora restituiranno -1 se isDst = -1.

per android.text.format.Time.toMillis(boolean).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a