Метод isAtSameMomentAs

Метод isAtSameMomentAs класса DateTime проверяет, указывают ли текущий объект даты и переданный объект даты на один и тот же момент времени. В параметр мы передаем вторую дату для сравнения. Метод возвращает true, если моменты времени совпадают, и false в противном случае. При сравнении учитывается часовой пояс: два объекта, описывающие одно и то же мгновение, но в разных зонах, считаются равными.

Синтаксис

dateTime.isAtSameMomentAs(other)

Пример

Давайте сравним две одинаковые даты:

void main()
{
	DateTime date1 = DateTime(2025, 12, 31, 23, 59, 59);
	DateTime date2 = DateTime(2025, 12, 31, 23, 59, 59);
	
	print(date1.isAtSameMomentAs(date2));
}

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

true

Пример

Давайте сравним две разные даты, отличающиеся на одну секунду:

void main()
{
	DateTime date1 = DateTime(2025, 12, 31, 23, 59, 59);
	DateTime date2 = DateTime(2025, 12, 31, 23, 59, 58);
	
	print(date1.isAtSameMomentAs(date2));
}

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

false

Пример

Давайте сравним одно и то же мгновение, записанное в UTC и в локальном времени:

void main()
{
	DateTime utc = DateTime.utc(2025, 12, 31, 12, 0, 0);
	DateTime local = DateTime(2025, 12, 31, 12, 0, 0).toUtc();
	
	print(utc.isAtSameMomentAs(local));
}

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

true

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

метод isBefore,
который проверяет, что дата раньше другой
метод isAfter,
который проверяет, что дата позже другой
метод difference,
который возвращает разницу между датами
метод compareTo,
который сравнивает две даты