DateTimeOffset.AddSeconds(Double) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает новый объект DateTimeOffset, прибавляющий заданное количество полных и неполных секунд к значению данного экземпляра.
public:
DateTimeOffset AddSeconds(double seconds);
public DateTimeOffset AddSeconds (double seconds);
member this.AddSeconds : double -> DateTimeOffset
Public Function AddSeconds (seconds As Double) As DateTimeOffset
Параметры
- seconds
- Double
Число полных и неполных секунд. Это число может быть положительным или отрицательным.
Возвращаемое значение
Объект, значение которого равно сумме даты и времени, представленных текущим объектом DateTimeOffset, и количества секунд, представленного параметром seconds
.
Исключения
Полученное DateTimeOffset значение меньше DateTimeOffset.MinValue.
-или-
Полученное DateTimeOffset значение больше DateTimeOffset.MaxValue.
Комментарии
Дробная часть seconds
параметра является дробной частью секунды. Значения дробных частей секунды показаны в следующей таблице.
Второе значение | Эквивалентный |
---|---|
.1 секунда | 100 миллисекунд |
0,01 секунда | 10 миллисекунд |
0,001 секунда | 1 миллисекунда |
В .NET 6 и более ранних версиях seconds
параметр округляется до ближайшей миллисекунды. В .NET 7 и более поздних версиях используется полная Double точность seconds
параметра. Однако из-за присущей точности математических вычислений с плавающей запятой результирующая точность будет отличаться.
Примечание
Этот метод возвращает новый DateTimeOffset объект . Он не изменяет значение текущего объекта путем добавления seconds
к его дате и времени.
DateTimeOffset Поскольку объект не представляет дату и время в определенном часовом поясе, AddSeconds метод не учитывает правила корректировки определенного часового пояса при выполнении арифметики даты и времени.