The
inline documentation was updated in order to make note of this.
Code:
'It is best if the date is in ISO format because using other date '
'formats often causes errors because the actual date value cannot be '
'unambiguously determined. Note that the format_date_field() function '
'is both faster and more reliable. '