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