Time Offset Formats
- Last UpdatedAug 17, 2022
- 1 minute read
The supported notations for specifying a time offset are:
[ws][±][dws]hh:mm[:ss[.fff]][ws]
-OR-
[ws][±]HH:mm[:ss[.fff]][ws]
-OR-
[ws][±]d[.FF][ws]
Items in square brackets ([ and ]) are optional. Colons and periods (: and .) are literal characters.
The notation variables are as follows.
|
Item |
Description |
|---|---|
|
ws |
White space. |
|
± |
Minus sign indicating a negative time. Positive time is assumed. |
|
dws |
Days, with trailing white space. |
|
d |
Days |
|
hh |
Hours, ranging from 0 to 23. |
|
HH |
Hours of 24 or greater. |
|
mm |
Minutes, ranging from 0 to 59. |
|
ss |
Seconds, ranging from 0 to 59. |
|
fff |
Fractional seconds, from 1 to 7 decimal digits. |
|
FF |
Fractional days. |
Time offsets are shown in the application in either a short or long form:
|
Short form: |
HH:mm:ss.ff or d hh:mm:ss.fff |
|
Long form: |
d <label> hh:mm:ss.fff |
In the short form:
-
"d" is omitted for offsets less than or equal to 48 hours
-
".fff" is omitted for offsets greater than 60 seconds
-
":ss.fff" is omitted for offsets greater than 24 hours
Thus, for periods of less than 60 seconds, the short form is never longer than 11 characters. For the short form, the hours in HH format (rollover at 48 instead of 24) are shown only if days are not to be displayed anywhere on the time axis.
The "<label>" is the localized word for "days" or "day." The period (.) and colon (:) are replaced with the appropriate characters from the regional settings.