Features
- Calculates time bi-directionally ie: if the date is in the past it will tell you the time since it elapsed or if it is in the future it will tell you the time left until it elapses.
- Optionally set a expiration string to be returned when the date has been reached.
- Fires a TimeCalculator.TIME_EXPIRED event when the time expires.
- Set the precision level of the return values. ( YEARS, MONTHS, DAYS, WEEKS, HOURS, MINUTES, SECONDS, MILLISECONDS ). This allows you to return values for example where the date is 1 year 2 months in the future but you don't care about the years you just want the number of months, days, hours, minutes, seconds, milliseconds till that date. ie 13 months, 30days, 23hours, 59minutes, etc...
- Individual time accessors ie get Years( ); Months( ); Days( ); etc... until the due date.
- Set labels and separators to be returned with the time strings labels( 'years', 'months' ). 01years : 01months.
- Optionally set removeEmptyTImes = false; This will display values that have no time associated with them. For example for a date 2 months in the future with a precision set to YEARS, the default return value from _timeCalculator.calculateTime( ); would be 01 : 30 : 23 : 59 : 59 : 999 with the years not being returned and the date starting at the months. However if you set removeEmptyTimes = false the return date would be 00 : 01 : 30 : 23 : 59 : 59 : 999 showing the years as 00 values.
- Turn off individual time ammounts so if you wanted just the years, months and days for a given date you can set showHours = false; This will cut the date at the Days and only return YEARS : MONTHS : DAYS.
As usual you can right click to view the source.. Any comments suggestions or errors please leave a comment.