Class OffsetPattern
Represents a pattern for parsing and formatting Offset values.
Since 1.0.x
Availability net6.0, net8.0, netstandard2.0
Inherited Members
Namespace: NodaTime.Text
Assembly: NodaTime.dll
Syntax
public sealed class OffsetPattern : IPattern<Offset>Properties
GeneralInvariant
The "general" offset pattern (e.g. +HH, +HH:mm, +HH:mm:ss, +HH:mm:ss.fff) for the invariant culture.
Since 1.4.x
Availability net6.0, net8.0, netstandard2.0
Declaration
public static OffsetPattern GeneralInvariant { get; }Property Value
| Type | Description |
|---|---|
| OffsetPattern | The "general" offset pattern for the invariant culture. |
GeneralInvariantWithZ
The "general" offset pattern (e.g. +HH, +HH:mm, +HH:mm:ss, +HH:mm:ss.fff) for the invariant culture,
but producing (and allowing) Z as a value for a zero offset.
Since 1.4.x
Availability net6.0, net8.0, netstandard2.0
Declaration
public static OffsetPattern GeneralInvariantWithZ { get; }Property Value
| Type | Description |
|---|---|
| OffsetPattern | The "general" offset pattern for the invariant culture but producing (and allowing) Z as a value for a zero offset. |
PatternText
Gets the pattern text for this pattern, as supplied on creation.
Since 1.0.x
Availability net6.0, net8.0, netstandard2.0
Declaration
public string PatternText { get; }Property Value
| Type | Description |
|---|---|
| string | The pattern text for this pattern, as supplied on creation. |
Methods
AppendFormat(Offset, StringBuilder)
Formats the given value as text according to the rules of this pattern,
appending to the given StringBuilder.
Since 2.0.x
Availability net6.0, net8.0, netstandard2.0
Declaration
public StringBuilder AppendFormat(Offset value, StringBuilder builder)Parameters
| Type | Name | Description |
|---|---|---|
| Offset | value | The value to format. |
| StringBuilder | builder | The StringBuilder to append to. |
Returns
| Type | Description |
|---|---|
| StringBuilder | The builder passed in as builder. |
Create(string, CultureInfo)
Creates a pattern for the given pattern text and culture.
Since 1.0.x
Availability net6.0, net8.0, netstandard2.0
Declaration
public static OffsetPattern Create(string patternText, CultureInfo cultureInfo)Parameters
| Type | Name | Description |
|---|---|---|
| string | patternText | Pattern text to create the pattern for |
| CultureInfo | cultureInfo | The culture to use in the pattern |
Returns
| Type | Description |
|---|---|
| OffsetPattern | A pattern for parsing and formatting offsets. |
Remarks
See the user guide for the available pattern text options.
Exceptions
| Type | Condition |
|---|---|
| InvalidPatternException | The pattern text was invalid. |
CreateWithCurrentCulture(string)
Creates a pattern for the given pattern text in the current thread's current culture.
Since 1.0.x
Availability net6.0, net8.0, netstandard2.0
Declaration
public static OffsetPattern CreateWithCurrentCulture(string patternText)Parameters
| Type | Name | Description |
|---|---|---|
| string | patternText | Pattern text to create the pattern for |
Returns
| Type | Description |
|---|---|
| OffsetPattern | A pattern for parsing and formatting offsets. |
Remarks
See the user guide for the available pattern text options. Note that the current culture
is captured at the time this method is called - it is not captured at the point of parsing
or formatting values.
Exceptions
| Type | Condition |
|---|---|
| InvalidPatternException | The pattern text was invalid. |
CreateWithInvariantCulture(string)
Creates a pattern for the given pattern text in the invariant culture.
Since 1.0.x
Availability net6.0, net8.0, netstandard2.0
Declaration
public static OffsetPattern CreateWithInvariantCulture(string patternText)Parameters
| Type | Name | Description |
|---|---|---|
| string | patternText | Pattern text to create the pattern for |
Returns
| Type | Description |
|---|---|
| OffsetPattern | A pattern for parsing and formatting offsets. |
Remarks
See the user guide for the available pattern text options.
Exceptions
| Type | Condition |
|---|---|
| InvalidPatternException | The pattern text was invalid. |
Format(Offset)
Formats the given offset as text according to the rules of this pattern.
Since 1.0.x
Availability net6.0, net8.0, netstandard2.0
Declaration
public string Format(Offset value)Parameters
| Type | Name | Description |
|---|---|---|
| Offset | value | The offset to format. |
Returns
| Type | Description |
|---|---|
| string | The offset formatted according to this pattern. |
Parse(string)
Parses the given text value according to the rules of this pattern.
Since 1.0.x
Availability net6.0, net8.0, netstandard2.0
Declaration
public ParseResult<Offset> Parse(string text)Parameters
| Type | Name | Description |
|---|---|---|
| string | text | The text value to parse. |
Returns
| Type | Description |
|---|---|
| ParseResult<Offset> | The result of parsing, which may be successful or unsuccessful. |
Remarks
This method never throws an exception (barring a bug in Noda Time itself). Even errors such as
the argument being null are wrapped in a parse result.
WithCulture(CultureInfo)
Creates a pattern for the same original pattern text as this pattern, but with the specified
culture.
Since 1.0.x
Availability net6.0, net8.0, netstandard2.0
Declaration
public OffsetPattern WithCulture(CultureInfo cultureInfo)Parameters
| Type | Name | Description |
|---|---|---|
| CultureInfo | cultureInfo | The culture to use in the new pattern. |
Returns
| Type | Description |
|---|---|
| OffsetPattern | A new pattern with the given culture. |