Свойство microsecondsSinceEpoch

Свойство microsecondsSinceEpoch класса DateTime возвращает количество микросекунд, прошедших с начала эпохи Unix - с 1 января 1970 года 00:00:00 UTC. Значение возвращается в виде целого числа типа int. Свойство не принимает параметров и доступно только для чтения. Оно учитывает как миллисекунды, так и микросекундную составляющую даты.

Синтаксис

dateTime.microsecondsSinceEpoch

Пример

Давайте получим количество микросекунд с начала эпохи для текущей даты:

void main()
{
	DateTime date = DateTime.now();
	print(date.microsecondsSinceEpoch);
}

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

1729000000000000

Пример

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

void main()
{
	DateTime date = DateTime.utc(2025, 1, 1);
	print(date.microsecondsSinceEpoch);
}

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

1735689600000000

Пример

Давайте восстановим дату из микросекунд, полученных через это свойство:

void main()
{
	DateTime date = DateTime.utc(2025, 1, 1);
	int micros = date.microsecondsSinceEpoch;
	DateTime res = DateTime.fromMicrosecondsSinceEpoch(micros, isUtc: true);
	print(res);
}

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

2025-01-01 00:00:00.000Z

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

свойство millisecondsSinceEpoch,
которое возвращает миллисекунды с начала эпохи
метод fromMicrosecondsSinceEpoch,
который создает дату из микросекунд
метод now,
который возвращает текущую дату и время
класс DateTime,
который представляет дату и время