IChronology 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.
Sistem kalender, digunakan untuk menata dan mengidentifikasi tanggal.
[Android.Runtime.Register("java/time/chrono/Chronology", "", "Java.Time.Chrono.IChronologyInvoker", ApiSince=26)]
public interface IChronology : IDisposable, Java.Interop.IJavaPeerable, Java.Lang.IComparable
[<Android.Runtime.Register("java/time/chrono/Chronology", "", "Java.Time.Chrono.IChronologyInvoker", ApiSince=26)>]
type IChronology = interface
interface IComparable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- Turunan
- Atribut
- Penerapan
Keterangan
Sistem kalender, digunakan untuk menata dan mengidentifikasi tanggal.
API tanggal dan waktu utama dibangun pada sistem kalender ISO. Kronologi beroperasi di belakang layar untuk mewakili konsep umum sistem kalender. Misalnya, Jepang, Minguo, Buddha Thailand dan lainnya.
Sebagian besar sistem kalender lainnya juga beroperasi pada konsep bersama tahun, bulan dan hari, yang terkait dengan siklus Bumi di sekitar Matahari, dan Bulan di sekitar Bumi. Konsep bersama ini didefinisikan oleh ChronoField dan tersedia untuk digunakan oleh implementasi apa pun Chronology :
LocalDate isoDate = ...
ThaiBuddhistDate thaiDate = ...
int isoYear = isoDate.get(ChronoField.YEAR);
int thaiYear = thaiDate.get(ChronoField.YEAR);
Seperti yang ditunjukkan, meskipun objek tanggal berada dalam sistem kalender yang berbeda, diwakili oleh instans yang berbeda Chronology , keduanya dapat dikueri menggunakan konstanta yang sama pada ChronoField. Untuk diskusi lengkap tentang implikasi ini, lihat ChronoLocalDate. Secara umum, sarannya adalah menggunakan berbasis LocalDateISO yang diketahui, bukan ChronoLocalDate.
Chronology Meskipun objek biasanya menggunakan ChronoField dan didasarkan pada model tanggal era, tahunan, bulan dalam setahun, hari dalam sebulan, ini tidak diperlukan. Instans Chronology dapat mewakili jenis sistem kalender yang sama sekali berbeda, seperti Maya.
Dalam istilah praktis, Chronology instans juga bertindak sebagai pabrik. Metode ini #of(String) memungkinkan instans untuk dicari oleh pengidentifikasi, sementara #ofLocale(Locale) metode memungkinkan pencarian dengan lokal.
Chronology Instans menyediakan serangkaian metode untuk membuat ChronoLocalDate instans. Kelas tanggal digunakan untuk memanipulasi tanggal tertentu.
<ul><li><#dateNow() dateNow()li>><#dateNow(Clock) dateNow(clock)<#dateNow(ZoneId) dateNow(zone)li<#date(int, int, int) date(yearProleptic, month, day)>li#date(Era, int, int, int) date(era, yearOfEra, month, day)><li><#dateYearDay(int, int) dateYearDay(yearProleptic, dayOfYear)li#dateYearDay(Era, int, int) dateYearDay(era, yearOfEra, dayOfYear)<><>#date(TemporalAccessor) date(TemporalAccessor) li/ul>
<h2 id="addcalendars">Adding New Calendars</h2> Kumpulan kronologi yang tersedia dapat diperluas oleh aplikasi. Menambahkan sistem kalender baru memerlukan penulisan implementasi Chronology, ChronoLocalDate dan Era. Sebagian besar logika khusus untuk sistem kalender akan berada dalam ChronoLocalDate implementasi. Implementasi bertindak Chronology sebagai pabrik.
Untuk mengizinkan penemuan kronologi tambahan, java.util.ServiceLoader ServiceLoader digunakan. File harus ditambahkan ke META-INF/services direktori dengan nama 'java.time.chrono.Chronology' yang mencantumkan kelas implementasi. Lihat ServiceLoader untuk detail selengkapnya tentang pemuatan layanan. Untuk pencarian menurut id atau calendarType, kalender yang disediakan sistem ditemukan terlebih dahulu diikuti oleh kalender yang disediakan aplikasi.
Setiap kronologi harus menentukan ID kronologi yang unik dalam sistem. Jika kronologi mewakili sistem kalender yang ditentukan oleh spesifikasi CLDR, maka jenis kalender adalah perangkaian jenis CLDR dan, jika berlaku, varian CLDR.
Ditambahkan dalam 1.8.
Java dokumentasi untuk java.time.chrono.Chronology.
Bagian dari halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Android Open Source Project dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Creative Commons 2.5 Lisensi Atribusi.
Properti
| Nama | Deskripsi |
|---|---|
| AvailableChronologies |
Mengembalikan kronologi yang tersedia. |
| CalendarType |
Sistem kalender, digunakan untuk menata dan mengidentifikasi tanggal. |
| Handle |
Mendapatkan nilai JNI dari objek Android yang mendasar. (Diperoleh dari IJavaObject) |
| Id |
Sistem kalender, digunakan untuk menata dan mengidentifikasi tanggal. |
| 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 dibungkusJniObjectReference. (Diperoleh dari IJavaPeerable) |
Metode
| Nama | Deskripsi |
|---|---|
| CompareTo(IChronology) |
Membandingkan kronologi ini dengan kronologi lain. |
| CompareTo(Object) |
Membandingkan objek ini dengan objek yang ditentukan untuk pesanan. (Diperoleh dari IComparable) |
| Date(IEra, Int32, Int32, Int32) |
Mendapatkan tanggal lokal dalam kronologi ini dari bidang era, tahun era, bulan dalam setahun, dan hari dalam sebulan. |
| Date(Int32, Int32, Int32) |
Mendapatkan tanggal lokal dalam kronologi ini dari bidang tahun prolepsi, bulan dalam setahun, dan hari dalam bulan. |
| Date(ITemporalAccessor) |
Mendapatkan tanggal lokal dalam kronologi ini dari objek temporal lain. |
| DateEpochDay(Int64) |
Mendapatkan tanggal lokal dalam kronologi ini dari epoch-day. |
| DateNow() |
Mendapatkan tanggal lokal saat ini dalam kronologi ini dari jam sistem di zona waktu default. |
| DateNow(Clock) |
Mendapatkan tanggal lokal saat ini dalam kronologi ini dari jam yang ditentukan. |
| DateNow(ZoneId) |
Mendapatkan tanggal lokal saat ini dalam kronologi ini dari jam sistem di zona waktu yang ditentukan. |
| DateYearDay(IEra, Int32, Int32) |
Mendapatkan tanggal lokal dalam kronologi ini dari era, tahun era dan bidang sehari-tahun. |
| DateYearDay(Int32, Int32) |
Mendapatkan tanggal lokal dalam kronologi ini dari bidang prolepsi tahun dan hari dalam setahun. |
| Disposed() |
Dipanggil ketika instans telah dibuang. (Diperoleh dari IJavaPeerable) |
| DisposeUnlessReferenced() |
Jika tidak ada referensi yang luar biasa untuk instans ini, maka panggilan |
| EpochSecond(IEra, Int32, Int32, Int32, Int32, Int32, Int32, ZoneOffset) |
Mendapatkan jumlah detik dari epoch 1970-01-01T00:00:00Z. |
| EpochSecond(Int32, Int32, Int32, Int32, Int32, Int32, ZoneOffset) |
Mendapatkan jumlah detik dari epoch 1970-01-01T00:00:00Z. |
| Equals(Object) |
Memeriksa apakah kronologi ini sama dengan kronologi lain. |
| EraOf(Int32) |
Membuat objek era kronologi dari nilai numerik. |
| Eras() |
Mendapatkan daftar era untuk kronologi. |
| Finalized() |
Dipanggil ketika instans telah diselesaikan. (Diperoleh dari IJavaPeerable) |
| From(ITemporalAccessor) |
Mendapatkan instans dari |
| GetDisplayName(TextStyle, Locale) |
Mendapatkan representasi tekstual dari kronologi ini. |
| GetHashCode() |
Kode hash untuk kronologi ini. |
| IsLeapYear(Int64) |
Memeriksa apakah tahun yang ditentukan adalah tahun kampung. |
| LocalDateTime(ITemporalAccessor) |
Mendapatkan tanggal-waktu lokal dalam kronologi ini dari objek temporal lain. |
| Of(String) |
Mendapatkan instans |
| OfLocale(Locale) |
Mendapatkan instans dari |
| Period(Int32, Int32, Int32) |
Mendapatkan periode untuk kronologi ini berdasarkan tahun, bulan dan hari. |
| ProlepticYear(IEra, Int32) |
Menghitung tahun prolepsi mengingat era dan tahun-era. |
| Range(ChronoField) |
Mendapatkan rentang nilai yang valid untuk bidang yang ditentukan. |
| ResolveDate(IDictionary<ITemporalField,Long>, ResolverStyle) |
Menyelesaikan nilai yang diurai |
| SetJniIdentityHashCode(Int32) |
Atur nilai yang dikembalikan oleh |
| SetJniManagedPeerState(JniManagedPeerStates) |
Sistem kalender, digunakan untuk menata dan mengidentifikasi tanggal. (Diperoleh dari IJavaPeerable) |
| SetPeerReference(JniObjectReference) |
Atur nilai yang dikembalikan oleh |
| ToString() |
Menghasilkan kronologi ini sebagai |
| UnregisterFromRuntime() |
Batalkan pendaftaran instans ini sehingga runtime tidak akan mengembalikannya dari pemanggilan di masa mendatang Java.Interop.JniRuntime+JniValueManager.PeekValue . (Diperoleh dari IJavaPeerable) |
| ZonedDateTime(Instant, ZoneId) |
|
| ZonedDateTime(ITemporalAccessor) |
|
Metode Ekstensi
| Nama | Deskripsi |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Mendapatkan nama JNI dari jenis instans |
| JavaAs<TResult>(IJavaPeerable) |
Cobalah untuk memaksa |
| JavaCast<TResult>(IJavaObject) |
Melakukan konversi jenis yang diperiksa runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Sistem kalender, digunakan untuk menata dan mengidentifikasi tanggal. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Cobalah untuk memaksa |