Support is_dst indicators in tz_localize

The indicators are useful for assigning the correct offset when there are ambiguous transition times closes #7943.
add a link to the new doc section as well