DateTimeOffset.MaxValue DateTimeOffset.MaxValue DateTimeOffset.MaxValue DateTimeOffset.MaxValue Field

定義

DateTimeOffset の最大有効値を表します。Represents the greatest possible value of DateTimeOffset. このフィールドは読み取り専用です。This field is read-only.

public: static initonly DateTimeOffset MaxValue;
public static readonly DateTimeOffset MaxValue;
 staticval mutable MaxValue : DateTimeOffset
Public Shared ReadOnly MaxValue As DateTimeOffset 

フィールド値

例外

MaxValue が、現在または指定したカルチャの既定の暦の範囲外です。MaxValue is outside the range of the current or specified culture's default calendar.

注釈

この定数の値は 12/31/9999 11:59:59 PM + 00:00 です。The value of this constant is 12/31/9999 11:59:59 PM +00:00.

プロパティMaxValueは、新しいDateTimeOffsetオブジェクトの値またDateTimeOffsetは算術演算によって返される値が、この最大範囲の値と同じかそれ以前であるかを判断するために使用されます。The MaxValue property is used to determine whether the value of a new DateTimeOffset object or the DateTimeOffset value returned by an arithmetic operation is the same as or earlier than this maximum range value. そうでない場合、メソッドはをスロー ArgumentOutOfRangeExceptionします。If it is not, the method throws an ArgumentOutOfRangeException. 値は、メソッドがとMaxValue比較する前に、世界協定時刻 (UTC) に変換されます。 DateTimeOffsetAny DateTimeOffset value is converted to Coordinated Universal Time (UTC) before the method compares it with MaxValue. これは、日付DateTimeOffsetと時刻が最大範囲に近いが、オフセットが負である値が例外をスローする可能性があることを意味します。This means that a DateTimeOffset value whose date and time are close to the maximum range, but whose offset is negative, may throw an exception. たとえば、値 12/31/9999 11:00 PM-02:00 は、UTC に変換されたときよりMaxValue 1 時間後であるため、範囲外です。For example, the value 12/31/9999 11:00 PM -02:00 is out of range because it is one hour later than MaxValue when it is converted to UTC.

などの一部のカレンダーでUmAlQuraCalendarは、よりもMaxValue前の日付の範囲がサポートされています。Some calendars, such as the UmAlQuraCalendar, support an upper date range that is earlier than MaxValue. このような場合は、変数MaxValueの代入や書式設定および解析操作でにアクセスArgumentOutOfRangeExceptionしようとすると、がスローされることがあります。In these cases, trying to access MaxValue in variable assignments or formatting and parsing operations can throw an ArgumentOutOfRangeException. DateTime.MaxValue値を取得する代わりに、指定したカルチャの有効な日付値の値をCalendar.MaxSupportedDateTimeプロパティから取得できます。Instead of retrieving the value of DateTime.MaxValue, you can retrieve the value of the specified culture's latest valid date value from the Calendar.MaxSupportedDateTime property.

適用対象