내보내기(0) 인쇄
모두 확장
이 문서는 기계로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오. 추가 정보
번역
원본

DateTimeOffset 구조체

UTC(협정 세계시)를 기준으로 일반적으로 날짜와 시간으로 표현한 시각을 나타냅니다.

네임스페이스:  System
어셈블리:  mscorlib(mscorlib.dll)

[SerializableAttribute]
public struct DateTimeOffset : IComparable, 
	IFormattable, ISerializable, IDeserializationCallback, IComparable<DateTimeOffset>, 
	IEquatable<DateTimeOffset>

DateTimeOffset 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원DateTimeOffset(DateTime)지정된 DateTime 값을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원DateTimeOffset(DateTime, TimeSpan)지정된 DateTime 값과 오프셋을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원DateTimeOffset(Int64, TimeSpan)지정된 수의 틱과 오프셋을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)지정된 연도, 월, 일, 시, 분, 초 및 오프셋을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)지정된 연도, 월, 일, 시, 분, 초, 밀리초 및 오프셋을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.
Public 메서드DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)지정된 달력의 지정된 연도, 월, 일, 시, 분, 초, 밀리초 및 오프셋을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.
위쪽

  이름설명
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Date현재 DateTimeOffset 개체의 날짜 구성 요소를 나타내는 DateTime 값을 가져옵니다.
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원DateTime현재 DateTimeOffset 개체의 날짜와 시간을 나타내는 DateTime 값을 가져옵니다.
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Day현재 DateTimeOffset 개체가 나타내는 일을 가져옵니다.
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원DayOfWeek현재 DateTimeOffset 개체가 나타내는 요일을 가져옵니다.
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원DayOfYear현재 DateTimeOffset 개체가 나타내는 연도의 몇째 날인지 표시하는 일을 가져옵니다.
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Hour현재 DateTimeOffset 개체가 나타내는 시간의 시 구성 요소를 가져옵니다.
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원LocalDateTime현재 DateTimeOffset 개체의 현지 날짜 및 시간을 나타내는 DateTime 값을 가져옵니다.
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Millisecond현재 DateTimeOffset 개체가 나타내는 시간의 밀리초 구성 요소를 가져옵니다.
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Minute현재 DateTimeOffset 개체가 나타내는 시간의 분 구성 요소를 가져옵니다.
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Month현재 DateTimeOffset 개체가 나타내는 날짜의 월 구성 요소를 가져옵니다.
Public 속성정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원NowUTC(협정 세계시)를 기준으로 한 현지 시간의 오프셋으로 설정된 오프셋을 적용하여 현재 컴퓨터의 현재 날짜 및 시간으로 설정된 DateTimeOffset 개체를 가져옵니다.
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원OffsetUTC(협정 세계시)를 기준으로 한 해당 시간의 오프셋을 가져옵니다.
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Second현재 DateTimeOffset 개체가 나타내는 클럭 시간의 초 구성 요소를 가져옵니다.
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Ticks클럭 시간으로 현재 DateTimeOffset 개체의 날짜와 시간을 나타내는 틱 수를 가져옵니다.
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원TimeOfDay현재 DateTimeOffset 개체에 대한 하루 중 시간을 가져옵니다.
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원UtcDateTime현재 DateTimeOffset 개체의 UTC(협정 세계시) 날짜와 시간을 나타내는 DateTime값을 가져옵니다.
Public 속성정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원UtcNow해당 날짜와 시간이 현재 UTC(협정 세계시) 날짜와 시간으로 설정되어 있고 해당 오프셋이 TimeSpan.ZeroDateTimeOffset 개체를 가져옵니다.
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원UtcTicks현재 DateTimeOffset 개체의 날짜와 시간을 UTC(협정 세계시)로 표현하는 틱 수를 가져옵니다.
Public 속성이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Year현재 DateTimeOffset 개체가 나타내는 날짜의 연도 구성 요소를 가져옵니다.
위쪽

  이름설명
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Add지정된 시간 간격을 DateTimeOffset 개체에 더합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원AddDays지정된 수의 정수 및 소수 일을 현재 DateTimeOffset 개체에 더합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원AddHours지정된 수의 정수 및 소수 시간을 현재 DateTimeOffset 개체에 더합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원AddMilliseconds지정된 수의 밀리초를 현재 DateTimeOffset 개체에 더합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원AddMinutes지정된 수의 정수 및 소수 분을 현재 DateTimeOffset 개체에 더합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원AddMonths지정된 수의 개월을 현재 DateTimeOffset 개체에 더합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원AddSeconds지정된 수의 정수 및 소수 초를 현재 DateTimeOffset 개체에 더합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원AddTicks지정된 수의 틱을 현재 DateTimeOffset 개체에 더합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원AddYears지정된 연도 수를 DateTimeOffset 개체에 더합니다.
Public 메서드정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원CompareDateTimeOffset 개체를 비교하고 첫 번째 개체가 두 번째 개체보다 빠른지, 같은지, 늦은지 알려 줍니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원CompareTo현재 DateTimeOffset 개체를 지정된 DateTimeOffset 개체로 변환하고 현재 개체가 두 번째 DateTimeOffset 개체보다 빠른지, 같은지, 늦은지 알려 줍니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Equals(DateTimeOffset)현재 DateTimeOffset 개체가 나타내는 시각이 지정된 DateTimeOffset 개체와 같은지 확인합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Equals(Object) DateTimeOffset 개체가 지정된 개체와 동일한 시각을 나타내는지 확인합니다. (ValueType.Equals(Object)을(를) 재정의함)
Public 메서드정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Equals(DateTimeOffset, DateTimeOffset)지정된 두 DateTimeOffset 개체가 동일한 시각을 나타내는지 확인합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원EqualsExact현재 DateTimeOffset 개체가 지정된 DateTimeOffset 개체와 같은 시간을 나타내고 오프셋이 같은지 확인합니다.
Public 메서드정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원FromFileTime지정한 Windows 파일 시간을 해당 현지 시간으로 변환합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원GetHashCode현재 DateTimeOffset 개체에 대한 해시 코드를 반환합니다. (ValueType.GetHashCode()을(를) 재정의함)
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Public 메서드정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Parse(String)날짜, 시간 및 오프셋의 지정된 문자열 표현을 해당 DateTimeOffset으로 변환합니다.
Public 메서드정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Parse(String, IFormatProvider)지정된 문화권별 형식 정보를 사용하여 날짜 및 시간의 지정된 문자열 표현을 해당 DateTimeOffset으로 변환합니다.
Public 메서드정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Parse(String, IFormatProvider, DateTimeStyles)지정된 문화권별 형식 정보 및 형식 지정 스타일을 사용하여 날짜 및 시간의 지정된 문자열 표현을 해당 DateTimeOffset으로 변환합니다.
Public 메서드정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원ParseExact(String, String, IFormatProvider)지정된 형식 및 문화권별 형식 정보를 사용하여 날짜 및 시간의 지정된 문자열 표현을 해당 DateTimeOffset으로 변환합니다. 문자열 표현의 형식이 지정된 형식과 정확하게 일치해야 합니다.
Public 메서드정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원ParseExact(String, String, IFormatProvider, DateTimeStyles)지정된 형식, 문화권별 형식 정보 및 스타일을 사용하여 날짜 및 시간의 지정된 문자열 표현을 해당 DateTimeOffset으로 변환합니다. 문자열 표현의 형식이 지정된 형식과 정확하게 일치해야 합니다.
Public 메서드정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원ParseExact(String, String[], IFormatProvider, DateTimeStyles)지정된 형식, 문화권별 형식 정보 및 스타일을 사용하여 지정된 날짜와 시간의 문자열 표현을 해당 DateTimeOffset 표현으로 변환합니다. 문자열 표시의 형식은 지정된 형식 중 하나와 정확히 일치해야 합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Subtract(DateTimeOffset)특정 날짜와 시간을 나타내는 DateTimeOffset 값을 현재 DateTimeOffset 개체에서 뺍니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Subtract(TimeSpan)현재 DateTimeOffset 개체에서 지정된 시간 간격을 뺍니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원ToFileTime현재 DateTimeOffset 개체의 값을 Windows 파일 시간으로 변환합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원ToLocalTime현재 DateTimeOffset 개체를 현지 시간을 나타내는 DateTimeOffset 개체로 변환합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원ToOffset현재 DateTimeOffset 개체의 값을 오프셋 값으로 지정된 날짜와 시간으로 변환합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원ToString()현재 DateTimeOffset 개체의 값을 해당하는 문자열 표현으로 변환합니다. (ValueType.ToString()을(를) 재정의함)
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원ToString(IFormatProvider)지정된 문화권별 형식 정보를 사용하여 현재 DateTimeOffset 개체의 값을 해당하는 문자열 표현으로 변환합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원ToString(String)지정된 형식을 사용하여 현재 DateTimeOffset 개체의 값을 해당하는 문자열 표현으로 변환합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원ToString(String, IFormatProvider)지정된 형식 및 문화권별 형식 정보를 사용하여 현재 DateTimeOffset 개체의 값을 해당 문자열 표현으로 변환합니다.
Public 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원ToUniversalTime현재 DateTimeOffset 개체를 UTC(협정 세계시)를 나타내는 DateTimeOffset 값으로 변환합니다.
Public 메서드정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원TryParse(String, DateTimeOffset)날짜와 시간에 대한 지정된 문자열 표현을 해당 DateTimeOffset으로 변환하고, 변환에 성공했는지 여부를 나타내는 값을 반환합니다.
Public 메서드정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset)날짜와 시간에 대한 지정된 문자열 표현을 해당 DateTimeOffset으로 변환하고, 변환에 성공했는지 여부를 나타내는 값을 반환합니다.
Public 메서드정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTimeOffset)지정된 형식, 문화권별 형식 정보 및 스타일을 사용하여 날짜 및 시간의 지정된 문자열 표현을 해당 DateTimeOffset으로 변환합니다. 문자열 표현의 형식이 지정된 형식과 정확하게 일치해야 합니다.
Public 메서드정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTimeOffset)지정된 형식 배열, 문화권별 형식 정보 및 스타일을 사용하여 지정된 날짜와 시간의 문자열 표현을 해당 DateTimeOffset 표현으로 변환합니다. 문자열 표시의 형식은 지정된 형식 중 하나와 정확히 일치해야 합니다.
위쪽

  이름설명
