Duration.AddTo Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
AddTo(Calendar) |
Добавляет эту длительность в |
AddTo(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.