The Offset type supports the following patterns:
The following standard patterns are supported:
f: Full format, displaying all information including fractional seconds.
Typical pattern text: +HH:mm:ss.fffl: Long format, displaying information down to the second.
Typical pattern text: +HH:mm:ssm: Medium format, displaying information down to the minute.
Typical pattern text: +HH:mms: Short format, displaying information down to the hour.
Typical pattern text: +HHg: General pattern. Formatting depends on the value passed in:
G: As g, but using Z for an offset of 0, as if it were Z-prefixed. (See below.)The following custom pattern characters are supported for offsets. See custom pattern notes for general notes on custom patterns, including characters used for escaping and text literals.
| Character | Meaning | Example |
Z |
This can only occur at the start of a pattern, as a prefix to a normal pattern. When it's used, an offset of zero is always formatted as "Z", and "Z" will be parsed as a zero offset. When formatting, a non-zero offset falls back to the remainder of the pattern. When parsing, a non-Z value is always parsed by the remainder of the pattern, and a result of a zero offset is still acceptable. (So a pattern of "ZHH:mm" can still parse a value of "00:00" even though it would be formatted as "Z".) |
Zero: ZHH:mm => Z 5 hours: ZHH:mm => 05:00
|
H or HH |
Number of hours in the offset. HH is zero-padded; H is not.
|
H:mm => 7:30 HH:mm => 07:30
|
m or mm |
Number of minutes within the hour. mm is zero-padded; m is not.
|
5 minutes: m:ss => 5:00 5 minutes: mm:ss => 05:00
|
s or ss |
Number of seconds within the minute. ss is zero-padded; s is not.
|
5 seconds: s.fff => 5.000 5 seconds: ss.fff => 05.000
|
f, ff or fff |
The fractional second part of the offset, using exactly the specified number of characters. Trailing digits are truncated towards zero. |
1 second, 340 milliseconds: s.fff => 340 1 second, 340 milliseconds: s.ff => 34 1 second, 340 milliseconds: s.f => 3 |
F, FF or FFF |
The fractional second part of the offset, using at most the specified number of characters. Trailing digits are truncated towards zero, and trailing insignificant zeroes are truncated. If this comes after a decimal separator and the value is zero, the decimal separator is also truncated. |
1 second, 340 milliseconds: s.FFF => 1.34 1 second, 340 milliseconds: s.FF => 1.34 1 second, 340 milliseconds: s.F => 1.3 Exactly 1 second: s.F => 1 |
+ |
The sign of the value, always specified whether positive or negative.
The character used will depend on the format provider; + and - are
used by the invariant culture. A positive offset is used when local time is ahead of
UTC (e.g. Europe) and a negative offset is used when local time is behind UTC (e.g. America).
|
Positive value: +HH:mm => +07:30 Negative value: +HH:mm => -07:30
|
- |
The sign of the value, only specified when the value is negative.
The character used will depend on the format provider; - is
used by the invariant culture.
|
Positive value: -HH:mm => 07:30 Negative value: -HH:mm => -07:30
|
. |
This is always a period ("."); not a culture-sensitive decimal separator as one might expect. This follows the example of other standard libraries, however odd it may appear. The only difference between a period and any other literal character is that when followed by a series of "F" characters, the period will be removed if there are no fractional seconds. |
12 seconds, 500 milliseconds (en-US): ss.FFF => 12.5 12 seconds, 500 milliseconds (fr-FR): ss.FFF => 12.5
|
: |
The time separator for the format provider; colon in the invariant culture. | HH:mm => 07:30 |