updated time handling and documentation