NumberFormat 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.
NumberFormat adalah kelas dasar abstrak untuk semua format angka.
[Android.Runtime.Register("java/text/NumberFormat", DoNotGenerateAcw=true)]
public abstract class NumberFormat : Java.Text._Format[<Android.Runtime.Register("java/text/NumberFormat", DoNotGenerateAcw=true)>]
type NumberFormat = class
inherit _Format- Warisan
- Turunan
- Atribut
Keterangan
NumberFormat adalah kelas dasar abstrak untuk semua format angka. Kelas ini menyediakan antarmuka untuk memformat dan mengurai angka.
NumberFormat juga menyediakan metode untuk menentukan lokal mana yang memiliki format angka, dan apa namanya.
NumberFormat membantu Anda memformat dan mengurai angka untuk lokal apa pun. Kode Anda dapat sepenuhnya independen dari konvensi lokal untuk titik desimal, ribuan pemisah, atau bahkan digit desimal tertentu yang digunakan, atau apakah format angka bahkan desimal.
Untuk memformat angka untuk Lokal saat ini, gunakan salah satu metode kelas pabrik: <blockquote>
{@code
myString = NumberFormat.getInstance().format(myNumber);
}
</blockquote> Jika Anda memformat beberapa angka, 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
NumberFormat nf = NumberFormat.getInstance();
for (int i = 0; i < myNumber.length; ++i) {
output.println(nf.format(myNumber[i]) + "; ");
}
}
</blockquote> Untuk memformat angka untuk Lokal yang berbeda, tentukan dalam panggilan ke getInstance.
<blockquote>
{@code
NumberFormat nf = NumberFormat.getInstance(Locale.FRENCH);
}
</blockquote>
Jika lokal berisi ekstensi Unicode "nu" (angka), digit desimal, dan/atau negara yang digunakan untuk pemformatan akan ditimpa.
Anda juga dapat menggunakan untuk mengurai NumberFormat angka: <blockquote>
{@code
myNumber = nf.parse(myString);
}
</blockquote> Gunakan getInstance atau getNumberInstance untuk mendapatkan format angka normal. Gunakan getIntegerInstance untuk mendapatkan format angka bilangan bulat. Gunakan getCurrencyInstance untuk mendapatkan format nomor mata uang. Gunakan getCompactNumberInstance untuk mendapatkan format angka ringkas untuk memformat angka dalam bentuk yang lebih pendek. Misalnya, 2000 dapat diformat seperti "2K" dalam java.util.Locale#US US locale. Gunakan getPercentInstance untuk mendapatkan format untuk menampilkan persentase. Dengan format ini, pecahan seperti 0,53 ditampilkan sebagai 53%.
Anda juga dapat mengontrol tampilan angka dengan metode seperti setMinimumFractionDigits. Jika Anda ingin kontrol yang lebih besar atas format atau penguraian, atau ingin memberi pengguna Anda kontrol lebih, Anda dapat mencoba mentransmisikan NumberFormat yang Anda dapatkan dari metode pabrik ke DecimalFormat atau CompactNumberFormat tergantung pada metode pabrik yang digunakan. Ini akan berfungsi untuk sebagian besar lokal; ingatlah untuk meletakkannya di try blok jika Anda mengalami yang tidak biasa.
NumberFormat dan DecimalFormat dirancang seragam sehingga beberapa kontrol berfungsi untuk pemformatan dan yang lain berfungsi untuk penguraian. Berikut ini adalah deskripsi terperinci untuk setiap metode kontrol ini,
setParseIntegerOnly : hanya memengaruhi penguraian, misalnya jika benar, "3456.78" → 3456 (dan meninggalkan posisi penguraian tepat setelah indeks 6) jika false, "3456.78" → 3456.78 (dan meninggalkan posisi penguraian tepat setelah indeks 8) Ini tidak bergantung pada pemformatan. Jika Anda ingin tidak menampilkan titik desimal di mana mungkin tidak ada digit setelah titik desimal, gunakan setDecimalSeparatorAlwaysShown.
setDecimalSeparatorAlwaysShown : hanya memengaruhi pemformatan, dan hanya di mana mungkin tidak ada digit setelah titik desimal, seperti dengan pola seperti "#,##0.##", misalnya, jika benar, 3456.00 → "3,456." jika false, 3456.00 → "3456" Ini independen dari penguraian. Jika Anda ingin penguraian berhenti di titik desimal, gunakan setParseIntegerOnly.
Anda juga dapat menggunakan bentuk parse metode dan dengan format dan ParsePositionFieldPosition untuk memungkinkan Anda untuk: <ul><li> secara progresif mengurai bagian string <sejajar> dengan titik desimal dan area </ul> lainnya Misalnya, Anda dapat menyelaraskan angka dengan dua cara: <ol><li> Jika Anda menggunakan font monospace dengan spasi untuk penyelarasan, Anda dapat meneruskan FieldPosition dalam panggilan format Anda, dengan field = INTEGER_FIELD. Pada output, getEndIndex akan diatur ke offset antara karakter terakhir bilangan bulat dan desimal. Tambahkan spasi (desiredSpaceCount - getEndIndex) di bagian depan string.
<li> Jika Anda menggunakan font proporsional, alih-alih mengayuh dengan spasi, ukur lebar string dalam piksel dari awal hingga getEndIndex. Kemudian pindahkan pena menurut (desiredPixelWidth - widthToAlignmentPoint) sebelum menggambar teks. Ini juga berfungsi di mana tidak ada desimal, tetapi mungkin karakter tambahan di akhir, misalnya, dengan tanda kurung dalam angka negatif: "(12)" untuk -12.
</Ol>
<h2>"synchronization">Synchronization</h2>
Format angka umumnya 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.
Dokumentasi Java untuk java.text.NumberFormat.
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 |
|---|---|
| NumberFormat() |
Satu-satu konstruktor. |
| NumberFormat(IntPtr, JniHandleOwnership) |
Konstruktor yang digunakan saat membuat representasi terkelola objek JNI; dipanggil oleh runtime. |
Bidang
| Nama | Deskripsi |
|---|---|
| FractionField |
Konstanta bidang yang digunakan untuk membuat objek FieldPosition. |
| IntegerField |
Konstanta bidang yang digunakan untuk membuat objek FieldPosition. |
Properti
| Nama | Deskripsi |
|---|---|
| Class |
Mengembalikan kelas runtime dari . |
| Currency |
Mendapatkan mata uang yang digunakan oleh format angka ini saat memformat nilai mata uang. -or- Mengatur mata uang yang digunakan oleh format angka ini saat memformat nilai mata uang. |
| CurrencyInstance |
Mengembalikan format mata uang untuk lokal default |
| GroupingUsed |
Mengembalikan true jika pengelompokan digunakan dalam format ini. -atau- Atur apakah pengelompokan akan digunakan dalam format ini atau tidak. |
| Handle |
Handel ke instans Android yang mendasar. (Diperoleh dari Object) |
| Instance |
Mengembalikan format angka tujuan umum untuk lokal default |
| IntegerInstance |
Mengembalikan format angka bilangan bulat untuk lokal default |
| JniIdentityHashCode |
Mendapatkan kode hash identitas yang ditetapkan ke Java peer ini oleh runtime interop. (Diperoleh dari Object) |
| JniManagedPeerState |
|
| JniPeerMembers |
|
| MaximumFractionDigits |
Mengembalikan jumlah maksimum digit yang diizinkan dalam bagian pecahan angka. -or- Mengatur jumlah maksimum digit yang diizinkan dalam bagian pecahan angka. |
| MaximumIntegerDigits |
Mengembalikan jumlah maksimum digit yang diizinkan dalam bagian bilangan bulat dari angka. -or- Mengatur jumlah maksimum digit yang diizinkan dalam bagian bilangan bulat angka. |
| MinimumFractionDigits |
Mengembalikan jumlah minimum digit yang diizinkan dalam bagian pecahan angka. -or- Mengatur jumlah minimum digit yang diizinkan dalam bagian pecahan angka. |
| MinimumIntegerDigits |
Mengembalikan jumlah minimum digit yang diizinkan dalam bagian bilangan bulat dari angka. -or- Mengatur jumlah minimum digit yang diizinkan dalam bagian bilangan bulat dari angka. |
| NumberInstance |
Mengembalikan format angka tujuan umum untuk lokal default |
| ParseIntegerOnly |
Mengembalikan true jika format ini hanya akan mengurai angka sebagai bilangan bulat. -atau- Mengatur apakah angka harus diuraikan sebagai bilangan bulat saja atau tidak. |
| PeerReference |
Mendapatkan referensi objek JNI untuk peer Java ini. (Diperoleh dari Object) |
| PercentInstance |
Mengembalikan format persentase untuk lokal default |
| RoundingMode |
Mendapatkan yang |
| 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. |
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(Double, StringBuffer, FieldPosition) |
Spesialisasi format. |
| Format(Double) |
Spesialisasi format. |
| Format(Int64, StringBuffer, FieldPosition) |
Spesialisasi format. |
| Format(Int64) |
Spesialisasi format. |
| Format(Object, StringBuffer, FieldPosition) |
Memformat angka dan menambahkan teks yang dihasilkan ke buffer string yang diberikan. |
| Format(Object) |
Memformat objek untuk menghasilkan string. (Diperoleh dari _Format) |
| FormatToCharacterIterator(Object) |
Memformat Objek yang |
| GetAvailableLocales() |
Mengembalikan format ilmiah untuk lokal default saat ini. |
| GetCurrencyInstance(Locale) |
Mengembalikan format mata uang untuk lokal yang ditentukan. |
| GetHashCode() |
Mengembalikan nilai kode hash untuk objek . (Diperoleh dari Object) |
| GetInstance(Locale) |
Mengembalikan format angka tujuan umum untuk lokal yang ditentukan. |
| GetIntegerInstance(Locale) |
Mengembalikan format angka bilangan bulat untuk lokal yang ditentukan. |
| GetNumberInstance(Locale) |
Mengembalikan format angka tujuan umum untuk lokal yang ditentukan. |
| GetPercentInstance(Locale) |
Mengembalikan format persentase untuk lokal yang ditentukan. |
| 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) |
Mengembalikan Panjang jika memungkinkan (e. |
| Parse(String) |
Mengurai teks dari awal string yang diberikan untuk menghasilkan angka. |
| 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 |