ITemporal Antarmuka
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.
Antarmuka tingkat kerangka kerja yang menentukan akses baca-tulis ke objek temporal, seperti tanggal, waktu, offset, atau beberapa kombinasi ini.
[Android.Runtime.Register("java/time/temporal/Temporal", "", "Java.Time.Temporal.ITemporalInvoker", ApiSince=26)]
public interface ITemporal : IDisposable, Java.Interop.IJavaPeerable, Java.Time.Temporal.ITemporalAccessor
[<Android.Runtime.Register("java/time/temporal/Temporal", "", "Java.Time.Temporal.ITemporalInvoker", ApiSince=26)>]
type ITemporal = interface
interface ITemporalAccessor
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- Turunan
- Atribut
- Penerapan
Keterangan
Antarmuka tingkat kerangka kerja yang menentukan akses baca-tulis ke objek temporal, seperti tanggal, waktu, offset, atau beberapa kombinasi ini.
Ini adalah jenis antarmuka dasar untuk objek tanggal, waktu, dan offset yang cukup lengkap untuk dimanipulasi menggunakan plus dan minus. Ini diimplementasikan oleh kelas-kelas yang dapat memberikan dan memanipulasi informasi sebagai bidang TemporalField atau kueri TemporalQuery. Lihat TemporalAccessor
untuk versi baca-saja dari antarmuka ini.
Sebagian besar informasi tanggal dan waktu dapat dinyatakan sebagai angka. Ini dimodelkan menggunakan TemporalField
dengan angka yang long
disimpan menggunakan untuk menangani nilai besar. Tahun, bulan, dan hari-bulan adalah contoh bidang sederhana, tetapi juga termasuk instan dan offset. Lihat ChronoField
untuk kumpulan bidang standar.
Dua bagian informasi tanggal/waktu tidak dapat diwakili oleh angka, kronologi java.time.chrono.Chronology dan zona waktu java.time.ZoneId. Ini dapat diakses melalui #query(TemporalQuery) queries
menggunakan metode statis yang ditentukan pada TemporalQuery
.
Antarmuka ini adalah antarmuka tingkat kerangka kerja yang tidak boleh digunakan secara luas dalam kode aplikasi. Sebagai gantinya, aplikasi harus membuat dan meneruskan instans jenis beton, seperti LocalDate
. Ada banyak alasan untuk ini, bagian dari yang mana implementasi antarmuka ini mungkin ada di sistem kalender selain ISO. Lihat java.time.chrono.ChronoLocalDate
untuk diskusi masalah yang lebih lengkap.
<h2>Kapan harus mengimplementasikan</h2>
Kelas harus menerapkan antarmuka ini jika memenuhi tiga kriteria: ul>li menyediakan akses ke informasi tanggal/waktu/offset, sesuai<TemporalAccessor
li>kumpulan bidang berdekatan dari yang terbesar ke yang terkecil<,>kumpulan bidang selesai, sehingga tidak ada bidang lain yang diperlukan untuk menentukan rentang nilai yang valid untuk bidang yang diwakili </ul><<>
Empat contoh memperjelas ini: <ul><li>LocalDate
mengimplementasikan antarmuka ini karena mewakili serangkaian bidang yang berdekatan dari hari ke selamanya dan tidak memerlukan informasi eksternal untuk menentukan validitas setiap tanggal. Oleh karena itu dapat mengimplementasikan plus/minus dengan benar. <li>LocalTime
mengimplementasikan antarmuka ini karena mewakili sekumpulan bidang yang berdekatan dari nanos ke dalam beberapa hari dan tidak memerlukan informasi eksternal untuk menentukan validitas. Ini dapat mengimplementasikan plus / minus dengan benar, dengan membungkus sepanjang hari. <li>MonthDay
, kombinasi bulanan dan hari dalam sebulan, tidak mengimplementasikan antarmuka ini. Meskipun kombinasinya berdekatan, dari hari ke bulan dalam tahun, kombinasi tidak memiliki informasi yang memadai untuk menentukan rentang nilai yang valid untuk hari ke bulan. Dengan demikian, tidak dapat menerapkan plus/minus dengan benar. <li>Kombinasi hari dalam seminggu dan hari dalam sebulan ("Jumat tanggal 13") tidak boleh mengimplementasikan antarmuka ini. Ini tidak mewakili sekumpulan bidang yang berdampingan, karena hari ke minggu tumpang tindih hari ke bulan. </Ul>
Ditambahkan dalam 1.8.
Dokumentasi Java untuk java.time.temporal.Temporal
.
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
Handle |
Mendapatkan nilai JNI dari objek Android yang mendasar. (Diperoleh dari IJavaObject) |
JniIdentityHashCode |
Mengembalikan nilai |
JniManagedPeerState |
Status serekan terkelola. (Diperoleh dari IJavaPeerable) |
JniPeerMembers |
Akses anggota dan dukungan pemanggilan. (Diperoleh dari IJavaPeerable) |
PeerReference |
Mengembalikan instans objek Java yang dibungkus JniObjectReference . (Diperoleh dari IJavaPeerable) |
Metode
Disposed() |
Dipanggil ketika instans telah dibuang. (Diperoleh dari IJavaPeerable) |
DisposeUnlessReferenced() |
Jika tidak ada referensi yang luar biasa untuk instans ini, maka panggilan |
Finalized() |
Dipanggil ketika instans telah diselesaikan. (Diperoleh dari IJavaPeerable) |
Get(ITemporalField) |
Mendapatkan nilai bidang yang ditentukan sebagai |
GetLong(ITemporalField) |
Mendapatkan nilai bidang yang ditentukan sebagai |
IsSupported(ITemporalField) |
Memeriksa apakah bidang yang ditentukan didukung. (Diperoleh dari ITemporalAccessor) |
IsSupported(ITemporalUnit) |
Memeriksa apakah unit yang ditentukan didukung. |
Minus(Int64, ITemporalUnit) |
Mengembalikan objek dengan tipe yang sama dengan objek ini dengan periode yang ditentukan dikurangi. |
Minus(ITemporalAmount) |
Mengembalikan objek dengan tipe yang sama dengan objek ini dengan jumlah yang dikurangi. |
Plus(Int64, ITemporalUnit) |
Mengembalikan objek dengan tipe yang sama dengan objek ini dengan periode yang ditentukan ditambahkan. |
Plus(ITemporalAmount) |
Mengembalikan objek dengan tipe yang sama dengan objek ini dengan jumlah yang ditambahkan. |
Query(ITemporalQuery) |
Kueri tanggal-waktu ini. (Diperoleh dari ITemporalAccessor) |
Range(ITemporalField) |
Mendapatkan rentang nilai yang valid untuk bidang yang ditentukan. (Diperoleh dari ITemporalAccessor) |
SetJniIdentityHashCode(Int32) |
Atur nilai yang dikembalikan oleh |
SetJniManagedPeerState(JniManagedPeerStates) |
Antarmuka tingkat kerangka kerja yang menentukan akses baca-tulis ke objek temporal, seperti tanggal, waktu, offset, atau beberapa kombinasi ini. (Diperoleh dari IJavaPeerable) |
SetPeerReference(JniObjectReference) |
Atur nilai yang dikembalikan oleh |
UnregisterFromRuntime() |
Batalkan pendaftaran instans ini sehingga runtime tidak akan mengembalikannya dari pemanggilan di masa mendatang Java.Interop.JniRuntime+JniValueManager.PeekValue . (Diperoleh dari IJavaPeerable) |
Until(ITemporal, ITemporalUnit) |
Menghitung jumlah waktu hingga temporal lain dalam hal unit yang ditentukan. |
With(ITemporalAdjuster) |
Mengembalikan objek yang disesuaikan dengan jenis yang sama dengan objek ini dengan penyesuaian yang dibuat. |
With(ITemporalField, Int64) |
Mengembalikan objek dengan tipe yang sama dengan objek ini dengan bidang yang ditentukan diubah. |
Metode Ekstensi
JavaCast<TResult>(IJavaObject) |
Melakukan konversi jenis yang diperiksa runtime Bahasa Umum Android. |
JavaCast<TResult>(IJavaObject) |
Antarmuka tingkat kerangka kerja yang menentukan akses baca-tulis ke objek temporal, seperti tanggal, waktu, offset, atau beberapa kombinasi ini. |
GetJniTypeName(IJavaPeerable) |
Antarmuka tingkat kerangka kerja yang menentukan akses baca-tulis ke objek temporal, seperti tanggal, waktu, offset, atau beberapa kombinasi ini. |