DateFormat Kelas
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.
DateFormat adalah kelas abstrak untuk subkelas pemformatan tanggal/waktu yang memformat dan mengurai tanggal atau waktu secara independen bahasa.
[Android.Runtime.Register("java/text/DateFormat", DoNotGenerateAcw=true)]
public abstract class DateFormat : Java.Text._Format
[<Android.Runtime.Register("java/text/DateFormat", DoNotGenerateAcw=true)>]
type DateFormat = class
inherit _Format
- Warisan
- Turunan
- Atribut
Keterangan
DateFormat adalah kelas abstrak untuk subkelas pemformatan tanggal/waktu yang memformat dan mengurai tanggal atau waktu secara independen bahasa. Subkelas pemformatan tanggal/waktu, seperti SimpleDateFormat, memungkinkan pemformatan (yaitu, tanggal → teks), penguraian (teks → tanggal), dan normalisasi. Tanggal dinyatakan sebagai Date objek atau sebagai milidetik sejak 1 Januari 1970, 00:00:00 GMT.
DateFormat menyediakan banyak metode kelas untuk mendapatkan pemformat tanggal/waktu default berdasarkan lokal default atau tertentu dan sejumlah gaya pemformatan. Gaya pemformatan meliputi #FULL, , #LONG#MEDIUM, dan #SHORT. Detail lebih lanjut dan contoh penggunaan gaya ini disediakan dalam deskripsi metode.
DateFormat membantu Anda memformat dan mengurai tanggal untuk lokal apa pun. Kode Anda dapat sepenuhnya independen dari konvensi lokal selama berbulan-bulan, hari dalam seminggu, atau bahkan format kalender: bulan vs. surya.
Untuk memformat tanggal untuk Lokal saat ini, gunakan salah satu metode pabrik statis: <blockquote>
{@code
myString = DateFormat.getDateInstance().format(myDate);
}
</blockquote>
Jika Anda memformat beberapa tanggal, lebih efisien untuk mendapatkan format dan menggunakannya beberapa kali sehingga sistem tidak perlu mengambil informasi tentang konvensi bahasa dan negara lokal beberapa kali. <blockquote>
{@code
DateFormat df = DateFormat.getDateInstance();
for (int i = 0; i < myDate.length; ++i) {
output.println(df.format(myDate[i]) + "; ");
}
}
</blockquote>
Untuk memformat tanggal untuk Lokal yang berbeda, tentukan dalam panggilan ke #getDateInstance(int, Locale) getDateInstance().
<blockquote>
{@code
DateFormat df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE);
}
</blockquote>
Anda juga dapat menggunakan DateFormat untuk mengurai. <blockquote>
{@code
myDate = df.parse(myString);
}
</blockquote>
Gunakan getDateInstance untuk mendapatkan format tanggal normal untuk negara tersebut. Ada metode pabrik statis lainnya yang tersedia. Gunakan getTimeInstance untuk mendapatkan format waktu untuk negara tersebut. Gunakan getDateTimeInstance untuk mendapatkan format tanggal dan waktu. Anda dapat meneruskan berbagai opsi ke metode pabrik ini untuk mengontrol panjang hasil; dari #SHORT ke #MEDIUM ke #LONG#FULL. Hasil yang tepat tergantung pada lokal, tetapi umumnya: ul li< benar-benar numerik, seperti >< atau>#SHORT li12.13.523:30pm lebih panjang, seperti<> li#MEDIUMJan 12, 1952 lebih panjang, seperti < atau>#LONG liJanuary 12, 19523:30:32pm cukup ditentukan sepenuhnya, seperti .<>#FULLTuesday, April 12, 1952 AD or 3:30:42pm PST
</ul>
Anda juga dapat mengatur zona waktu pada format jika Anda mau. Jika Anda ingin kontrol yang lebih besar atas format atau penguraian, (atau ingin memberi pengguna Anda lebih banyak kontrol), Anda dapat mencoba mentransmisikan yang DateFormat Anda dapatkan dari metode pabrik ke SimpleDateFormat. Ini akan bekerja untuk mayoritas negara; ingatlah untuk meletakkannya di try blok jika Anda mengalami yang tidak biasa.
Anda juga dapat menggunakan bentuk metode penguraian dan format dengan ParsePosition dan FieldPosition untuk memungkinkan Anda mengurai <><>li secara progresif melalui potongan string.
<li>sejajarkan bidang tertentu, atau cari tahu di mana bidang tersebut untuk pilihan di layar.
</ul>
<h2>"synchronization">Synchronization</h2>
Format tanggal tidak disinkronkan. Disarankan untuk membuat instans format terpisah untuk setiap utas. Jika beberapa utas mengakses format secara bersamaan, utas tersebut harus disinkronkan secara eksternal.
Ditambahkan dalam 1.1.
Java dokumentasi untuk java.text.DateFormat.
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.
Konstruktor
| Nama | Deskripsi |
|---|---|
| DateFormat() |
Buat format tanggal baru. |
| DateFormat(IntPtr, JniHandleOwnership) |
Konstruktor yang digunakan saat membuat representasi terkelola objek JNI; dipanggil oleh runtime. |
Bidang
| Nama | Deskripsi |
|---|---|
| AmPmField |
Konstanta yang berguna untuk perataan bidang AM_PM. |
| DateField |
Konstanta yang berguna untuk perataan bidang DATE. |
| DayOfWeekField |
Konstanta yang berguna untuk perataan bidang DAY_OF_WEEK. |
| DayOfWeekInMonthField |
Konstanta yang berguna untuk perataan bidang DAY_OF_WEEK_IN_MONTH. |
| DayOfYearField |
Konstanta yang berguna untuk perataan bidang DAY_OF_YEAR. |
| Default |
Konstanta untuk pola gaya default. |
| EraField |
Konstanta yang berguna untuk perataan bidang ERA. |
| Full |
Konstanta untuk pola gaya penuh. |
| Hour0Field |
Konstanta yang berguna untuk perataan bidang HOUR berbasis nol. |
| Hour1Field |
Konstanta yang berguna untuk perataan bidang HOUR berbasis satu. |
| HourOfDay0Field |
Konstanta yang berguna untuk perataan bidang HOUR_OF_DAY berbasis nol. |
| HourOfDay1Field |
Konstanta yang berguna untuk perataan bidang HOUR_OF_DAY berbasis satu. |
| Long |
Konstanta untuk pola gaya panjang. |
| Medium |
Konstanta untuk pola gaya sedang. |
| MillisecondField |
Konstanta yang berguna untuk perataan bidang MILLISECOND. |
| MinuteField |
Konstanta yang berguna untuk perataan bidang MINUTE. |
| MonthField |
Konstanta yang berguna untuk perataan bidang MONTH. |
| SecondField |
Konstanta yang berguna untuk perataan bidang SECOND. |
| Short |
Konstanta untuk pola gaya pendek. |
| TimezoneField |
Konstanta yang berguna untuk perataan bidang TIMEZONE. |
| WeekOfMonthField |
Konstanta yang berguna untuk perataan bidang WEEK_OF_MONTH. |
| WeekOfYearField |
Konstanta yang berguna untuk perataan bidang WEEK_OF_YEAR. |
| YearField |
Konstanta yang berguna untuk perataan bidang YEAR. |
Properti
| Nama | Deskripsi |
|---|---|
| Calendar |
Mendapatkan kalender yang terkait dengan pemformat tanggal/waktu ini. -or- Atur kalender yang akan digunakan oleh format tanggal ini. |
| Class |
Mengembalikan kelas runtime dari . |
| DateInstance |
Mendapatkan formatter tanggal dengan gaya pemformatan default untuk lokal default |
| DateTimeInstance |
Mendapatkan formatter tanggal/waktu dengan gaya pemformatan default untuk lokal default |
| Handle |
Handel ke instans Android yang mendasar. (Diperoleh dari Object) |
| Instance |
Dapatkan formatter tanggal/waktu default yang menggunakan gaya SHORT untuk tanggal dan waktu. |
| JniIdentityHashCode |
Mendapatkan kode hash identitas yang ditetapkan ke Java peer ini oleh runtime interop. (Diperoleh dari Object) |
| JniManagedPeerState |
|
| JniPeerMembers |
|
| Lenient |
Beri tahu apakah penguraian tanggal/waktu menjadi lenient. -or- Tentukan apakah penguraian tanggal/waktu akan menjadi lenient atau tidak. |
| NumberFormat |
Mendapatkan formatter angka yang digunakan pemformat tanggal/waktu ini untuk memformat dan mengurai waktu. -or- Memungkinkan Anda mengatur pemformat angka. |
| PeerReference |
Mendapatkan referensi objek JNI untuk peer Java ini. (Diperoleh dari Object) |
| ThresholdClass |
API ini mendukung infrastruktur Mono untuk Android dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. |
| ThresholdType |
API ini mendukung infrastruktur Mono untuk Android dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. |
| TimeInstance |
Mendapatkan pemformat waktu dengan gaya pemformatan default untuk lokal default |
| TimeZone |
Mendapatkan zona waktu. -or- Mengatur zona waktu untuk kalender objek ini |
Metode
| Nama | Deskripsi |
|---|---|
| Clone() |
Membuat dan mengembalikan salinan objek ini. (Diperoleh dari _Format) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
|
| 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() |
|
| Equals(Object) |
|
| Equals(Object) |
Menunjukkan apakah beberapa objek lain "sama dengan" yang satu ini. (Diperoleh dari Object) |
| Format(Date, StringBuffer, FieldPosition) |
Memformat |
| Format(Date) |
Memformat |
| Format(Object, StringBuffer, FieldPosition) |
Memformat yang diberikan |
| Format(Object) |
Memformat objek untuk menghasilkan string. (Diperoleh dari _Format) |
| FormatToCharacterIterator(Object) |
Memformat Objek yang |
| GetAvailableLocales() |
Mengembalikan array semua lokal yang |
| GetDateInstance(Int32, Locale) |
Mendapatkan formatter tanggal dengan gaya pemformatan yang diberikan untuk lokal tertentu. |
| GetDateInstance(Int32) |
Mendapatkan pemformat tanggal dengan gaya pemformatan yang diberikan untuk lokal default |
| GetDateTimeInstance(Int32, Int32, Locale) |
Mendapatkan formatter tanggal/waktu dengan gaya pemformatan yang diberikan untuk lokal tertentu. |
| GetDateTimeInstance(Int32, Int32) |
Mendapatkan formatter tanggal/waktu dengan gaya pemformatan tanggal dan waktu tertentu untuk lokal default |
| GetHashCode() |
Mengembalikan nilai kode hash untuk objek . (Diperoleh dari Object) |
| GetTimeInstance(Int32, Locale) |
Mendapatkan pemformat waktu dengan gaya pemformatan yang diberikan untuk lokal tertentu. |
| GetTimeInstance(Int32) |
Mendapatkan pemformat waktu dengan gaya pemformatan yang diberikan untuk lokal default |
| JavaFinalize() |
Dipanggil oleh pengumpul sampah pada objek ketika pengumpulan sampah menentukan bahwa tidak ada lagi referensi ke objek. (Diperoleh dari Object) |
| Notify() |
Membangunkan satu utas yang menunggu monitor objek ini. (Diperoleh dari Object) |
| NotifyAll() |
Membangunkan semua utas yang menunggu monitor objek ini. (Diperoleh dari Object) |
| Parse(String, ParsePosition) |
Uraikan string tanggal/waktu sesuai dengan posisi penguraian yang diberikan. |
| Parse(String) |
Mengurai teks dari awal string yang diberikan untuk menghasilkan tanggal. |
| ParseObject(String, ParsePosition) |
Mengurai teks dari string untuk menghasilkan |
| ParseObject(String) |
Mengurai teks dari awal string yang diberikan untuk menghasilkan objek. (Diperoleh dari _Format) |
| SetHandle(IntPtr, JniHandleOwnership) |
Mengatur properti Handle. (Diperoleh dari Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
|
| ToArray<T>() |
Membuat array terkelola dari pembungkus array Java ini. (Diperoleh dari Object) |
| ToString() |
Mengembalikan representasi string objek. (Diperoleh dari Object) |
| UnregisterFromRuntime() |
Membatalkan pendaftaran peer Java ini dari runtime interop. (Diperoleh dari Object) |
| 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) |
Implementasi Antarmuka Eksplisit
| Nama | Deskripsi |
|---|---|
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniObjectReferenceControlBlock |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
| IJavaPeerable.UnregisterFromRuntime() |
|
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) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Cobalah untuk memaksa |