Поделиться через


Duration.AddTo Метод

Определение

Перегрузки

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

Объект календаря, значение которого будет изменено.

Атрибуты

Исключения

Значение NULL, если параметр календаря имеет значение NULL.

Комментарии

Добавляет эту длительность в Calendar объект.

Вызовы java.util.Calendar#add(int,int) в порядке ЛЕТ, МЕСЯЦЕВ, ДНЕЙ, ЧАСОВ, МИНУТ, СЕКУНД и МИЛЛИСЕКУНД, если эти поля присутствуют. Calendar Так как класс использует int для хранения значений, существуют случаи, когда этот метод не будет работать правильно (например, если значения полей превышают диапазон int.)

Кроме того, так как этот класс длительности является григорианской длительностью, этот метод не будет работать правильно, если данный Calendar объект основан на некоторых других системах календаря.

Любые дробные части этого Duration объекта за миллисекундами будут просто игнорироваться. Например, если эта длительность — P1.23456S, то 1 добавляется в СЕКУНДы, 234 добавляется в МИЛЛИСЕКУНДЫ, а остальные будут неиспользуются.

Обратите внимание, что поскольку используется int, Duration со значениями, превышающими диапазон int в его полях, приведет к переполнению или переполнению заданного значенияCalendar.Calendar#add(int, int) XMLGregorianCalendar#add(Duration) предоставляет ту же базовую операцию, что и этот метод, избегая проблем переполнения или переполнения.

Документация по Java для javax.xml.datatype.Duration.addTo(java.util.Calendar).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

Применяется к

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, значение которого будет изменено.

Атрибуты

Исключения

Значение NULL, если параметр даты имеет значение NULL.

Комментарии

Добавляет эту длительность в Date объект.

Указанная дата сначала преобразуется в объект java.util.GregorianCalendar, а длительность добавляется точно так же, как #addTo(Calendar) и метод.

Затем обновленный момент времени преобразуется обратно в Date объект и используется для обновления данного Date объекта.

Это несколько избыточных вычислений необходимо однозначно определить продолжительность месяцев и лет.

Документация по Java для javax.xml.datatype.Duration.addTo(java.util.Date).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

Применяется к