Time Formatter
Use the Time Formatter to format a DateTime or TimeSpan object.
You can combine options using the pipe symbol (|), for example (less|week).)The following options are available:
| Option | Description |
|---|---|
| w week weeks |
Shows the range in weeks. You can combine two range values to form the minimum and maximum for the range. Example: (RangeMinutes) defines a range of Minutes only; (RangeHours |
| d day days |
Shows the range in days. You can combine two range values to form the minimum and maximum for the range. Example: (RangeMinutes) defines a range of Minutes only; (RangeHours |
| h hour hours |
Shows the range in hours. You can combine two range values to form the minimum and maximum for the range. Example: (RangeMinutes) defines a range of Minutes only; (RangeHours |
| m minute minutes |
Shows the range in minutes. You can combine two range values to form the minimum and maximum for the range. Example: (RangeMinutes) defines a range of Minutes only; (RangeHours |
| s second seconds |
Shows the range in seconds. You can combine two range values to form the minimum and maximum for the range. Example: (RangeMinutes) defines a range of Minutes only; (RangeHours |
| ms millisecond milliseconds |
Shows the range in milliseconds. You can combine two range values to form the minimum and maximum for the range. Example: (RangeMinutes) defines a range of Minutes only; (RangeHours |
| short | Displays the highest non-zero value within the range. Example: "00.23:00:59.000" = "23 hours" |
| auto | Displays all non-zero values within the range. Example: "00.23:00:59.000" = "23 hours 59 minutes" |
| fill | Displays the highest non-zero value and all lesser values within the range. Example: "00.23:00:59.000" = "23 hours 0 minutes 59 seconds 0 milliseconds" |
| full | Displays all values within the range. Example: "00.23:00:59.000" = "0 days 23 hours 0 minutes 59 seconds 0 milliseconds" |
| abbr | Abbreviates units. Example: "1d 2h 3m 4s 5ms" |
| noabbr | Does not abbreviate units. Example: "1 day 2 hours 3 minutes 4 seconds 5 milliseconds" |
| less | Displays "less than 1 (unit)" when the TimeSpan is smaller than the minimum range. |
| noless | Displays "0 (units)" when the TimeSpan is smaller than the minimum range. |
Note: When no options are provided, the default options that are used are: (noabbr|less|auto|seconds|days)
Note: The time values are not localized and are only available in English.
| Example Smart String | Arguments | Result |
|---|---|---|
| {0:time(abbr)} | |
451d 6h 22m 5s |
| {0:time(full)} | |
451 days 6 hours 22 minutes 5 seconds |
| {0:time(less|weeks)} | |
Less than 1 week |
| {0:time(less|d|h)} | |
1 day 6 hours |