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 миллисекунда |
| .01 секунда | 10 миллисекунда |
| .001 секунда | 1 миллисекунда |
В .NET Framework seconds параметр округляется до ближайшей миллисекунда. В .NET 7 и более поздних версиях используется полная Double точность seconds параметра. Тем не менее, из-за присущей непреднастойности математики с плавающей запятой результирующая точность будет отличаться.
Замечание
Этот метод возвращает новый DateTimeOffset объект. Он не изменяет значение текущего объекта, добавляя seconds его к дате и времени.
DateTimeOffset Так как объект не представляет дату и время в определенном часовом поясе, AddSeconds метод не рассматривает правила корректировки определенного часового пояса при выполнении арифметики даты и времени.