ZonedDateTime Kelas

Definisi

Ruang nama:: Java.Time

Rakitan:: Mono.Android.dll

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.

Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti 2007-12-03T10:15:30+01:00 Europe/Paris.

[Android.Runtime.Register("java/time/ZonedDateTime", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class ZonedDateTime : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Time.Chrono.IChronoZonedDateTime

[<Android.Runtime.Register("java/time/ZonedDateTime", ApiSince=26, DoNotGenerateAcw=true)>]
type ZonedDateTime = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IChronoZonedDateTime
    interface IComparable
    interface ITemporal
    interface ITemporalAccessor

Warisan: Object

JavaObject

Object
ZonedDateTime

Atribut: RegisterAttribute

Penerapan: IJavaObject IJavaPeerable ISerializable IComparable IChronoZonedDateTime ITemporal ITemporalAccessor IDisposable

Keterangan

Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti 2007-12-03T10:15:30+01:00 Europe/Paris.

ZonedDateTime adalah representasi yang tidak dapat diubah dari tanggal-waktu dengan zona waktu. Kelas ini menyimpan semua bidang tanggal dan waktu, ke presisi nanodetik, dan zona waktu, dengan offset zona yang digunakan untuk menangani tanggal-waktu lokal yang ambigu. Misalnya, nilai "2 Oktober 2007 pukul 13:45.30.123456789 +02:00 di zona waktu Eropa/Paris" dapat disimpan dalam ZonedDateTime.

Kelas ini menangani konversi dari baris LocalDateTime waktu lokal ke baris waktu instan .Instant Perbedaan antara dua garis waktu adalah offset dari UTC/Greenwich, yang diwakili oleh ZoneOffset.

Mengonversi antara dua garis waktu melibatkan pengkalkulasian offset menggunakan yang ZoneRules rules diakses dari ZoneId. Mendapatkan offset untuk instan itu sederhana, karena ada tepat satu offset yang valid untuk setiap instan. Sebaliknya, mendapatkan offset untuk tanggal-waktu lokal tidak mudah. Ada tiga kasus: <ul><li>Normal, dengan satu offset yang valid. Untuk sebagian besar tahun, kasus normal berlaku, di mana ada satu offset yang valid untuk tanggal-waktu lokal.</li li><>Gap, dengan offset yang tidak valid. Ini adalah ketika jam melompat ke depan biasanya karena musim semi musim panas tabungan berubah dari "musim dingin" ke "musim panas". Dalam celah ada nilai tanggal-waktu lokal tanpa offset yang valid.</li li><>Tumpang Tindih, dengan dua offset yang valid. Ini adalah ketika jam diatur kembali biasanya karena musim gugur musim panas penghematan berubah dari "musim panas" ke "musim dingin". Dalam tumpang tindih ada nilai tanggal-waktu lokal dengan dua offset yang valid.</li></ul>

Metode apa pun yang mengonversi secara langsung atau implisit dari tanggal-waktu lokal ke instan dengan mendapatkan offset berpotensi menjadi rumit.

Untuk Kesenjangan, strategi umumnya adalah bahwa jika tanggal-waktu lokal berada di tengah Celah, maka tanggal-waktu zona yang dihasilkan akan memiliki tanggal-waktu lokal yang digeser maju dengan panjang Kesenjangan, menghasilkan tanggal-waktu di offset selanjutnya, biasanya waktu "musim panas".

Untuk Tumpang Tindih, strategi umumnya adalah bahwa jika tanggal-waktu lokal berada di tengah Tumpang Tindih, maka offset sebelumnya akan dipertahankan. Jika tidak ada offset sebelumnya, atau offset sebelumnya tidak valid, maka offset sebelumnya digunakan, biasanya waktu "musim panas". Dua metode tambahan, #withEarlierOffsetAtOverlap() dan #withLaterOffsetAtOverlap(), membantu mengelola kasus tumpang tindih.

Dalam hal desain, kelas ini harus dilihat terutama sebagai kombinasi dari dan LocalDateTimeZoneId. ZoneOffset adalah informasi penting, tetapi sekunder, digunakan untuk memastikan bahwa kelas mewakili instan, terutama selama musim panas tumpang tindih.

Ditambahkan dalam 1.8.

Java dokumentasi untuk java.time.ZonedDateTime.

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.

Properti

Nama	Deskripsi
Class	Mengembalikan kelas runtime dari .`Object` (Diperoleh dari Object)
DayOfMonth	Mendapatkan bidang hari dalam bulan.
DayOfWeek	Mendapatkan bidang day-of-week, yang merupakan enum DayOfWeek.
DayOfYear	Mendapatkan bidang hari dalam setahun.
Handle	Handel ke instans Android yang mendasar. (Diperoleh dari Object)
Hour	Mendapatkan bidang jam sehari.
JniIdentityHashCode	Mendapatkan kode hash identitas yang ditetapkan ke Java peer ini oleh runtime interop. (Diperoleh dari Object)
JniManagedPeerState	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`. (Diperoleh dari JavaObject)
JniPeerMembers	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`.
Minute	Mendapatkan bidang menit-jam.
Month	Mendapatkan bidang bulan dalam setahun menggunakan enum Bulan.
MonthValue	Mendapatkan bidang bulanan dari 1 hingga 12.
Nano	Mendapatkan bidang nano-of-second.
Offset	Mendapatkan offset zona, seperti '+01:00'.
PeerReference	Mendapatkan referensi objek JNI untuk peer Java ini. (Diperoleh dari Object)
Second	Mendapatkan bidang kedua menit.
ThresholdClass	API ini mendukung infrastruktur Mono untuk Android dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. (Diperoleh dari Object)
ThresholdType	API ini mendukung infrastruktur Mono untuk Android dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. (Diperoleh dari Object)
Year	Mendapatkan bidang tahun.
Zone	Mendapatkan zona waktu, seperti 'Eropa/Paris'.

Metode

Nama	Deskripsi
Clone()	Membuat dan mengembalikan salinan objek ini. (Diperoleh dari Object)
CompareTo(Object)	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`.
Construct(JniObjectReference, JniObjectReferenceOptions)	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`. (Diperoleh dari JavaObject)
Dispose()	Merilis sumber daya yang dipegang oleh rekan Java ini. (Diperoleh dari Object)
Dispose(Boolean)	Merilis sumber daya yang dipegang oleh rekan Java ini. (Diperoleh dari Object)
DisposeUnlessReferenced()	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`. (Diperoleh dari JavaObject)
Equals(Object)	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`. (Diperoleh dari JavaObject)
Equals(Object)	Menunjukkan apakah beberapa objek lain "sama dengan" yang satu ini. (Diperoleh dari Object)
Format(DateTimeFormatter)	Memformat tanggal-waktu ini menggunakan pemformat yang ditentukan.
From(ITemporalAccessor)	Mendapatkan instans ZonedDateTime dari objek temporal.
Get(ITemporalField)	Mendapatkan nilai bidang yang ditentukan dari tanggal-waktu ini sebagai int.
GetHashCode()	Mengembalikan nilai kode hash untuk objek . (Diperoleh dari Object)
GetLong(ITemporalField)	Mendapatkan nilai bidang yang ditentukan dari tanggal-waktu ini untuk waktu yang lama.
IsSupported(ITemporalField)	Memeriksa apakah bidang yang ditentukan didukung.
IsSupported(ITemporalUnit)	Memeriksa apakah unit yang ditentukan didukung.
JavaFinalize()	Dipanggil oleh pengumpul sampah pada objek ketika pengumpulan sampah menentukan bahwa tidak ada lagi referensi ke objek. (Diperoleh dari Object)
Minus(Int64, ITemporalUnit)	Mengembalikan salinan tanggal-waktu ini dengan jumlah yang ditentukan dikurangi.
Minus(ITemporalAmount)	Mengembalikan salinan tanggal-waktu ini dengan jumlah yang ditentukan dikurangi.
MinusDays(Int64)	Mengembalikan salinan ZonedDateTime ini dengan jumlah hari yang ditentukan dikurangi.
MinusHours(Int64)	Mengembalikan salinan ZonedDateTime ini dengan jumlah jam yang ditentukan dikurangi.
MinusMinutes(Int64)	Mengembalikan salinan ZonedDateTime ini dengan jumlah menit yang ditentukan dikurangi.
MinusMonths(Int64)	Mengembalikan salinan ZonedDateTime ini dengan jumlah bulan yang ditentukan dikurangi.
MinusNanos(Int64)	Mengembalikan salinan ZonedDateTime ini dengan jumlah nanodetik yang ditentukan dikurangi.
MinusSeconds(Int64)	Mengembalikan salinan ZonedDateTime ini dengan jumlah detik yang ditentukan dikurangi.
MinusWeeks(Int64)	Mengembalikan salinan ZonedDateTime ini dengan jumlah minggu yang ditentukan dikurangi.
MinusYears(Int64)	Mengembalikan salinan ZonedDateTime ini dengan jumlah tahun yang ditentukan dikurangi.
Notify()	Membangunkan satu utas yang menunggu monitor objek ini. (Diperoleh dari Object)
NotifyAll()	Membangunkan semua utas yang menunggu monitor objek ini. (Diperoleh dari Object)
Now()	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`.
Now(Clock)	Mendapatkan tanggal-waktu saat ini dari jam yang ditentukan.
Now(ZoneId)	Mendapatkan tanggal-waktu saat ini dari jam sistem di zona waktu yang ditentukan.
Of(Int32, Int32, Int32, Int32, Int32, Int32, Int32, ZoneId)	Mendapatkan instans ZonedDateTime dari satu tahun, bulan, hari, jam, menit, detik, nanodetik dan zona waktu.
Of(LocalDate, LocalTime, ZoneId)	Mendapatkan instans ZonedDateTime dari tanggal dan waktu lokal.
Of(LocalDateTime, ZoneId)	Mendapatkan instans ZonedDateTime dari tanggal-waktu lokal.
OfInstant(Instant, ZoneId)	Mendapatkan instans ZonedDateTime dari Instan.
OfInstant(LocalDateTime, ZoneOffset, ZoneId)	Mendapatkan instans ZonedDateTime dari instan yang dibentuk dengan menggabungkan tanggal-waktu lokal dan offset.
OfLocal(LocalDateTime, ZoneId, ZoneOffset)	Mendapatkan instans ZonedDateTime dari tanggal-waktu lokal menggunakan offset pilihan jika memungkinkan.
OfStrict(LocalDateTime, ZoneOffset, ZoneId)	Mendapatkan instans ZonedDateTime secara ketat memvalidasi kombinasi tanggal-waktu lokal, offset, dan ID zona.
Parse(ICharSequence, DateTimeFormatter)	Mendapatkan instans ZonedDateTime dari string teks menggunakan formatter tertentu.
Parse(ICharSequence)	Mendapatkan instans ZonedDateTime dari string teks seperti 2007-12-03T10:15:30+01:00[Eropa/Paris].
Parse(String, DateTimeFormatter)	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`.
Parse(String)	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`.
Plus(Int64, ITemporalUnit)	Mengembalikan salinan tanggal-waktu ini dengan jumlah yang ditentukan ditambahkan.
Plus(ITemporalAmount)	Mengembalikan salinan tanggal-waktu ini dengan jumlah yang ditentukan ditambahkan.
PlusDays(Int64)	Mengembalikan salinan ZonedDateTime ini dengan jumlah hari yang ditentukan ditambahkan.
PlusHours(Int64)	Mengembalikan salinan ZonedDateTime ini dengan jumlah jam yang ditentukan ditambahkan.
PlusMinutes(Int64)	Mengembalikan salinan ZonedDateTime ini dengan jumlah menit yang ditentukan ditambahkan.
PlusMonths(Int64)	Mengembalikan salinan ZonedDateTime ini dengan jumlah bulan yang ditentukan ditambahkan.
PlusNanos(Int64)	Mengembalikan salinan ZonedDateTime ini dengan jumlah nanodetik yang ditentukan ditambahkan.
PlusSeconds(Int64)	Mengembalikan salinan ZonedDateTime ini dengan jumlah detik yang ditentukan ditambahkan.
PlusWeeks(Int64)	Mengembalikan salinan ZonedDateTime ini dengan jumlah minggu yang ditentukan ditambahkan.
PlusYears(Int64)	Mengembalikan salinan ZonedDateTime ini dengan jumlah tahun yang ditentukan ditambahkan.
Query(ITemporalQuery)	Kueri tanggal-waktu ini menggunakan kueri yang ditentukan.
Range(ITemporalField)	Mendapatkan rentang nilai yang valid untuk bidang yang ditentukan.
SetHandle(IntPtr, JniHandleOwnership)	Mengatur properti Handle. (Diperoleh dari Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`. (Diperoleh dari JavaObject)
ToArray<T>()	Membuat array terkelola dari pembungkus array Java ini. (Diperoleh dari Object)
ToLocalDate()	Mendapatkan bagian LocalDate dari tanggal-waktu ini.
ToLocalDateTime()	Mendapatkan bagian LocalDateTime dari tanggal-waktu ini.
ToLocalTime()	Mendapatkan bagian LocalTime dari tanggal-waktu ini.
ToOffsetDateTime()	Mengonversi tanggal-waktu ini menjadi OffsetDateTime.
ToString()	Mengembalikan representasi string objek. (Diperoleh dari Object)
TruncatedTo(ITemporalUnit)	Mengembalikan salinan ZonedDateTime ini dengan waktu terpotong.
UnregisterFromRuntime()	Membatalkan pendaftaran peer Java ini dari runtime interop. (Diperoleh dari Object)
Until(ITemporal, ITemporalUnit)	Menghitung jumlah waktu hingga tanggal lain dalam hal unit yang ditentukan.
Wait()	Menyebabkan utas saat ini menunggu sampai terbangun, biasanya dengan <diberitahu></em> atau <em>terganggu</em>. (Diperoleh dari Object)
Wait(Int64, Int32)	Menyebabkan utas saat ini menunggu sampai terbangun, biasanya dengan <>diberitahu</em> atau <em>terganggu</em>, atau sampai sejumlah waktu nyata berlalu. (Diperoleh dari Object)
Wait(Int64)	Menyebabkan utas saat ini menunggu sampai terbangun, biasanya dengan <>diberitahu</em> atau <em>terganggu</em>, atau sampai sejumlah waktu nyata berlalu. (Diperoleh dari Object)
With(ITemporalAdjuster)	Mengembalikan salinan yang disesuaikan dari tanggal-waktu ini.
With(ITemporalField, Int64)	Mengembalikan salinan tanggal-waktu ini dengan bidang yang ditentukan diatur ke nilai baru.
WithDayOfMonth(Int32)	Mengembalikan salinan ZonedDateTime ini dengan perubahan hari dalam sebulan.
WithDayOfYear(Int32)	Mengembalikan salinan ZonedDateTime ini dengan perubahan hari dalam setahun.
WithEarlierOffsetAtOverlap()	Mengembalikan salinan tanggal-waktu ini mengubah offset zona ke offset sebelumnya dari dua offset yang valid pada tumpang tindih baris waktu lokal.
WithFixedOffsetZone()	Mengembalikan salinan tanggal-waktu ini dengan ID zona yang diatur ke offset.
WithHour(Int32)	Mengembalikan salinan ZonedDateTime ini dengan perubahan jam sehari.
WithLaterOffsetAtOverlap()	Mengembalikan salinan tanggal-waktu ini mengubah offset zona ke offset yang lebih baru dari dua offset yang valid pada tumpang tindih garis waktu lokal.
WithMinute(Int32)	Mengembalikan salinan ZonedDateTime ini dengan perubahan menit dari jam.
WithMonth(Int32)	Mengembalikan salinan ZonedDateTime ini dengan perubahan bulan dalam setahun.
WithNano(Int32)	Mengembalikan salinan ZonedDateTime ini dengan nano-of-second yang diubah.
WithSecond(Int32)	Mengembalikan salinan ZonedDateTime ini dengan perubahan kedua menit.
WithYear(Int32)	Mengembalikan salinan ZonedDateTime ini dengan tahun yang diubah.
WithZoneSameInstant(ZoneId)	Mengembalikan salinan tanggal-waktu ini dengan zona waktu yang berbeda, mempertahankan instan.
WithZoneSameLocal(ZoneId)	Mengembalikan salinan tanggal-waktu ini dengan zona waktu yang berbeda, mempertahankan tanggal-waktu lokal jika memungkinkan.

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IChronoZonedDateTime.Plus(Int64, ITemporalUnit)	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`.
IChronoZonedDateTime.ToLocalDateTime()	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`.
IChronoZonedDateTime.With(ITemporalField, Int64)	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`.
IChronoZonedDateTime.WithEarlierOffsetAtOverlap()	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`.
IChronoZonedDateTime.WithLaterOffsetAtOverlap()	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`.
IChronoZonedDateTime.WithZoneSameInstant(ZoneId)	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`.
IChronoZonedDateTime.WithZoneSameLocal(ZoneId)	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`.
IJavaPeerable.Disposed()	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`. (Diperoleh dari JavaObject)
IJavaPeerable.Finalized()	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`. (Diperoleh dari JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`. (Diperoleh dari JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`. (Diperoleh dari JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`. (Diperoleh dari JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`. (Diperoleh dari JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`.

Metode Ekstensi

Nama	Deskripsi
GetJniTypeName(IJavaPeerable)	Mendapatkan nama JNI dari jenis instans `self`.
JavaAs<TResult>(IJavaPeerable)	Cobalah untuk memaksa `self` untuk mengetik `TResult`, memeriksa bahwa paksaan valid di sisi Java.
JavaCast<TResult>(IJavaObject)	Melakukan konversi jenis yang diperiksa runtime Android.
JavaCast<TResult>(IJavaObject)	Tanggal-waktu dengan zona waktu dalam sistem kalender ISO-8601, seperti `2007-12-03T10:15:30+01:00 Europe/Paris`.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Cobalah untuk memaksa `self` untuk mengetik `TResult`, memeriksa bahwa paksaan valid di sisi Java.

Berlaku untuk