improved phpdocs for time diff methods