Public 연산자정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Addition날짜와 시간이 지정된 DateTimeOffset 개체에 지정된 시간 간격을 더하고 새 날짜와 시간이 포함된 DateTimeOffset 개체를 생성합니다.
Public 연산자정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Equality지정된 두 DateTimeOffset 개체가 동일한 시각을 나타내는지 확인합니다.
Public 연산자정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원GreaterThan지정된 첫 번째 DateTimeOffset 개체가 지정된 두 번째 DateTimeOffset 개체보다 큰지(나중인지) 확인합니다.
Public 연산자정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원GreaterThanOrEqual지정된 첫 번째 DateTimeOffset 개체가 지정된 두 번째 DateTimeOffset 개체보다 크거나 같은지 확인합니다.
Public 연산자정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Implicit(DateTime to DateTimeOffset) DateTime 개체를 DateTimeOffset 개체로 변환하는 암시적 변환을 정의합니다.
Public 연산자정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Inequality지정된 두 DateTimeOffset 개체가 서로 다른 시각을 가리키는지 확인합니다.
Public 연산자정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원LessThan지정된 첫 번째 DateTimeOffset 개체가 지정된 두 번째 DateTimeOffset 개체보다 작은지 확인합니다.
Public 연산자정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원LessThanOrEqual지정된 첫 번째 DateTimeOffset 개체가 지정된 두 번째 DateTimeOffset 개체보다 작은지 확인합니다.
Public 연산자정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Subtraction(DateTimeOffset, DateTimeOffset)DateTimeOffset 개체를 다른 개체에서 빼서 시간 간격을 생성합니다.
Public 연산자정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원Subtraction(DateTimeOffset, TimeSpan)지정된 날짜와 시간에서 지정된 시간 간격을 빼서 새 날짜와 시간을 생성합니다.
위쪽

  이름설명
