Метод parse класса DateTime

Метод parse класса DateTime преобразует строку в формате ISO 8601 в объект DateTime. В первый параметр мы передаем строку с датой, которую нужно распарсить. Второй необязательный параметр задает функцию для обработки некорректных строк. Если строка имеет неверный формат, метод выбрасывает исключение FormatException.

Строка должна быть в формате ISO 8601, например '2024-01-15', '2024-01-15 10:30:00' или '2024-01-15T10:30:00Z'.

Синтаксис

DateTime.parse(formattedString, [utc])

Пример

Давайте распарсим строку с датой в формате ISO 8601:

void main()
{
	DateTime dt = DateTime.parse('2024-01-15');
	print(dt);
}

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

2024-01-15 00:00:00.000

Пример

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

void main()
{
	DateTime dt = DateTime.parse('2024-01-15 10:30:45');
	print(dt);
}

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

2024-01-15 10:30:45.000

Пример

Давайте распарсим строку с временной зоной UTC:

void main()
{
	DateTime dt = DateTime.parse('2024-01-15T10:30:45Z');
	print(dt);
	print(dt.isUtc);
}

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

2024-01-15 10:30:45.000Z
true

Пример

Давайте попробуем распарсить строку с некорректным форматом:

void main()
{
	try
	{
		DateTime dt = DateTime.parse('abcde');
		print(dt);
	}
	catch (e)
	{
		print('Error: invalid format');
	}
}

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

"Error: invalid format"

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

метод tryParse,
который безопасно парсит строку в дату
метод now,
который возвращает текущую дату и время
метод toIso8601String,
который преобразует дату в строку формата ISO 8601
класс DateTime,
который представляет дату и время