document the seconds/timestamp behavior