Public 필드정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원MaxValue DateTimeOffset 에 허용되는 가장 큰 값을 나타냅니다. 이 필드는 읽기 전용입니다.
Public 필드정적 멤버이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원MinValue DateTimeOffset 에 허용되는 가장 빠른 값을 나타냅니다. 이 필드는 읽기 전용입니다.
위쪽

  이름설명
명시적 인터페이스 구현Private 메서드이식 가능한 클래스 라이브러리에서 지원Windows 스토어 앱용 .NET에서 지원IComparable.CompareTo인프라입니다. 현재 DateTimeOffset 개체의 값을 형식이 같은 다른 개체와 비교합니다.
명시적 인터페이스 구현Private 메서드IDeserializationCallback.OnDeserialization인프라입니다. 개체의 deserialization이 완료될 때 실행됩니다.
명시적 인터페이스 구현Private 메서드ISerializable.GetObjectData인프라입니다. 현재 DateTimeOffset 개체를 serialize하는 데 필요한 데이터로 SerializationInfo 개체를 채웁니다.
위쪽

DateTimeOffset 구조체에는 DateTime 값 및 현재 DateTimeOffset 인스턴스의 날짜 및 시간과 UTC(협정 세계시) 사이의 차이를 정의하는 Offset 속성이 포함됩니다. DateTimeOffset 구조체는 UTC를 기준으로 날짜와 시간을 정확하게 정의하므로 DateTime 구조체와 달리 Kind 멤버가 포함되지 않습니다. 이 구조체는 해당 UTC가 서기 0001년 1월 1일 자정 12:00:00에서 서기 9999년 12월 31일 오후 11:59:59 사이에 속하는 값을 사용하여 날짜와 시간을 나타냅니다. (C.E.).

