DateTimeFormatter.WithZone(ZoneId) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengembalikan salinan pemformat ini dengan zona penimpaan baru.
[Android.Runtime.Register("withZone", "(Ljava/time/ZoneId;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)]
public Java.Time.Format.DateTimeFormatter? WithZone(Java.Time.ZoneId? zone);[<Android.Runtime.Register("withZone", "(Ljava/time/ZoneId;)Ljava/time/format/DateTimeFormatter;", "", ApiSince=26)>]
member this.WithZone : Java.Time.ZoneId -> Java.Time.Format.DateTimeFormatterParameter
- zone
- ZoneId
zona penimpaan baru, null jika tidak ada penimpaan
Mengembalikan
formatter berdasarkan formatter ini dengan zona penimpaan yang diminta, bukan null
- Atribut
Keterangan
Mengembalikan salinan pemformat ini dengan zona penimpaan baru.
Ini mengembalikan formatter dengan status serupa dengan formatter ini tetapi dengan set zona penimpaan. Secara default, pemformat tidak memiliki zona penimpaan, mengembalikan null.
Jika penimpaan ditambahkan, instan apa pun yang diformat atau diurai akan terpengaruh.
Saat memformat, jika objek temporal berisi instan, maka objek tersebut akan dikonversi ke tanggal-waktu zona menggunakan zona penimpaan. Apakah temporal adalah instan ditentukan dengan mengkueri ChronoField#INSTANT_SECONDS INSTANT_SECONDS bidang. Jika input memiliki kronologi maka akan dipertahankan kecuali ditimpa. Jika input tidak memiliki kronologi, seperti Instant, maka kronologi ISO akan digunakan.
Jika objek temporal tidak berisi instan, tetapi berisi offset, maka pemeriksaan tambahan dilakukan. Jika zona penimpaan yang dinormalisasi adalah offset yang berbeda dari offset temporal, maka akan DateTimeException dilemparkan. Dalam semua kasus lain, zona penimpaan ditambahkan ke temporal, menggantikan zona sebelumnya, tetapi tanpa mengubah tanggal/waktu.
Saat mengurai, ada dua kasus berbeda yang perlu dipertimbangkan. Jika zona telah diurai langsung dari teks, mungkin karena DateTimeFormatterBuilder#appendZoneId() digunakan, maka zona penimpaan ini tidak berpengaruh. Jika tidak ada zona yang diurai, maka zona penimpaan ini akan disertakan dalam hasil penguraian di mana zona tersebut dapat digunakan untuk membangun instans dan tanggal-waktu.
Instans ini tidak dapat diubah dan tidak terpengaruh oleh panggilan metode ini.
Dokumentasi Java untuk java.time.format.DateTimeFormatter.withZone(java.time.ZoneId).
Bagian halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Proyek Sumber Terbuka Android dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Atribusi Creative Commons 2.5.