Метод plusMillis

Метод plusMillis класса Instant возвращает новый объект Instant, представляющий момент времени, увеличенный на заданное количество миллисекунд. Исходный объект при этом не изменяется, так как класс Instant является неизменяемым. В параметр метода мы передаем количество миллисекунд, которое нужно прибавить к текущему моменту времени. Если переданное значение отрицательное, результат будет эквивалентен вычитанию миллисекунд.

Синтаксис

instant.plusMillis(millisToAdd)

Пример

Давайте создадим момент времени из 1000 миллисекунд эпохи и прибавим к нему 500 миллисекунд:

import java.time.Instant;

public class Main
{
	public static void main(String[] args)
	{
		Instant instant = Instant.ofEpochMilli(1000);
		Instant res = instant.plusMillis(500);
		System.out.println(res.toEpochMilli());
	}
}

Результат выполнения кода:

1500

Пример

Давайте прибавим отрицательное количество миллисекунд, что приведет к уменьшению момента времени:

import java.time.Instant;

public class Main
{
	public static void main(String[] args)
	{
		Instant instant = Instant.ofEpochMilli(1000);
		Instant res = instant.plusMillis(-300);
		System.out.println(res.toEpochMilli());
	}
}

Результат выполнения кода:

700

Пример

Давайте прибавим миллисекунды к текущему моменту времени, полученному с помощью метода now:

import java.time.Instant;

public class Main
{
	public static void main(String[] args)
	{
		Instant now = Instant.now();
		Instant res = now.plusMillis(10000);
		System.out.println(now.toEpochMilli());
		System.out.println(res.toEpochMilli());
	}
}

Результат выполнения кода (значения зависят от текущего времени):

1690000000000
1690000010000

Смотрите также

класс Instant,
который представляет момент времени
метод minusMillis,
который вычитает миллисекунды
метод toEpochMilli,
который возвращает миллисекунды эпохи
метод ofEpochMilli,
который создает Instant из миллисекунд