ITemporalUnit.AddTo(Object, Int64) Metode

Definisi

Ruang nama:: Java.Time.Temporal

Rakitan:: Mono.Android.dll

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.

Mengembalikan salinan objek temporal yang ditentukan dengan periode yang ditentukan ditambahkan.

[Android.Runtime.Register("addTo", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "GetAddTo_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)]
[Java.Interop.JavaTypeParameters(new System.String[] { "R extends java.time.temporal.Temporal" })]
public Java.Lang.Object? AddTo(Java.Lang.Object? temporal, long amount);

[<Android.Runtime.Register("addTo", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "GetAddTo_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "R extends java.time.temporal.Temporal" })>]
abstract member AddTo : Java.Lang.Object * int64 -> Java.Lang.Object

Parameter

temporal: Object

objek temporal untuk disesuaikan, bukan null

amount: Int64

jumlah unit ini untuk ditambahkan, positif atau negatif

Mengembalikan

Object

objek temporal yang disesuaikan, bukan null

Atribut: RegisterAttribute JavaTypeParametersAttribute

Keterangan

Mengembalikan salinan objek temporal yang ditentukan dengan periode yang ditentukan ditambahkan.

Periode yang ditambahkan adalah kelipatan unit ini. Misalnya, metode ini dapat digunakan untuk menambahkan "3 hari" ke tanggal dengan memanggil metode ini pada instans yang mewakili "hari", melewati tanggal dan periode "3". Periode yang akan ditambahkan mungkin negatif, yang setara dengan pengurangan.

Ada dua cara yang setara untuk menggunakan metode ini. Yang pertama adalah memanggil metode ini secara langsung. Yang kedua adalah menggunakan Temporal#plus(long, TemporalUnit):

// these two lines are equivalent, but the second approach is recommended
              temporal = thisUnit.addTo(temporal);
              temporal = temporal.plus(thisUnit);

Disarankan untuk menggunakan pendekatan kedua, plus(TemporalUnit), karena jauh lebih jelas untuk dibaca dalam kode.

Implementasi harus melakukan kueri atau perhitungan apa pun menggunakan unit yang tersedia di ChronoUnit atau bidang yang tersedia di ChronoField. Jika unit tidak didukung, UnsupportedTemporalTypeException harus dilemparkan.

Implementasi tidak boleh mengubah objek temporal yang ditentukan. Sebagai gantinya, salinan yang disesuaikan dari aslinya harus dikembalikan. Ini memberikan perilaku yang setara dan aman untuk implementasi yang tidak dapat diubah dan dapat diubah.

Java dokumentasi untuk java.time.temporal.TemporalUnit.addTo(R, long).

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.

Berlaku untuk