DateTimeOffset.MaxValue Mező

Definíció

A lehető legnagyobb értéket DateTimeOffsetjelöli. Ez a mező csak olvasható.

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

Mező értéke

Kivételek

A DateTime.MaxValue kívül esik az aktuális vagy a megadott kultúra alapértelmezett naptárának tartományán.

Megjegyzések

Ennek az állandónak az értéke 9999. 12. 31. 11:59:59 +00:00.

A MaxValue tulajdonság annak meghatározására szolgál, hogy egy új DateTimeOffset objektum vagy egy DateTimeOffset számtani művelet által visszaadott érték megegyezik-e a maximális tartomány értékével vagy korábbi értékével. Ha nem, a metódus egy ArgumentOutOfRangeException. Minden DateTimeOffset érték konvertálva lesz az egyezményes világidővé (UTC), mielőtt a metódus összehasonlítja azt a MaxValue. Ez azt jelenti, hogy egy DateTimeOffset olyan érték, amelynek dátuma és ideje megközelíti a maximális tartományt, de az eltolás negatív, kivételt okozhat. Például a 12/31/9999 11:00 –02:00 érték túllépi a tartományt, mert egy órával később van, mint MaxValue amikor UTC-vé konvertálják.

Egyes naptárak, például a UmAlQuraCalendarfelső dátumtartományok támogatják a korábbi dátumtartományt MaxValue. Ezekben az esetekben a változó-hozzárendelésekben vagy formázási és elemzési műveletekben való hozzáférés MaxValue megkísérlése dobhat egy ArgumentOutOfRangeException. Az érték beolvasása DateTime.MaxValuehelyett lekérheti a megadott kultúra legújabb érvényes dátumértékének értékét a Calendar.MaxSupportedDateTime tulajdonságból.

A következőre érvényes: