DateTimeOffset.MaxValue Pole

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Zdroj:

DateTimeOffset.cs

Představuje nejvyšší možnou hodnotu .DateTimeOffset Toto pole je jen ke čtení.

public: static initonly DateTimeOffset MaxValue;

public static readonly DateTimeOffset MaxValue;

 staticval mutable MaxValue : DateTimeOffset

Public Shared ReadOnly MaxValue As DateTimeOffset 

Hodnota pole

DateTimeOffset

Výjimky

ArgumentOutOfRangeException

DateTime.MaxValue je mimo rozsah výchozího kalendáře aktuální nebo zadané jazykové verze.

Poznámky

Hodnota této konstanty je 31.12.9999 23:59:59 +00:00.

Vlastnost MaxValue se používá k určení, zda hodnota nového DateTimeOffset objektu nebo DateTimeOffset hodnota vrácená aritmetickou operací je stejná jako nebo dřívější než tato maximální hodnota rozsahu. Pokud tomu tak není, metoda vyvolá .ArgumentOutOfRangeException Jakákoli DateTimeOffset hodnota je převedena na standard UTC (Coordinated Universal Time) před tím, než ji metoda porovná s MaxValue. To znamená, že DateTimeOffset hodnota, jejíž datum a čas se blíží maximálnímu rozsahu, ale jejíž posun je záporný, může vyvolat výjimku. Například hodnota 31.12.9999 23:00 -02:00 je mimo rozsah, protože je o hodinu pozdější než MaxValue při převodu na UTC.

Některé kalendáře, například UmAlQuraCalendar, podporují horní rozsah kalendářních dat, který je starší než MaxValue. V těchto případech může pokus o přístup MaxValue k přiřazení proměnných nebo operací formátování a parsování vyvolat výjimku ArgumentOutOfRangeException. Místo načtení hodnoty DateTime.MaxValuemůžete z Calendar.MaxSupportedDateTime vlastnosti načíst hodnotu poslední platné hodnoty data pro zadanou jazykovou verzi.