Explain the difference between format() and other methods in Time

[lorenzo]

The format from ICU is only valid for the methods that output locale-aware strings, but some people try to use format() as if it were ICU aware.

Refs cakephp/cakephp#6137

[markstory]

Should format() also accept ICU constants?

[lorenzo]

that would be even more confusing, imo

[markstory]

Ok.

[markstory]

Closing this as the original issue was for TimeHelper which aliases format() to be the i18nFormat method. This is a bit silly, but TimeHelper has always been a bit silly. I'll update the relevant doc block on TimeHelper instead.