DateTimeOffset 값의 시간 구성 요소는 틱이라는 100나노초 단위로 측정되고, 특정 날짜는 A.D. 0001년 1월 1일 자정 12:00 이후로 틱 수입니다. GregorianCalendar 달력에서 서기 0001년 1월 1일 12:00 자정부터 경과한 틱 수입니다. DateTimeOffset 값은 항상 명시적으로 지정된 달력이나 기본 설정된 달력을 기준으로 표시됩니다. 총 틱 수에 포함되지 않는 윤초로 간주되는 틱 수입니다.

참고참고

분이나 초 같이 일부 다른 시간 간격으로 변환하려는 틱 값으로 작업 중인 경우 TimeSpan.TicksPerDay, TimeSpan.TicksPerHour, TimeSpan.TicksPerMinute, TimeSpan.TicksPerSecond 또는 TimeSpan.TicksPerMillisecond 상수를 사용하여 변환을 수행해야 합니다. 예를 들어, DateTimeOffset 값의 Second 구성 요소에 지정된 틱 수로 나타내는 시간(초)을 추가하려면 dateValue.Second + nTicks/Timespan.TicksPerSecond 식 을 사용할 수 있습니다.

DateTimeOffset 값에 오프셋이 포함되지만, 이 데이터 구조체는 시간대를 완벽하게 인식하지 않습니다. UTC를 기준으로 한 오프셋은 시간대의 특성 중 하나이지만, 이 오프셋만으로 시간대를 명확히 식별할 수는 없습니다. 여러 시간대에서 UTC를 기준으로 동일한 오프셋을 공유할 뿐만 아니라, 일광 절약 시간을 준수하는 경우 단일 시간대의 오프셋도 변경될 수 있습니다. 즉, DateTimeOffset 값과 해당 시간대 사이의 연결이 사라지면 더 이상 오프셋을 통해 원래 시간대를 모호하지 않게 역추적할 수 없습니다.

DateTimeOffset 은 구조체이므로 선언한 후 초기화하지 않은 DateTimeOffset 개체에는 각 멤버 필드에 대한 기본값이 포함됩니다. 즉, DateTime 속성이 DateTimeOffset.MinValue로 설정되고 Offset 속성이 TimeSpan.Zero로 설정됩니다.

DateTime 구조체의 오버로드된 생성자와 마찬가지로 DateTimeOffset의 생성자 오버로드 중 하나를 호출하여 새 값을 만들 수 있습니다. DateTime 값을 할당하여 새 DateTimeOffset 값을 만들 수도 있습니다. 암시적 변환이 수행되므로 C#의 경우 캐스팅 연산자가 필요하지 않고, Visual Basic의 경우 변환 메서드를 호출할 필요가 없습니다. Parse , ParseExact, TryParseTryParseExact를 비롯한 여러 가지 정적 문자열 구문 분석 메서드를 호출하여 날짜와 시간에 대한 문자열 표현을 통해 DateTimeOffset 값을 초기화할 수도 있습니다.

