DateTime.MaxValue フィールド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
DateTime の最大有効値を表します。 このフィールドは読み取り専用です。
public: static initonly DateTime MaxValue;
public static readonly DateTime MaxValue;
staticval mutable MaxValue : DateTime
Public Shared ReadOnly MaxValue As DateTime
フィールド値
例
次の例では、コンストラクターに DateTime ティック数を表す値を Int64 渡してオブジェクトをインスタンス化します。 コンストラクターを呼び出す前に、この値が 以上 DateTime.MinValue.Ticks
で、 以下であることを確認します DateTime.MaxValue.Ticks
。 そうでない場合は、 がスローされます ArgumentOutOfRangeException。
// Attempt to assign an out-of-range value to a DateTime constructor.
long numberOfTicks = Int64.MaxValue;
DateTime validDate;
// Validate the value.
if (numberOfTicks >= DateTime.MinValue.Ticks &&
numberOfTicks <= DateTime.MaxValue.Ticks)
validDate = new DateTime(numberOfTicks);
else if (numberOfTicks < DateTime.MinValue.Ticks)
Console.WriteLine("{0:N0} is less than {1:N0} ticks.",
numberOfTicks,
DateTime.MinValue.Ticks);
else
Console.WriteLine("{0:N0} is greater than {1:N0} ticks.",
numberOfTicks,
DateTime.MaxValue.Ticks);
// The example displays the following output:
// 9,223,372,036,854,775,807 is greater than 3,155,378,975,999,999,999 ticks.
// Attempt to assign an out-of-range value to a DateTime constructor.
let numberOfTicks = Int64.MaxValue
// Validate the value.
if numberOfTicks >= DateTime.MinValue.Ticks &&
numberOfTicks <= DateTime.MaxValue.Ticks then
let validDate = DateTime numberOfTicks
()
elif numberOfTicks < DateTime.MinValue.Ticks then
printfn $"{numberOfTicks:N0} is less than {DateTime.MinValue.Ticks:N0} ticks."
else
printfn $"{numberOfTicks:N0} is greater than {DateTime.MaxValue.Ticks:N0} ticks."
// The example displays the following output:
// 9,223,372,036,854,775,807 is greater than 3,155,378,975,999,999,999 ticks.
' Attempt to assign an out-of-range value to a DateTime constructor.
Dim numberOfTicks As Long = Int64.MaxValue
Dim validDate As Date
' Validate the value.
If numberOfTicks >= Date.MinValue.Ticks And _
numberOfTicks <= Date.MaxValue.Ticks Then
validDate = New Date(numberOfTicks)
ElseIf numberOfTicks < Date.MinValue.Ticks Then
Console.WriteLine("{0:N0} is less than {1:N0} ticks.",
numberOfTicks,
DateTime.MinValue.Ticks)
Else
Console.WriteLine("{0:N0} is greater than {1:N0} ticks.",
numberOfTicks,
DateTime.MaxValue.Ticks)
End If
' The example displays the following output:
' 9,223,372,036,854,775,807 is greater than 3,155,378,975,999,999,999 ticks.
注釈
この定数の値は、グレゴリオ暦の 9999 年 12 月 31 日の 23:59:59.99999999 と等価です。100000 年 1 月 1 日の 00:00:00 UTC より前の 100 ナノ秒ティックに相当します。
などの一部のカレンダーでは ThaiBuddhistCalendar、 より MaxValue前の日付範囲がサポートされています。 このような場合、変数の割り当てまたは書式設定と解析操作で にアクセス MaxValue しようとすると、 がスローされる ArgumentOutOfRangeException可能性があります。 の DateTime.MaxValue値を取得するのではなく、 プロパティから、指定したカルチャの最新の有効な日付値の値を Calendar.MaxSupportedDateTime 取得できます。
適用対象
こちらもご覧ください
.NET