Duration.AddTo 方法

定義

命名空間:

Javax.Xml.Datatype

組件:

Mono.Android.dll

多載

AddTo(Calendar)	將這個持續時間新增至 Calendar 物件。
AddTo(Date)	將這個持續時間新增至 Date 物件。

AddTo(Calendar)

將這個持續時間新增至 Calendar 物件。

[Android.Runtime.Register("addTo", "(Ljava/util/Calendar;)V", "GetAddTo_Ljava_util_Calendar_Handler")]
public abstract void AddTo(Java.Util.Calendar? calendar);

[<Android.Runtime.Register("addTo", "(Ljava/util/Calendar;)V", "GetAddTo_Ljava_util_Calendar_Handler")>]
abstract member AddTo : Java.Util.Calendar -> unit

參數

calendar

Calendar

將修改其值的行事曆物件。

屬性

RegisterAttribute

例外狀況

NullPointerException

如果行事曆參數為 null， 則為 。

備註

將這個持續時間新增至 Calendar 物件。

如果存在這些欄位，則依年、月、天、小時、分鐘、秒和毫秒的順序呼叫 java.util.Calendar#add(int,int) 。 因為類別 Calendar 使用 int 來保存值，因此在某些情況下，這個方法將無法正確運作（例如，如果欄位的值超過 int 的範圍。）

此外，由於這個 duration 類別是公曆期間，如果指定的 Calendar 物件是以其他一些行事歷系統為基礎，這個方法將無法正常運作。

這個 Duration 物件的任何小數部分都會略過毫秒。 例如，如果此持續時間是 「P1.23456S」，則會將 1 新增至 SECONDS，234 會新增至 MILLISECONDS，其餘的將會未使用。

請注意，因為 Calendar#add(int, int) 使用 int時 Duration ，其字段中 超出範圍 int 的值會導致指定的 Calendar溢位/下溢。 XMLGregorianCalendar#add(Duration) 提供與此方法相同的基本作業，同時避免溢位/下溢問題。

的 javax.xml.datatype.Duration.addTo(java.util.Calendar)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

AddTo(Date)

將這個持續時間新增至 Date 物件。

[Android.Runtime.Register("addTo", "(Ljava/util/Date;)V", "GetAddTo_Ljava_util_Date_Handler")]
public virtual void AddTo(Java.Util.Date? date);

[<Android.Runtime.Register("addTo", "(Ljava/util/Date;)V", "GetAddTo_Ljava_util_Date_Handler")>]
abstract member AddTo : Java.Util.Date -> unit
override this.AddTo : Java.Util.Date -> unit

參數

date

Date

將修改其值的 date 物件。

屬性

RegisterAttribute

例外狀況

NullPointerException

如果 date 參數為 null， 則為 。

備註

將這個持續時間新增至 Date 物件。

指定的日期會先轉換成 java.util.GregorianCalendar，然後加入持續時間與 方法完全相同 #addTo(Calendar) 。

然後，更新的時間瞬間會轉換成 Date 物件，並用來更新指定的 Date 物件。

這有點重複的計算是明確判斷月和年持續時間的必要條件。

的 javax.xml.datatype.Duration.addTo(java.util.Date)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。