Time.ToMillis(Boolean) Método

[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

Parámetros

Devoluciones

Atributos

RegisterAttribute

Comentarios

Convierte esta vez en milisegundos. Adecuado para interactuar con las bibliotecas de Java estándar. La hora está en milisegundos UTC desde la época. Esto hace una normalización implícita para calcular los milisegundos, pero no <em><> cambia ninguno de los campos de este objeto Time. Si desea normalizar los campos de este objeto Time y obtener también los milisegundos, use #normalize(boolean).

Si "ignoreDst" es false, este método usa la configuración actual del campo "isDst" y ajustará la hora devuelta si el campo "isDst" es incorrecto durante el tiempo determinado. Consulte el código de ejemplo siguiente para obtener un ejemplo de esto.

Si "ignoreDst" es true, este método omite la configuración actual del campo "isDst" en este objeto Time y, en su lugar, averiguará el valor correcto de "isDst" (como mejor puede) de los campos de este objeto Time. El único caso en el que este método no puede averiguar el valor correcto del campo "isDst" es cuando el tiempo es intrínsecamente ambiguo porque cae en la hora que se repite al cambiar de Daylight-Saving hora a hora estándar.

Este es un ejemplo en toMillis(true) el que ajusta el tiempo, suponiendo que DST cambie a las 2:00 del domingo, 4 de noviembre de 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

Para evitar este problema, use toMillis(true) después de agregar o restar días o establecer explícitamente el campo "monthDay". Por otro lado, si va a agregar o restar horas o minutos, debe usar toMillis(false).

También debe usar toMillis(false) si desea leer los mismos milisegundos que estableció con #set(long) o #set(Time) después de analizar una cadena de fecha.

Este método puede devolver -1 cuando los campos de fecha y hora se han establecido en una hora local que entra en conflicto con la información de zona horaria disponible. Por ejemplo, cuando las transiciones de verano hacen que se omita una hora: las horas dentro de esa hora devolverán -1 si isDst = -1.

Java documentación para android.text.format.Time.toMillis(boolean).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.