DateTimeOffset.MaxValue 필드

정의

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.

설명

이 상수의 값이 9999 년 12/31/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을 throw 합니다.If it is not, the method throws an ArgumentOutOfRangeException. 메서드가 MaxValue와 비교 하기 전에 DateTimeOffset 값이 UTC (협정 세계시)로 변환 됩니다.Any DateTimeOffset value is converted to Coordinated Universal Time (UTC) before the method compares it with MaxValue. 즉, 해당 날짜와 시간이 최대 범위에 근접 하지만 오프셋이 음수 인 DateTimeOffset 값은 예외를 throw 할 수 있습니다.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.

적용 대상