SimpleDateFormat 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.
SimpleDateFormat adalah kelas konkret untuk memformat dan mengurai tanggal dengan cara yang sensitif terhadap lokal.
[Android.Runtime.Register("java/text/SimpleDateFormat", DoNotGenerateAcw=true)]
public class SimpleDateFormat : Java.Text.DateFormat[<Android.Runtime.Register("java/text/SimpleDateFormat", DoNotGenerateAcw=true)>]
type SimpleDateFormat = class
inherit DateFormat- Warisan
- Atribut
Keterangan
SimpleDateFormat adalah kelas konkret untuk memformat dan mengurai tanggal dengan cara yang sensitif terhadap lokal. Ini memungkinkan pemformatan (tanggal → teks), penguraian (teks → tanggal), dan normalisasi.
SimpleDateFormat memungkinkan Anda memulai dengan memilih pola yang ditentukan pengguna untuk pemformatan tanggal-waktu. Namun, Anda dianjurkan untuk membuat formatter tanggal-waktu dengan getTimeInstance, , getDateInstanceatau getDateTimeInstance di DateFormat. Masing-masing metode kelas ini dapat mengembalikan formatter tanggal/waktu yang diinisialisasi dengan pola format default. Anda dapat mengubah pola format menggunakan applyPattern metode sesuai keinginan. Untuk informasi selengkapnya tentang menggunakan metode ini, lihat DateFormat.
<h2>Pola< Tanggal dan Waktu/h2>
Format tanggal dan waktu ditentukan oleh <>string pola< tanggal dan waktu/em>. Dalam string pola tanggal dan waktu, huruf yang tidak dikutip dari 'A' ke 'Z' dan dari 'a' ke 'z' ditafsirkan sebagai huruf pola yang mewakili komponen string tanggal atau waktu. Teks dapat dikutip menggunakan tanda kutip tunggal (') untuk menghindari interpretasi. "''" mewakili tanda kutip tunggal. Semua karakter lain tidak ditafsirkan; mereka hanya disalin ke dalam string output selama pemformatan atau dicocokkan dengan string input selama penguraian.
Huruf pola berikut didefinisikan (semua karakter lain dari 'A' ke dan dari 'a' ke 'z' 'Z' dicadangkan): <tabel blockquote<>class="striped"><caption style="display:none">Chart menunjukkan huruf pola, komponen tanggal/waktu, presentasi, dan contoh.</caption><thead><tr><th scope="col" style="text-align:left">Letter <th scope="col" style="text-align:left">Date or Time Component <th scope="col" style="text-align:left">Lingkup th presentasi<="col" style="text-align:left">Examples <th scope="col" style="text-align:left">Supported (API Levels) </thead><tr><<>th scope="row"G><td Era> designator <td>Text<td><ADtd>1+</td<>tr><th scope="row"><ytd Year <td>>Year<td;< 96>1996td>1+</td><tr<>scope="row"Y<>td>Week year <td>Year<td; 09<>2009td>24+</td><tr><scope="row"<>Mtd>Month in year (context sensitive) <td>Month<tdJuly>; ; 07< Jultd>1+</td<>tr<>th scope="row"<>Ltd>Month in year (standalone form) <td>Month<tdJuly>; ; 07< Jultd>TBD</td><tr><th scope="row"w<>td>Week in year <td>Nomor<td td><27>1+</td<>tr><scope="row"><Wtd>Week in month <td>Angka<td td>2<>1+</td<>tr><th scope="row"><Dtd>Day in year <td>Number<td>189<td>1+</td><tr><th scope="row">d<td>Day in month <td>Number<td td<>10>1+</td<>tr><th scope="row"F<>td>Day of week in month <td>Number<td td>2><1+</td<>tr><scope="row">E<td>Day name in week <td Text><td>Tuesday; td>1+</td<>tr<>scope="row"><utd>Nomor hari dalam seminggu (1 = Senin, ..., 7 = Minggu) <td>Angka<td><1td>24+</td><tr<>scope="row"a<>td>Am/pm marker <td>Text<td td<PM>>1+</td tr<<>>th scope="row"H><td> Tue<Jam dalam hari (0-23) td Nomor td td>0<>1+</td><tr<>th scope="row"k<>td>Jam dalam hari (1-24) <td>Angka<td td24>><1+/td<>tr><scope th="row"<K>td>Jam dalam am/pm (0-11) <td>Angka<td><0td>1+<</td<>tr<>th scope=<><"row"><htd>Hour in am/pm (1-12) <td>Angka<td12<>td>1+</td><tr><th scope="row"m<>td>Menit dalam jam <td>Angka<td<30>td>1+</td<>tr><th scope="row">s<td>Detik dalam menit <td>Angka<td><>551+</td><Tr><th scope="row">S<td>Milidetik <td>Angka<td>><9781+</td><tr><scope="row"z><td Zona <waktu td>>Zona<waktu umum tdPacific Standard Time>; ; GMT-08:00< PSTtd>1+</td><tr<>scope="row"Z<>td Zona <waktu td>>RFC 822 zona<waktu td td<>-0800>1+</td><tr<>scope="row"><Xtd Zona <waktu td>>ISO 8601 zona<waktu td-08>; ; -0800-08:00<huruf Pola td 24+</td></tbody<>/table<>/blockquote> biasanya diulang, karena jumlahnya menentukan presentasi yang tepat: <ul<>li><strong>"text">Text:</strong> Untuk pemformatan, jika jumlah huruf pola adalah 4 atau lebih, bentuk lengkap digunakan; jika tidak, bentuk pendek atau singkat digunakan jika tersedia.> Untuk penguraian, kedua bentuk diterima, terlepas dari jumlah huruf pola.</li li>><<strong>"number">Number:</strong> Untuk pemformatan, jumlah huruf pola adalah jumlah minimum digit, dan angka yang lebih pendek adalah nol-padded ke jumlah ini. Untuk penguraian, jumlah huruf pola diabaikan kecuali diperlukan untuk memisahkan dua bidang yang berdekatan.</li li><><strong>"year">Year:</strong> Jika formatter #getCalendar() Calendar adalah kalender Gregorian, aturan berikut diterapkan. <ul><li>Untuk pemformatan, jika jumlah huruf pola adalah 2, tahun dipotong menjadi 2 digit; jika tidak, itu ditafsirkan sebagai angka. <li>Untuk penguraian, jika jumlah huruf pola lebih dari 2, tahun ditafsirkan secara harfiah, terlepas dari jumlah digit. Jadi menggunakan pola "MM/dd/yyyy", "01/11/12" mengurai ke Jan 11, 12 A.D. <li>Untuk penguraian dengan pola tahun yang disingkat ("y" atau "yy"), SimpleDateFormat harus menafsirkan tahun yang disingkat relatif terhadap beberapa abad. Ini dilakukan dengan menyesuaikan tanggal menjadi dalam waktu 80 tahun sebelum dan 20 tahun setelah waktu SimpleDateFormat instans dibuat. Misalnya, menggunakan pola "MM/dd/yy" dan instans yang SimpleDateFormat dibuat pada 1 Jan 1997, string "01/11/12" akan ditafsirkan sebagai 11 Jan 2012 sementara string "05/04/64" akan ditafsirkan sebagai 4 Mei 1964. Selama penguraian, hanya string yang terdiri dari tepat dua digit, seperti yang didefinisikan oleh Character#isDigit(char), yang akan diuraikan ke abad default. String numerik lainnya, seperti string satu digit, string tiga digit atau lebih, atau string dua digit yang tidak semua digit (misalnya, "-1"), ditafsirkan secara harfiah. Jadi "01/02/3" atau "01/02/003" diurai, menggunakan pola yang sama, seperti Jan 2, 3 AD. Demikian juga, "01/02/-3" diurai sebagai 2 Jan 4 SM. </ul> Jika tidak, formulir spesifik sistem kalender diterapkan. Untuk pemformatan dan penguraian, jika jumlah huruf pola adalah 4 atau lebih, kalender tertentu kalender#formulir panjang digunakan. Jika tidak, kalender tertentu Kalender#PENDEK atau singkatan formulir digunakan. <br> Jika tahun 'Y' minggu ditentukan dan kalender #getCalendar() tidak mendukung tahun minggu apa pun, tahun kalender ('y') digunakan sebagai gantinya. Dukungan tahun minggu dapat diuji dengan panggilan ke DateFormat#getCalendar() getCalendar().java.util.Calendar#isWeekDateSupported() isWeekDateSupported().</li li>><<strong>"month">Month:</strong> Jika jumlah huruf pola adalah 3 atau lebih, bulan ditafsirkan sebagai teks; jika tidak, itu ditafsirkan sebagai angka. <ul><li>Letter <em>M</em> menghasilkan nama bulan yang sensitif terhadap konteks, seperti bentuk nama yang disematkan. Huruf <em>M</em> peka konteks dalam arti bahwa ketika digunakan dalam pola mandiri, misalnya, "MMMM", itu memberikan bentuk mandiri dari nama bulan dan ketika digunakan dalam pola yang berisi bidang lain, misalnya, "d MMMM", itu memberikan bentuk format nama bulan. Misalnya, Januari dalam bahasa Catalan adalah "de gener" dalam bentuk format sementara "gener" dalam bentuk mandiri. Dalam hal ini, "MMMM" akan menghasilkan "gener" dan bagian bulan dari "d MMMM" akan menghasilkan "de gener". DateFormatSymbols Jika telah ditetapkan secara eksplisit dengan konstruktor #SimpleDateFormat(String,DateFormatSymbols) atau metode #setDateFormatSymbols(DateFormatSymbols), nama bulan yang diberikan oleh DateFormatSymbols digunakan.</li><li>Letter <em>L</em> menghasilkan bentuk mandiri dari nama bulan.</li></ul><br></li li><><strong>"timezone">Zona waktu umum:</zona Waktu yang kuat> ditafsirkan sebagai teks jika memiliki nama. Untuk zona waktu yang mewakili nilai offset GMT, sintaks berikut digunakan:
<a id="GMTOffsetTimeZone"><i>GMTOffsetTimeZone:</i></a>
{@code GMT} <i>Sign</i> <i>Hours</i> {@code :} <i>Minutes</i>
<i>Sign:</i> one of
{@code + -}
<i>Hours:</i>
<i>Digit</i>
<i>Digit</i> <i>Digit</i>
<i>Minutes:</i>
<i>Digit</i> <i>Digit</i>
<i>Digit:</i> one of
{@code 0 1 2 3 4 5 6 7 8 9}
Jam harus antara 0 dan 23, dan Menit harus antara 00 dan 59. Formatnya independen lokal dan digit harus diambil dari blok Latin Dasar dari standar Unicode.
Untuk penguraian, zona waktu RFC 822 juga diterima.</li><strong><>"rfc822timezone">RFC 822 zona waktu:</strong> Untuk pemformatan, format zona waktu RFC 822 4 digit digunakan:
<i>RFC822TimeZone:</i>
<i>Sign</i> <i>TwoDigitHours</i> <i>Minutes</i>
<i>TwoDigitHours:</i>
<i>Digit Digit</i>
TwoDigitHours harus antara 00 dan 23. Definisi lain adalah sebagai untuk zona waktu umum.
Untuk penguraian, zona waktu umum juga diterima. <li><strong>"iso8601timezone">ISO 8601 Time zone:</strong> Jumlah huruf pola menunjuk format untuk pemformatan dan penguraian sebagai berikut:
<i>ISO8601TimeZone:</i>
<i>OneLetterISO8601TimeZone</i>
<i>TwoLetterISO8601TimeZone</i>
<i>ThreeLetterISO8601TimeZone</i>
<i>OneLetterISO8601TimeZone:</i>
<i>Sign</i> <i>TwoDigitHours</i>
{@code Z}
<i>TwoLetterISO8601TimeZone:</i>
<i>Sign</i> <i>TwoDigitHours</i> <i>Minutes</i>
{@code Z}
<i>ThreeLetterISO8601TimeZone:</i>
<i>Sign</i> <i>TwoDigitHours</i> {@code :} <i>Minutes</i>
{@code Z}
Definisi lain adalah sebagai untuk zona waktu umum atau zona waktu RFC 822.
Untuk pemformatan, jika nilai offset dari GMT adalah 0, "Z" diproduksi. Jika jumlah huruf pola adalah 1, pecahan jam apa pun diabaikan. Misalnya, jika polanya adalah "X" dan zona waktu adalah "GMT+05:30", "+05" diproduksi.
Untuk penguraian, huruf "Z" diurai sebagai penentu zona waktu UTC (oleh karena itu "09:30Z" diurai sebagai "09:30 UTC". Zona <>waktu umum tidak<> diterima.
Jika jumlah "X" huruf pola adalah 4 atau lebih (misalnya XXXX), IllegalArgumentException dilemparkan saat membuat SimpleDateFormat atau #applyPattern(String) menerapkan pola. </ul>SimpleDateFormat juga mendukung>< string pola< tanggal dan waktu/em> yang dilokalkan. Dalam string ini, huruf pola yang dijelaskan di atas dapat diganti dengan huruf pola dependen lokal lainnya. SimpleDateFormat tidak menangani pelokalan teks selain huruf pola; itu terserah klien kelas.
<Contoh< h3>/h3>
Contoh berikut menunjukkan bagaimana pola tanggal dan waktu ditafsirkan di lokal A.S. Tanggal dan waktu yang diberikan adalah 2001-07-04 12:08:56 waktu setempat di zona waktu Waktu Pasifik A.S. <blockquote><table class="striped"><caption style="display:none">Contoh pola tanggal dan waktu yang ditafsirkan di A.S. locale</caption><thead><tr><th scope="col" style="text-align:left">Date and Time Pattern <th scope="col" style="text-align:left">Result</thead><tr<><>th scope="row""yyyy.MM.dd G 'at' HH:mm:ss z"><td<2001.07.04 AD at 12:08:56 PDT>tr<>th scope="row">"EEE, MMM d, ''yy"<Td>Wed, Jul 4, '01<tr><th scope="row""h:mm a"><td>12:08 PM<tr<>th scope="row"><"hh 'o''clock' a, zzzz"td>12 o'clock PM, Pacific Daylight Time<tr<>th scope="row"<"K:mm a, z">td>0:08 PM, PDT<tr<>th scope="row""yyyyy.MMMMM.dd GGG hh:mm aaa"><td<>02001.July.04 AD 12:08 PMtr><th scope="row""EEE, d MMM yyyy HH:mm:ss Z"<>td><Wed, 4 Jul 2001 12:08:56 -0700tr<>th scope="row">"yyMMddHHmmssZ"<td010704120856-0700<>tr<>th scope="row""yyyy-MM-dd'T'HH:mm:ss.SSSZ"<>td>2001-07-04T12:08:56.235-0700<Tr><th scope="row">"yyyy-MM-dd'T'HH:mm:ss.SSSXXX"<td2001-07-04T12:08:56.235-07:00><tr><th scope="row""YYYY-'W'ww-u"><td><2001-W27-3/tbody<>/table></blockquote>
<h3>"synchronization">Synchronization</h3>
Format tanggal tidak disinkronkan. Disarankan untuk membuat instans format terpisah untuk setiap utas. Jika beberapa utas mengakses format secara bersamaan, maka harus disinkronkan secara eksternal.
Ditambahkan dalam 1.1.
Dokumentasi Java untuk java.text.SimpleDateFormat.
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.
Konstruktor
| SimpleDateFormat() |
Membuat |
| SimpleDateFormat(IntPtr, JniHandleOwnership) |
Konstruktor yang digunakan saat membuat representasi terkelola objek JNI; dipanggil oleh runtime. |
| SimpleDateFormat(String) |
Membuat menggunakan pola yang |
| SimpleDateFormat(String, DateFormatSymbols) |
Membuat |
| SimpleDateFormat(String, Locale) |
Membuat menggunakan pola yang |
Bidang
| AmPmField |
Konstanta yang berguna untuk perataan bidang AM_PM. (Diperoleh dari DateFormat) |
| DateField |
Konstanta yang berguna untuk perataan bidang DATE. (Diperoleh dari DateFormat) |
| DayOfWeekField |
Konstanta yang berguna untuk perataan bidang DAY_OF_WEEK. (Diperoleh dari DateFormat) |
| DayOfWeekInMonthField |
Konstanta yang berguna untuk perataan bidang DAY_OF_WEEK_IN_MONTH. (Diperoleh dari DateFormat) |
| DayOfYearField |
Konstanta yang berguna untuk perataan bidang DAY_OF_YEAR. (Diperoleh dari DateFormat) |
| Default |
Konstanta untuk pola gaya default. (Diperoleh dari DateFormat) |
| EraField |
Konstanta yang berguna untuk perataan bidang ERA. (Diperoleh dari DateFormat) |
| Full |
Konstanta untuk pola gaya penuh. (Diperoleh dari DateFormat) |
| Hour0Field |
Konstanta yang berguna untuk perataan bidang HOUR berbasis nol. (Diperoleh dari DateFormat) |
| Hour1Field |
Konstanta yang berguna untuk perataan bidang HOUR berbasis satu. (Diperoleh dari DateFormat) |
| HourOfDay0Field |
Konstanta yang berguna untuk perataan bidang HOUR_OF_DAY berbasis nol. (Diperoleh dari DateFormat) |
| HourOfDay1Field |
Konstanta yang berguna untuk perataan bidang HOUR_OF_DAY berbasis satu. (Diperoleh dari DateFormat) |
| Long |
Konstanta untuk pola gaya panjang. (Diperoleh dari DateFormat) |
| Medium |
Konstanta untuk pola gaya sedang. (Diperoleh dari DateFormat) |
| MillisecondField |
Konstanta yang berguna untuk perataan bidang MILLISECOND. (Diperoleh dari DateFormat) |
| MinuteField |
Konstanta yang berguna untuk perataan bidang MINUTE. (Diperoleh dari DateFormat) |
| MonthField |
Konstanta yang berguna untuk perataan bidang MONTH. (Diperoleh dari DateFormat) |
| SecondField |
Konstanta yang berguna untuk perataan bidang SECOND. (Diperoleh dari DateFormat) |
| Short |
Konstanta untuk pola gaya pendek. (Diperoleh dari DateFormat) |
| TimezoneField |
Konstanta yang berguna untuk perataan bidang TIMEZONE. (Diperoleh dari DateFormat) |
| WeekOfMonthField |
Konstanta yang berguna untuk perataan bidang WEEK_OF_MONTH. (Diperoleh dari DateFormat) |
| WeekOfYearField |
Konstanta yang berguna untuk perataan bidang WEEK_OF_YEAR. (Diperoleh dari DateFormat) |
| YearField |
Konstanta yang berguna untuk perataan bidang YEAR. (Diperoleh dari DateFormat) |
Properti
| Calendar |
Mendapatkan kalender yang terkait dengan pemformat tanggal/waktu ini. -or- Atur kalender yang akan digunakan oleh format tanggal ini. (Diperoleh dari DateFormat) |
| Class |
Mengembalikan kelas runtime dari . |
| DateFormatSymbols |
Mendapatkan salinan simbol format tanggal dan waktu dari format tanggal ini. -or- Mengatur simbol format tanggal dan waktu dari format tanggal ini. |
| Handle |
Handel ke instans Android yang mendasar. (Diperoleh dari Object) |
| JniIdentityHashCode |
|
| JniPeerMembers |
|
| Lenient |
Beri tahu apakah penguraian tanggal/waktu menjadi lenient. -or- Tentukan apakah penguraian tanggal/waktu akan menjadi lenient atau tidak. (Diperoleh dari DateFormat) |
| NumberFormat |
Mendapatkan formatter angka yang digunakan pemformat tanggal/waktu ini untuk memformat dan mengurai waktu. -or- Memungkinkan Anda mengatur pemformat angka. (Diperoleh dari DateFormat) |
| PeerReference |
|
| 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. |
| TimeZone |
Mendapatkan zona waktu. -or- Mengatur zona waktu untuk kalender objek ini |
Metode
| ApplyLocalizedPattern(String) |
Menerapkan string pola terlokalisasi yang diberikan ke format tanggal ini. |
| ApplyPattern(String) |
Menerapkan string pola yang diberikan ke format tanggal ini. |
| Clone() |
Membuat dan mengembalikan salinan objek ini. (Diperoleh dari _Format) |
| Dispose() |
|
| Dispose(Boolean) |
|
| Equals(Object) |
Menunjukkan apakah beberapa objek lain "sama dengan" yang satu ini. (Diperoleh dari Object) |
| Format(Date) |
Memformat |
| Format(Date, StringBuffer, FieldPosition) |
Memformat yang diberikan |
| Format(Object) |
Memformat objek untuk menghasilkan string. (Diperoleh dari _Format) |
| Format(Object, StringBuffer, FieldPosition) |
Memformat yang diberikan |
| FormatToCharacterIterator(Object) |
Memformat Objek yang |
| Get2DigitYearStart() |
Mengembalikan tanggal awal periode 100 tahun 2 digit tahun ditafsirkan sebagai berada di dalamnya. |
| GetHashCode() |
Mengembalikan nilai kode hash untuk objek . (Diperoleh dari Object) |
| 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) |
Mengurai teks dari awal string yang diberikan untuk menghasilkan tanggal. (Diperoleh dari DateFormat) |
| Parse(String, ParsePosition) |
Mengurai teks dari string untuk menghasilkan |
| ParseObject(String) |
Mengurai teks dari awal string yang diberikan untuk menghasilkan objek. (Diperoleh dari _Format) |
| ParseObject(String, ParsePosition) |
Mengurai teks dari string untuk menghasilkan |
| Set2DigitYearStart(Date) |
Menetapkan periode 100 tahun 2 digit tahun akan ditafsirkan sebagai dimulai pada tanggal yang ditentukan pengguna. |
| SetHandle(IntPtr, JniHandleOwnership) |
Handle Mengatur properti. (Diperoleh dari Object) |
| ToArray<T>() |
|
| ToLocalizedPattern() |
Mengembalikan string pola yang dilokalkan yang menjelaskan format tanggal ini. |
| ToPattern() |
Mengembalikan string pola yang menjelaskan format tanggal ini. |
| ToString() |
Mengembalikan representasi string objek. (Diperoleh dari Object) |
| UnregisterFromRuntime() |
|
| Wait() |
Menyebabkan utas saat ini menunggu sampai terbangun, biasanya dengan <diberitahu></em> atau <em>terganggu</em>. (Diperoleh dari Object) |
| Wait(Int64) |
Menyebabkan utas saat ini menunggu sampai terbangun, biasanya dengan <>diberitahu</em> atau <em>terganggu</em>, atau sampai sejumlah real time telah berlalu. (Diperoleh dari Object) |
| Wait(Int64, Int32) |
Menyebabkan utas saat ini menunggu sampai terbangun, biasanya dengan <>diberitahu</em> atau <em>terganggu</em>, atau sampai sejumlah real time telah berlalu. (Diperoleh dari Object) |
Implementasi Antarmuka Eksplisit
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.DisposeUnlessReferenced() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniManagedPeerState |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
Metode Ekstensi
| JavaCast<TResult>(IJavaObject) |
Melakukan konversi jenis yang diperiksa runtime Bahasa Umum Android. |
| JavaCast<TResult>(IJavaObject) |
|
| GetJniTypeName(IJavaPeerable) |
|