DateTimeOffset 구조체의 멤버는 다음과 같은 영역의 기능을 제공합니다.

  • 날짜 및 시간 산술 연산.

    특정 DateTimeOffset 값에서 날짜 또는 시간 간격을 더하거나 뺄 수 있습니다. DateTime 값을 사용한 산술 연산과 달리 DateTimeOffset 값을 사용한 산술 연산은 결과를 반환할 때 시간 오프셋의 차이에 따라 조정됩니다. 예를 들어 다음 코드에서는 DateTime 변수를 사용하여 현재 UTC 시간에서 현재 현지 시간을 뺍니다. 그런 다음 DateTimeOffset 변수를 사용하여 동일한 작업을 수행합니다. DateTime 값을 사용한 뺄셈에서는 UTC와 현지 시간대 사이의 차이를 반환하는 반면, DateTimeOffset 값을 사용한 뺄셈에서는 TimeSpan.Zero를 반환합니다.

    
    using System;
    
    public class DateArithmetic
    {
       public static void Main()
       {
          DateTime date1, date2;
          DateTimeOffset dateOffset1, dateOffset2;
          TimeSpan difference;
    
          // Find difference between Date.Now and Date.UtcNow
          date1 = DateTime.Now;
          date2 = DateTime.UtcNow;
          difference = date1 - date2;
          Console.WriteLine("{0} - {1} = {2}", date1, date2, difference);
    
          // Find difference between Now and UtcNow using DateTimeOffset
          dateOffset1 = DateTimeOffset.Now;
          dateOffset2 = DateTimeOffset.UtcNow;
          difference = dateOffset1 - dateOffset2;
          Console.WriteLine("{0} - {1} = {2}", 
                            dateOffset1, dateOffset2, difference);
          // If run in the Pacific Standard time zone on 4/2/2007, the example
          // displays the following output to the console:
          //    4/2/2007 7:23:57 PM - 4/3/2007 2:23:57 AM = -07:00:00
          //    4/2/2007 7:23:57 PM -07:00 - 4/3/2007 2:23:57 AM +00:00 = 00:00:00                        
       }
    }
    
    
    
  • 형식 변환 연산.

    DateTimeOffset 값과 DateTime 값을 상호 변환할 수 있습니다.

  • 시간 조작 및 추출 작업.

    DateTimeOffset 값의 날짜나 시간을 추출할 수 있습니다. 연도나 월 등의 특정 DateTimeOffset 구성 요소 값을 검색할 수도 있습니다.

  • 날짜 및 시간 변환.

    DateTimeOffset 값을 다른 시간대의 같은 시각을 나타내는 다른 DateTimeOffset 값으로 변환할 수 있습니다. 그러나 시간대의 조정 규칙은 DateTimeOffset 값을 현지 시간대의 날짜와 시간으로 변환하는 ToLocalTime 메서드의 경우에만 적용됩니다.

  • 날짜 및 시간 비교.

    특정 DateTimeOffset 값이 다른 DateTimeOffset 값보다 빠른지, 같은지 또는 늦은지 확인할 수 있습니다. 모든 값은 UTC로 변환된 후 비교됩니다.

.NET Framework

4.5.2, 4.5.1, 4.5, 4, 3.5 SP1, 3.0 SP1, 2.0 SP1에서 지원

.NET Framework Client Profile

4, 3.5 SP1에서 지원

이식 가능한 클래스 라이브러리

이식 가능한 클래스 라이브러리에서 지원

Windows 스토어 앱용 .NET

Windows 8에서 지원

Windows Phone 앱용 .NET

Windows Phone 8, Silverlight 8.1에서 지원

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(서버 코어 역할은 지원되지 않음), Windows Server 2008 R2(서버 코어 역할은 SP1 이상에서 지원, Itanium은 지원되지 않음)

.NET Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

커뮤니티 추가 항목

추가
표시:
© 2014 Microsoft