Agreed on the confusing bit - the reason for the suggested change is to make the parse and generate options directly reversible.  For some reason, parse creates a key called date instead of time - didn't want to make a backwards incompatible suggestion.