Как использовать параметр isLenient NSDateFormatter?

Question

Я не могу найти информацию об этом флаге, в StackOverflow или в другом месте в Интернете. Собственная документация Apple только говорит:

Если форматтер настроен на снисхождение, при разборе строки он использует эвристику, чтобы угадать дату, которая предназначена. Как и в случае любых догадок, это может привести к неправильной дате результата (то есть к дате, отличной от той, которая была предназначена).

Возможно, я не понимаю, как это должно работать, но я не могу заставить его работать вообще. Мое предположение было что-то вроде этого (с относительно легкой даты разбора):

> import Foundation 
> let df = DateFormatter() 
> df.isLenient = true 
> df.date(from: "12:00 1/1/2001") 
$R0: Date? = nil 

Независимо от того, что я стараюсь, я получаю ноль.

Я также вижу, что есть doesRelativeDateFormatting флаг, который претендует на поддержку таких фраз, как «сегодня» и «завтра»», но это, кажется, не делать ничего, либо:

> df.doesRelativeDateFormatting = true 
> df.date(from: "today") 
$R1: Date? = nil 

Любые идеи?

Answer 1

Вот пример, где снисходительны вариант делает разницу:

let df = DateFormatter() 
df.timeZone = TimeZone(secondsFromGMT: 0) 
df.isLenient = true 
df.dateFormat = "yyyy-MM-dd" 
print(df.date(from: "2015-02-29")) // Optional(2015-03-01 00:00:00 +0000) 

2015 не является високосным, поэтому нет февраля 29. С isLenient = true, дата интерпретируется как 1 марта С isLenient = false негодна:

let df = DateFormatter() 
df.timeZone = TimeZone(secondsFromGMT: 0) 
df.isLenient = false 
df.dateFormat = "yyyy-MM-dd" 
print(df.date(from: "2015-02-29")) // nil