Deteksi zona waktu telepon

Untuk perangkat yang menjalankan Android 11 atau yang lebih rendah, deteksi zona waktu otomatis di AOSP bergantung pada sinyal dari subsistem telefoni. Karena dependensi pada subsistem telepon, deteksi zona waktu otomatis di Android 11 atau yang lebih lama terbatas pada perangkat telepon.

Jika tersedia, deteksi zona waktu telefoni akan berfungsi menggunakan sinyal Kode Negara Seluler (MCC) dan Identitas Jaringan dan Zona Waktu (NITZ).

Misalnya, perangkat di Prancis dapat mengidentifikasi zona waktu hanya berdasarkan MCC yang dilaporkan oleh menara seluler di sekitar. Hal ini dimungkinkan karena Prancis dikenal menggunakan satu zona waktu.

Jika suatu negara menggunakan beberapa zona waktu, MCC saja tidak cukup untuk mengidentifikasi zona waktu. Untuk negara-negara ini, perangkat juga menggunakan sinyal NITZ untuk mengidentifikasi zona waktu yang benar. Hal ini berfungsi dengan baik di banyak tempat di seluruh dunia, tetapi memerlukan sinyal NITZ yang tersedia dan benar, sehingga bergantung pada operator.

Deteksi zona waktu telefoni adalah pendeteksi pasif. Algoritma ini berjalan setiap saat sehingga saran telephony sering dibuat meskipun algoritma time_zone_detector yang aktif saat ini bukan telephony.

Batasan deteksi zona waktu telefoni

Meskipun sinyal NITZ yang benar tersedia, deteksi zona waktu telefoni tidak selalu berfungsi dengan baik di setiap negara. Hal ini karena NITZ hanya berisi informasi offset dan waktu musim panas, yang tidak selalu cukup untuk mengidentifikasi zona waktu secara unik.

Ada banyak tempat di dunia tempat masalah zona waktu ini mungkin terjadi. Misalnya, Denver Colorado dan Phoenix Arizona di AS tidak dapat dibedakan menggunakan sinyal NITZ selama musim dingin, tetapi dapat selama musim lainnya. Setiap lokasi dengan zona waktu yang tumpang-tindih secara serupa dapat mengalami masalah seperti ini.

Tabel berikut menguraikan perilaku perangkat bergantung pada musim untuk Denver dan Phoenix sebagai contoh:

Lokasi dan musim Informasi dari MCC atau NITZ Zona waktu dan perilaku yang terdeteksi
Denver, Colorado
Musim Dingin
Waktu: 1 Januari 2021 12.00.00
Negara: AS
Offset: UTC-7, tidak ada waktu musim panas
Dua ID zona cocok:
  • Amerika/Denver
  • Amerika/Phoenix

Perangkat sudah disetel dengan benar ke Amerika/Denver.
Phoenix, Arizona
Musim Dingin
Waktu: 1 Januari 2021 12.00.00
Negara: AS
Offset: UTC-7, tidak ada waktu musim panas
Dua ID zona cocok:
  • Amerika/Denver
  • Amerika/Phoenix

Perangkat tidak disetel dengan benar ke Amerika/Denver.
Denver, Colorado
Musim Panas
Waktu: 1 Juli 2021 12.00.00
Negara: AS
Offset: UTC-6, waktu musim panas
Satu ID zona cocok:
  • Amerika/Denver

Perangkat disetel dengan benar ke Amerika/Denver.
Phoenix, Arizona
Musim Panas
Waktu: 1 Juli 2021 12.00.00
Negara: AS
Offset: UTC-7, tidak ada waktu musim panas
Satu ID zona cocok:
  • Amerika/Phoenix

Perangkat disetel dengan benar ke Amerika/Phoenix.

Contoh di atas menunjukkan bahwa selama musim dingin, perangkat Android di Denver atau Arizona harus memilih salah satu dari dua ID zona waktu yang cocok, yang mungkin salah untuk beberapa perangkat, tetapi masih menampilkan waktu lokal yang tampaknya benar. Jam perangkat, kalender, dan aplikasi lainnya menampilkan waktu lokal yang diharapkan meskipun ID zona waktu salah karena kedua ID zona waktu menghitung waktu lokal yang sama selama musim dingin.

