adding new attr - max time unit

adding test scenario, updating docs, updating code.