Duration Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1.
[Android.Runtime.Register("javax/xml/datatype/Duration", DoNotGenerateAcw=true)]
public abstract class Duration : Java.Lang.Object[<Android.Runtime.Register("javax/xml/datatype/Duration", DoNotGenerateAcw=true)>]
type Duration = class
inherit Object- Наследование
- Атрибуты
Комментарии
Неизменяемое представление интервала времени, как определено в спецификации W3C XML Schema 1.0.
Объект Duration представляет период григорианского времени, состоящий из шести полей (года, месяцы, дни, часы, минуты и секунды) и поля знака (+/-).
Первые пять полей имеют неотрицательное (>=0) целое число или null (что означает, что поле не задано), а поле seconds имеет неотрицательную десятичную или null. Отрицательный знак указывает на отрицательную длительность.
Этот класс предоставляет ряд методов, которые упрощают использование в течение длительности типа данных СХЕМЫ XML 1.0 с errata.
<h2>Order relationship</h2>
Объекты duration имеют только частичный порядок, где два значения A и B могут быть:
<ol><li>A< B (A короче B) <li>A> B (A длиннее B) <li>A==B (A и B имеют одинаковую длительность) <li>A<>B (сравнение между A и B является неопределенным) </ol>
Например, 30 дней нельзя осмысленно сравнить с одним месяцем. Метод #compare(Duration duration) реализует эту связь.
Дополнительные сведения о связи порядка между Duration объектами #isLongerThan(Duration) см. в методе .
<h2>Операции в течение длительности</ч2>
Этот класс предоставляет набор базовых арифметических операций, таких как сложение, вычитание и умножение. Так как длительность не имеет общего порядка, операция может завершиться ошибкой для некоторых сочетаний операций. Например, нельзя вычесть 15 дней из 1 месяца. Подробные условия, в которых это может произойти, см. в javadoc этих методов.
Кроме того, не предусмотрено деление длительности на число, так как Duration класс может иметь дело только с десятичными числами конечной точности. Например, нельзя представить 1 секунду, разделенную на 3.
Однако можно заменить деление на 3 умножением на числа, например 0,3 или 0,333.
<h2>Диапазон допустимых значений</ч2>
Так как некоторые операции Duration зависят от Calendar , даже если Duration они могут содержать очень большие или очень маленькие значения, некоторые методы могут работать неправильно в таких операциях Duration. Затронутые методы документируют свою зависимость Calendarот .
Добавлено в версии 1.5.
Документация по Java для javax.xml.datatype.Duration.
Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом Android и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License.
Конструкторы
| Duration() | |
| Duration(IntPtr, JniHandleOwnership) |
Конструктор, используемый при создании управляемых представлений объектов JNI; вызывается средой выполнения. |
Свойства
| Class |
Возвращает класс среды выполнения данного объекта |
| Days |
Получает значение поля DAYS в виде целочисленного значения или 0, если оно отсутствует. |
| Handle |
Дескриптор базового экземпляра Android. (Унаследовано от Object) |
| Hours |
Получает значение поля HOURS в виде целочисленного значения или 0, если оно отсутствует. |
| JniIdentityHashCode |
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1. (Унаследовано от Object) |
| JniPeerMembers |
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1. |
| Minutes |
Получает значение поля MINUTES в виде целочисленного значения или 0, если оно отсутствует. |
| Months |
Получает значение поля MONTHS в виде целочисленного значения или 0, если оно отсутствует. |
| PeerReference |
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1. (Унаследовано от Object) |
| Seconds |
Получает значение поля SECONDS в виде целочисленного значения или 0, если оно отсутствует. |
| Sign |
Возвращает знак этой длительности в -1,0 или 1. |
| ThresholdClass |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. |
| ThresholdType |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. |
| XMLSchemaType |
Возвращает имя типа даты и времени схемы XML, с которым сопоставляется этот экземпляр. |
| Years |
Получите значение года в виде |
Методы
| Add(Duration) |
Вычисляет новую длительность со значением |
| AddTo(Calendar) |
Добавляет эту длительность к объекту |
| AddTo(Date) |
Добавляет эту длительность к объекту |
| Clone() |
Создает и возвращает копию этого объекта. (Унаследовано от Object) |
| Compare(Duration) |
Сравнение частичного порядка с данным |
| Dispose() |
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1. (Унаследовано от Object) |
| Dispose(Boolean) |
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1. (Унаследовано от Object) |
| Equals(Object) |
Указывает, равен ли какой-то другой объект этому объекту. (Унаследовано от Object) |
| GetField(DatatypeConstants+Field) |
Возвращает значение поля. |
| GetHashCode() |
Возвращает хэш-код, совместимый с определением метода equals. |
| GetTimeInMillis(Calendar) |
Возвращает длину длительности в миллисекундах. |
| GetTimeInMillis(Date) |
Возвращает длину длительности в миллисекундах. |
| IsLongerThan(Duration) |
Проверяет, является ли этот объект длительности строго длиннее другого |
| IsSet(DatatypeConstants+Field) |
Проверяет, задано ли поле. |
| IsShorterThan(Duration) |
Проверяет, является ли этот объект длительности строго короче другого |
| JavaFinalize() |
Вызывается сборщиком мусора для объекта , когда сборка мусора определяет, что больше нет ссылок на объект . (Унаследовано от Object) |
| Multiply(BigDecimal) |
Вычисляет новую длительность, значение которой в |
| Multiply(Int32) |
Вычисляет новую длительность, значение которой в |
| Negate() |
Возвращает новый |
| NormalizeWith(Calendar) |
Преобразует поля лет и месяцев в поле дней, используя определенный момент времени в качестве точки отсчета. |
| Notify() |
Пробуждает один поток, ожидающий монитора этого объекта. (Унаследовано от Object) |
| NotifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. (Унаследовано от Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
Задает свойство Handle. (Унаследовано от Object) |
| Subtract(Duration) |
Вычисляет новую длительность со значением |
| ToArray<T>() |
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1. (Унаследовано от Object) |
| ToString() |
Возвращает строковое представление объекта. (Унаследовано от Object) |
| UnregisterFromRuntime() |
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1. (Унаследовано от Object) |
| Wait() |
Вызывает ожидание текущего потока, пока он не пробудится, как правило, из-за <уведомления><<> или>прерывания или прерывания.>< (Унаследовано от Object) |
| Wait(Int64) |
Вызывает ожидание текущего потока, пока он не пробудится, как правило, путем <уведомления><<> или>прерывания или прерывания<> или до истечения определенного количества реального времени. (Унаследовано от Object) |
| Wait(Int64, Int32) |
Вызывает ожидание текущего потока, пока он не пробудится, как правило, путем <уведомления><<> или>прерывания или прерывания<> или до истечения определенного количества реального времени. (Унаследовано от Object) |
Явные реализации интерфейса
| IJavaPeerable.Disposed() |
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1. (Унаследовано от Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1. (Унаследовано от Object) |
| IJavaPeerable.Finalized() |
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1. (Унаследовано от Object) |
| IJavaPeerable.JniManagedPeerState |
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1. (Унаследовано от Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1. (Унаследовано от Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1. (Унаследовано от Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1. (Унаследовано от Object) |
Методы расширения
| JavaCast<TResult>(IJavaObject) |
Выполняет преобразование типа, проверенного средой выполнения Android. |
| JavaCast<TResult>(IJavaObject) |
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1. |
| GetJniTypeName(IJavaPeerable) |
Неизменяемое представление интервала времени, как определено в схеме W3C XML 1. |