Namun, pada musim semi saat Denver menggunakan waktu musim panas dan Phoenix tidak, beberapa perangkat mungkin untuk sementara menampilkan waktu lokal yang salah jika disetel ke ID zona waktu yang salah untuk lokasi pengguna. Hal ini akan dikoreksi segera setelah perangkat menerima sinyal NITZ baru (khususnya, sinyal yang berisi informasi offset "UTC-7, tidak ada waktu musim panas"), tetapi hal ini dapat memerlukan waktu dan bergantung pada operator.

Akibatnya, kalender atau aplikasi lain yang menyimpan atau meneruskan ID zona waktu dari musim dingin ke musim semi dapat menampilkan dan menggunakan waktu lokal yang salah hingga aplikasi yang relevan memperbarui ID zona waktu.

Proses debug dan pengujian

Bagian berikut menjelaskan perintah shell untuk men-debug dan menguji fitur deteksi zona waktu telefoni.

Penyiapan lingkungan pengujian

Penguji biasanya menggunakan lingkungan pengujian dengan sel telepon simulasi atau pengujian untuk memeriksa perilaku deteksi zona waktu telepon. Sel pengujian dapat digunakan untuk menyimulasikan jaringan dengan MCC yang berbeda dan mengirim sinyal NITZ ke perangkat, lalu memantau efeknya.

Agar perangkat dapat mendeteksi zona waktu, informasi sinyal NITZ harus benar, konsisten dengan MCC, dan cocok dengan salinan IANA TZDB (aturan zona waktu) perangkat. Sinyal NITZ yang tidak konsisten dengan MCC menyebabkan algoritma telepon menjadi tidak pasti.

Misalnya, jika MCC yang digunakan oleh sel pengujian adalah untuk Amerika Serikat, sinyal NITZ harus berisi informasi "waktu universal", offset, dan waktu musim panas yang benar untuk suatu tempat di Amerika Serikat.

Berinteraksi dengan layanan com.android.phone

Untuk memverifikasi bahwa perangkat menerima saran zona waktu telephony yang benar, gunakan:

adb shell dumpsys activity service \
    com.android.phone/com.android.phone.TelephonyDebugService

Tindakan ini akan menyimpan informasi telepon, yang juga dapat ditemukan dalam laporan bug Android. Pada perangkat dengan beberapa SIM, ada informasi untuk setiap radio SIM.

Log Zona waktu menampilkan saran yang telah dikirim proses telefoni ke time_zone_detector dan alasan pengiriman saran.

TimeServiceHelperImpl:
          SystemClock.elapsedRealtime()=11864061
          System.currentTimeMillis()=1620652067178
          Time Logs:
...

Time zone Logs:
    18602 / 2021-05-10T09:50:21.718Z - Suggesting time zone update:
    TelephonyTimeZoneSuggestion{mSlotIndex=0, mZoneId='null', mMatchType=0, mQuality=0,
    mDebugInfo=[getTimeZoneSuggestion: nitzSignal=TimestampedValue{mReferenceTimeMillis=14098,
    mValue=NitzData{mOriginalString=21/05/10,09:50:18+04,01, mZoneOffset=3600000,
    mDstOffset=3600000, mCurrentTimeMillis=1620640218000, mEmulatorHostTimeZone=null}},
    countryIsoCode=null, Detection
    reason=handleNitzReceived(TimestampedValue{mReferenceTimeMillis=14098,
    mValue=NitzData{mOriginalString=21/05/10,09:50:18+04,01, mZoneOffset=3600000,
    mDstOffset=3600000, mCurrentTimeMillis=1620640218000, mEmulatorHostTimeZone=null}})]}
    18831 / 2021-05-10T09:50:21.948Z - Suggesting time zone update:
    TelephonyTimeZoneSuggestion{mSlotIndex=0, mZoneId='Europe/London', mMatchType=3, mQuality=1,
    mDebugInfo=[findTimeZoneFromCountryAndNitz: countryIsoCode=gb,
    nitzSignal=TimestampedValue{mReferenceTimeMillis=14098,
    mValue=NitzData{mOriginalString=21/05/10,09:50:18+04,01, mZoneOffset=3600000,
    mDstOffset=3600000, mCurrentTimeMillis=1620640218000, mEmulatorHostTimeZone=null}},
    findTimeZoneFromCountryAndNitz: lookupResult=OffsetResult{mTimeZone(ID)=Europe/London,
    mIsOnlyMatch=true}, Detection reason=handleCountryDetected("gb")]}