added comments to time functions