DateTimeOffset DateTimeOffset DateTimeOffset DateTimeOffset Constructors

정의

오버로드

DateTimeOffset(DateTime) DateTimeOffset(DateTime) DateTimeOffset(DateTime)

지정된 DateTime 값을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the DateTimeOffset structure using the specified DateTime value.

DateTimeOffset(DateTime, TimeSpan) DateTimeOffset(DateTime, TimeSpan) DateTimeOffset(DateTime, TimeSpan)

지정된 DateTime 값과 오프셋을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the DateTimeOffset structure using the specified DateTime value and offset.

DateTimeOffset(Int64, TimeSpan) DateTimeOffset(Int64, TimeSpan) DateTimeOffset(Int64, TimeSpan) DateTimeOffset(Int64, TimeSpan)

지정된 수의 틱과 오프셋을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the DateTimeOffset structure using the specified number of ticks and offset.

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

지정된 연도, 월, 일, 시, 분, 초 및 오프셋을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, and offset.

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

지정된 연도, 월, 일, 시, 분, 초, 밀리초 및 오프셋을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and offset.

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)

지정된 달력의 지정된 연도, 월, 일, 시, 분, 초, 밀리초 및 오프셋을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and offset of a specified calendar.

DateTimeOffset(DateTime) DateTimeOffset(DateTime) DateTimeOffset(DateTime)

지정된 DateTime 값을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the DateTimeOffset structure using the specified DateTime value.

public:
 DateTimeOffset(DateTime dateTime);
public DateTimeOffset (DateTime dateTime);
new DateTimeOffset : DateTime -> DateTimeOffset

매개 변수

dateTime
DateTime DateTime DateTime DateTime

날짜와 시간입니다.A date and time.

예외

오프셋을 적용한 결과인 UTC(협정 세계시) 날짜 및 시간이 MinValue보다 빠릅니다.The Coordinated Universal Time (UTC) date and time that results from applying the offset is earlier than MinValue.

또는-or- 오프셋을 적용한 결과인 UTC 날짜 및 시간이 MaxValue보다 늦습니다.The UTC date and time that results from applying the offset is later than MaxValue.

예제

다음 예제에서는 어떻게 값을 DateTime.Kind 속성의는 dateTime 매개 변수는이 생성자에 의해 반환 되는 날짜 및 시간 값에 영향을 줍니다.The following example illustrates how the value of the DateTime.Kind property of the dateTime parameter affects the date and time value that is returned by this constructor.

DateTime localNow = DateTime.Now;
DateTimeOffset localOffset = new DateTimeOffset(localNow);
Console.WriteLine(localOffset.ToString());

DateTime utcNow = DateTime.UtcNow;
DateTimeOffset utcOffset = new DateTimeOffset(utcNow);
Console.WriteLine(utcOffset.ToString());

DateTime unspecifiedNow = DateTime.SpecifyKind(DateTime.Now, 
                               DateTimeKind.Unspecified);
DateTimeOffset unspecifiedOffset = new DateTimeOffset(unspecifiedNow);
Console.WriteLine(unspecifiedOffset.ToString());
//
// The code produces the following output if run on Feb. 23, 2007, on
// a system 8 hours earlier than UTC:
//   2/23/2007 4:21:58 PM -08:00
//   2/24/2007 12:21:58 AM +00:00
//   2/23/2007 4:21:58 PM -08:00      
Dim localNow As Date = Date.Now
Dim localOffset As New DateTimeOffset(localNow)
Console.WriteLine(localOffset.ToString())

Dim utcNow As Date = Date.UtcNow
Dim utcOffset As New DateTimeOffset(utcNow)
Console.WriteLine(utcOffset.ToString())

Dim unspecifiedNow As Date = Date.SpecifyKind(Date.Now, _
                                  DateTimeKind.Unspecified)
Dim unspecifiedOffset As New DateTimeOffset(unspecifiedNow)
Console.WriteLine(unspecifiedOffset.ToString())
'
' The code produces the following output if run on Feb. 23, 2007, on
' a system 8 hours earlier than UTC:
'    2/23/2007 4:21:58 PM -08:00
'    2/24/2007 12:21:58 AM +00:00
'    2/23/2007 4:21:58 PM -08:00      

설명

이 생성자의이 동작의 값에 따라 달라 집니다 합니다 DateTime.Kind 의 속성을 dateTime 매개 변수:This constructor's behavior depends on the value of the DateTime.Kind property of the dateTime parameter:

추가 정보

DateTimeOffset(DateTime, TimeSpan) DateTimeOffset(DateTime, TimeSpan) DateTimeOffset(DateTime, TimeSpan)

지정된 DateTime 값과 오프셋을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the DateTimeOffset structure using the specified DateTime value and offset.

public:
 DateTimeOffset(DateTime dateTime, TimeSpan offset);
public DateTimeOffset (DateTime dateTime, TimeSpan offset);
new DateTimeOffset : DateTime * TimeSpan -> DateTimeOffset

매개 변수

dateTime
DateTime DateTime DateTime DateTime

날짜와 시간입니다.A date and time.

offset
TimeSpan TimeSpan TimeSpan TimeSpan

UTC(협정 세계시)를 기준으로 해당 시간의 오프셋입니다.The time's offset from Coordinated Universal Time (UTC).

예외

dateTime.KindUtc와 같고 offset은 0과 같지 않습니다.dateTime.Kind equals Utc and offset does not equal zero.

또는-or- dateTime.KindLocal과 같고 offset은 시스템의 현지 표준 시간대 오프셋과 같지 않습니다.dateTime.Kind equals Local and offset does not equal the offset of the system's local time zone.

또는-or- offset 이 전체 분 내에서 지정되지 않았습니다.offset is not specified in whole minutes.

offset 이 -14시간보다 작거나 14시간보다 큽니다.offset is less than -14 hours or greater than 14 hours.

또는-or- UtcDateTimeMinValue보다 작거나 MaxValue보다 큽니다.UtcDateTime is less than MinValue or greater than MaxValue.

예제

다음 예제에서는 초기화 하는 방법을 보여 줍니다는 DateTimeOffset 날짜 및 시간과 표준 시간대는 사전에 알려지지 않은 경우 현지 표준 시간대의 오프셋을 사용 하 여 개체입니다.The following example shows how to initialize a DateTimeOffset object with a date and time and the offset of the local time zone when that time zone is not known in advance.

DateTime localTime = new DateTime(2007, 07, 12, 06, 32, 00); 
DateTimeOffset dateAndOffset = new DateTimeOffset(localTime, 
                         TimeZoneInfo.Local.GetUtcOffset(localTime));
Console.WriteLine(dateAndOffset);
// The code produces the following output:
//    7/12/2007 6:32:00 AM -07:00
Dim localTime As Date = #07/12/2007 6:32AM#
Dim dateAndOffset As New DateTimeOffset(localTime, _
                         TimeZoneInfo.Local.GetUtcOffset(localTime))
Console.WriteLine(dateAndOffset)
' The code produces the following output:
'    7/12/2007 6:32:00 AM -07:00

설명

이 생성자의이 동작은 부분적 값에는 Kind 의 속성을 dateTime 매개 변수:This constructor's behavior depends in part on the value of the Kind property of the dateTime parameter:

추가 정보

DateTimeOffset(Int64, TimeSpan) DateTimeOffset(Int64, TimeSpan) DateTimeOffset(Int64, TimeSpan) DateTimeOffset(Int64, TimeSpan)

지정된 수의 틱과 오프셋을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the DateTimeOffset structure using the specified number of ticks and offset.

public:
 DateTimeOffset(long ticks, TimeSpan offset);
public DateTimeOffset (long ticks, TimeSpan offset);
new DateTimeOffset : int64 * TimeSpan -> DateTimeOffset
Public Sub New (ticks As Long, offset As TimeSpan)

매개 변수

ticks
Int64 Int64 Int64 Int64

0001년 1월 1일 자정 12시 00분 00초부터 경과한 100나노초 간격의 수로 표현한 날짜와 시간입니다.A date and time expressed as the number of 100-nanosecond intervals that have elapsed since 12:00:00 midnight on January 1, 0001.

offset
TimeSpan TimeSpan TimeSpan TimeSpan

UTC(협정 세계시)를 기준으로 해당 시간의 오프셋입니다.The time's offset from Coordinated Universal Time (UTC).

예외

offset이 전체 분 내에서 지정되지 않았습니다.offset is not specified in whole minutes.

UtcDateTime 속성이 MinValue 이전이거나 MaxValue 이후입니다.The UtcDateTime property is earlier than MinValue or later than MaxValue.

또는-or- ticksDateTimeOffset.MinValue.Ticks보다 작거나 DateTimeOffset.MaxValue.Ticks보다 큽니다.ticks is less than DateTimeOffset.MinValue.Ticks or greater than DateTimeOffset.MaxValue.Ticks.

또는-or- Offset이 -14시간보다 작거나 14시간보다 큽니다.Offset s less than -14 hours or greater than 14 hours.

예제

다음 예제에서는 초기화를 DateTimeOffset 오프셋을-5 사용 하 여 (이 예제의 경우 2007 년 7 월 16 일 오후 1 시 32 분)에 임의의 날짜에서 틱 수를 사용 하 여 개체입니다.The following example initializes a DateTimeOffset object by using the number of ticks in an arbitrary date (in this case, July 16, 2007, at 1:32 PM) with an offset of -5.

DateTime dateWithoutOffset = new DateTime(2007, 7, 16, 13, 32, 00);
DateTimeOffset timeFromTicks = new DateTimeOffset(dateWithoutOffset.Ticks, 
                               new TimeSpan(-5, 0, 0));
Console.WriteLine(timeFromTicks.ToString());
// The code produces the following output:
//    7/16/2007 1:32:00 PM -05:00
Dim dateWithoutOffset As Date = #07/16/2007 1:32PM#
Dim timeFromTicks As New DateTimeOffset(datewithoutOffset.Ticks, _
                         New TimeSpan(-5, 0, 0))
Console.WriteLine(timeFromTicks.ToString())
' The code produces the following output:
'    7/16/2007 1:32:00 PM -05:00

설명

일반적으로 호출 하는 동안 합니다 DateTimeOffset 인스턴스화하는 생성자를 DateTimeOffset 현지 시간의 영역 throw 하는 이외의 현지 시간 및 오프셋을 사용 하 여 값을 ArgumentException.Ordinarily, trying to call the DateTimeOffset constructor to instantiate a DateTimeOffset value with a local time and an offset other than that of the local time zone throws an ArgumentException. 이 오버 로드를 사용할 수는 DateTimeOffset 이 제한을 해결 하는 생성자입니다.You can use this overload of the DateTimeOffset constructor to work around this limitation. 다음 예제에서는 현지 시간의 틱 수를 사용 하 여 인스턴스화하는 DateTimeOffset 오프셋 나타내지는지 않습니다 현지 시간을 하는 값:The following example uses the local time's number of ticks to instantiate a DateTimeOffset value whose offset does not necessarily represent that of the local time:

DateTime localTime = DateTime.Now;
DateTimeOffset nonLocalDateWithOffset = new DateTimeOffset(localTime.Ticks, 
                                  new TimeSpan(2, 0, 0));
Console.WriteLine(nonLocalDateWithOffset); 
//
// The code produces the following output if run on Feb. 23, 2007:
//    2/23/2007 4:37:50 PM +02:00
Dim localTime As Date = Date.Now
Dim nonLocalDateWithOffset As New DateTimeOffset(localTime.Ticks, _
                                  New TimeSpan(2, 0, 0))
Console.WriteLine(nonLocalDateWithOffset)                                        
'
' The code produces the following output if run on Feb. 23, 2007:
'    2/23/2007 4:37:50 PM +02:00
추가 정보

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

지정된 연도, 월, 일, 시, 분, 초 및 오프셋을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, and offset.

public:
 DateTimeOffset(int year, int month, int day, int hour, int minute, int second, TimeSpan offset);
public DateTimeOffset (int year, int month, int day, int hour, int minute, int second, TimeSpan offset);
new DateTimeOffset : int * int * int * int * int * int * TimeSpan -> DateTimeOffset
Public Sub New (year As Integer, month As Integer, day As Integer, hour As Integer, minute As Integer, second As Integer, offset As TimeSpan)

매개 변수

year
Int32 Int32 Int32 Int32

연도(1부터 9999까지)The year (1 through 9999).

month
Int32 Int32 Int32 Int32

월(1부터 12까지)The month (1 through 12).

day
Int32 Int32 Int32 Int32

일(1부터 month에 있는 일수까지)The day (1 through the number of days in month).

hour
Int32 Int32 Int32 Int32

시(0부터 23까지)The hours (0 through 23).

minute
Int32 Int32 Int32 Int32

분(0부터 59까지)The minutes (0 through 59).

second
Int32 Int32 Int32 Int32

초(0부터 59까지)The seconds (0 through 59).

offset
TimeSpan TimeSpan TimeSpan TimeSpan

UTC(협정 세계시)를 기준으로 해당 시간의 오프셋입니다.The time's offset from Coordinated Universal Time (UTC).

예외

offset이 전체 시간(분)을 표시하지 않습니다.offset does not represent whole minutes.

year가 1보다 작거나 9999보다 큽니다.year is less than one or greater than 9999.

또는-or- month가 1보다 작거나 12보다 큽니다.month is less than one or greater than 12.

또는-or- day가 1보다 작거나 month의 일 수보다 큽니다.day is less than one or greater than the number of days in month.

또는-or- hour가 0보다 작거나 23보다 큽니다.hour is less than zero or greater than 23.

또는-or- minute가 0보다 작거나 59보다 큽니다.minute is less than 0 or greater than 59.

또는-or- second가 0보다 작거나 59보다 큽니다.second is less than 0 or greater than 59.

또는-or- offset이 -14시간보다 작거나 14시간보다 큽니다.offset is less than -14 hours or greater than 14 hours.

또는-or- UtcDateTime 속성이 MinValue 이전이거나 MaxValue 이후입니다.The UtcDateTime property is earlier than MinValue or later than MaxValue.

예제

다음 예제에서는 한 DateTimeOffset 사용 하 여 개체를 DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) 생성자 오버 로드 합니다.The following example instantiates a DateTimeOffset object by using the DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) constructor overload.

   DateTime specificDate = new DateTime(2008, 5, 1, 06, 32, 00); 
   DateTimeOffset offsetDate = new DateTimeOffset(specificDate.Year, 
                                   specificDate.Month, 
                                   specificDate.Day, 
                                   specificDate.Hour, 
                                   specificDate.Minute, 
                                   specificDate.Second, 
                                   new TimeSpan(-5, 0, 0));
   Console.WriteLine("Current time: {0}", offsetDate);
   Console.WriteLine("Corresponding UTC time: {0}", offsetDate.UtcDateTime);                                              
// The code produces the following output:
//    Current time: 5/1/2008 6:32:00 AM -05:00
//    Corresponding UTC time: 5/1/2008 11:32:00 AM      
   Dim specificDate As Date = #5/1/2008 6:32AM#
   Dim offsetDate As New DateTimeOffset(specificDate.Year, _
                                        specificDate.Month, _
                                        specificDate.Day, _
                                        specificDate.Hour, _
                                        specificDate.Minute, _
                                        specificDate.Second, _
                                        New TimeSpan(-5, 0, 0))
   Console.WriteLine("Current time: {0}", offsetDate)
   Console.WriteLine("Corresponding UTC time: {0}", offsetDate.UtcDateTime)                                              
' The code produces the following output:
'    Current time: 5/1/2008 6:32:00 AM -05:00
'    Corresponding UTC time: 5/1/2008 11:32:00 AM      

설명

이 생성자는 해석 year, month, 및 day 연도, 월 및 그레고리오 력으로 날짜를 합니다.This constructor interprets year, month, and day as a year, month, and day in the Gregorian calendar. 인스턴스화하는 DateTimeOffset 호출 다른 일정에서 연도, 월 및 일을 사용 하 여 값을 DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) 생성자입니다.To instantiate a DateTimeOffset value by using the year, month, and day in another calendar, call the DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructor.

추가 정보

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)

지정된 연도, 월, 일, 시, 분, 초, 밀리초 및 오프셋을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and offset.

public:
 DateTimeOffset(int year, int month, int day, int hour, int minute, int second, int millisecond, TimeSpan offset);
public DateTimeOffset (int year, int month, int day, int hour, int minute, int second, int millisecond, TimeSpan offset);
new DateTimeOffset : int * int * int * int * int * int * int * TimeSpan -> DateTimeOffset
Public Sub New (year As Integer, month As Integer, day As Integer, hour As Integer, minute As Integer, second As Integer, millisecond As Integer, offset As TimeSpan)

매개 변수

year
Int32 Int32 Int32 Int32

연도(1부터 9999까지)The year (1 through 9999).

month
Int32 Int32 Int32 Int32

월(1부터 12까지)The month (1 through 12).

day
Int32 Int32 Int32 Int32

일(1부터 month에 있는 일수까지)The day (1 through the number of days in month).

hour
Int32 Int32 Int32 Int32

시(0부터 23까지)The hours (0 through 23).

minute
Int32 Int32 Int32 Int32

분(0부터 59까지)The minutes (0 through 59).

second
Int32 Int32 Int32 Int32

초(0부터 59까지)The seconds (0 through 59).

millisecond
Int32 Int32 Int32 Int32

밀리초(0부터 999까지)The milliseconds (0 through 999).

offset
TimeSpan TimeSpan TimeSpan TimeSpan

UTC(협정 세계시)를 기준으로 해당 시간의 오프셋입니다.The time's offset from Coordinated Universal Time (UTC).

예외

offset이 전체 시간(분)을 표시하지 않습니다.offset does not represent whole minutes.

year가 1보다 작거나 9999보다 큽니다.year is less than one or greater than 9999.

또는-or- month가 1보다 작거나 12보다 큽니다.month is less than one or greater than 12.

또는-or- day가 1보다 작거나 month의 일 수보다 큽니다.day is less than one or greater than the number of days in month.

또는-or- hour가 0보다 작거나 23보다 큽니다.hour is less than zero or greater than 23.

또는-or- minute가 0보다 작거나 59보다 큽니다.minute is less than 0 or greater than 59.

또는-or- second가 0보다 작거나 59보다 큽니다.second is less than 0 or greater than 59.

또는-or- millisecond가 0보다 작거나 999보다 큽니다.millisecond is less than 0 or greater than 999.

또는-or- offset가 -14보다 작거나 14보다 큽니다.offset is less than -14 or greater than 14.

또는-or- UtcDateTime 속성이 MinValue 이전이거나 MaxValue 이후입니다.The UtcDateTime property is earlier than MinValue or later than MaxValue.

예제

다음 예제에서는 한 DateTimeOffset 사용 하 여 개체를 DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) 생성자 오버 로드 합니다.The following example instantiates a DateTimeOffset object by using the DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) constructor overload.

string fmt = "dd MMM yyyy HH:mm:ss";
DateTime thisDate = new DateTime(2007, 06, 12, 19, 00, 14, 16);
DateTimeOffset offsetDate = new DateTimeOffset(thisDate.Year, 
                                               thisDate.Month, 
                                               thisDate.Day, 
                                               thisDate.Hour,
                                               thisDate.Minute,
                                               thisDate.Second,
                                               thisDate.Millisecond, 
                                               new TimeSpan(2, 0, 0));  
Console.WriteLine("Current time: {0}:{1}", offsetDate.ToString(fmt), offsetDate.Millisecond);
// The code produces the following output:
//    Current time: 12 Jun 2007 19:00:14:16      
Dim fmt As String = "dd MMM yyyy HH:mm:ss"
Dim thisDate As DateTime = New Date(2007, 06, 12, 19, 00, 14, 16)
Dim offsetDate As New DateTimeOffset(thisDate.Year, _
                                     thisDate.Month, _
                                     thisDate.Day, _
                                     thisDate.Hour, _
                                     thisDate.Minute, _
                                     thisDate.Second, _
                                     thisDate.Millisecond, _ 
                                     New TimeSpan(2, 0, 0))  
Console.WriteLine("Current time: {0}:{1}", offsetDate.ToString(fmt), _ 
                                           offsetDate.Millisecond)
' The code produces the following output:
'    Current time: 12 Jun 2007 19:00:14:16      

설명

이 생성자는 해석 year, month, 및 day 연도, 월 및 그레고리오 력으로 날짜를 합니다.This constructor interprets year, month, and day as a year, month, and day in the Gregorian calendar. 인스턴스화하는 DateTimeOffset 호출 다른 일정에서 연도, 월 및 일을 사용 하 여 값을 DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) 생성자입니다.To instantiate a DateTimeOffset value by using the year, month, and day in another calendar, call the DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructor.

추가 정보

DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)

지정된 달력의 지정된 연도, 월, 일, 시, 분, 초, 밀리초 및 오프셋을 사용하여 DateTimeOffset 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the DateTimeOffset structure using the specified year, month, day, hour, minute, second, millisecond, and offset of a specified calendar.

public:
 DateTimeOffset(int year, int month, int day, int hour, int minute, int second, int millisecond, System::Globalization::Calendar ^ calendar, TimeSpan offset);
public DateTimeOffset (int year, int month, int day, int hour, int minute, int second, int millisecond, System.Globalization.Calendar calendar, TimeSpan offset);
new DateTimeOffset : int * int * int * int * int * int * int * System.Globalization.Calendar * TimeSpan -> DateTimeOffset

매개 변수

year
Int32 Int32 Int32 Int32

연도The year.

month
Int32 Int32 Int32 Int32

월(1부터 12까지)The month (1 through 12).

day
Int32 Int32 Int32 Int32

일(1부터 month에 있는 일수까지)The day (1 through the number of days in month).

hour
Int32 Int32 Int32 Int32

시(0부터 23까지)The hours (0 through 23).

minute
Int32 Int32 Int32 Int32

분(0부터 59까지)The minutes (0 through 59).

second
Int32 Int32 Int32 Int32

초(0부터 59까지)The seconds (0 through 59).

millisecond
Int32 Int32 Int32 Int32

밀리초(0부터 999까지)The milliseconds (0 through 999).

calendar
Calendar Calendar Calendar Calendar

year, monthday를 해석하는 데 사용되는 달력입니다.The calendar that is used to interpret year, month, and day.

offset
TimeSpan TimeSpan TimeSpan TimeSpan

UTC(협정 세계시)를 기준으로 해당 시간의 오프셋입니다.The time's offset from Coordinated Universal Time (UTC).

예외

offset이 전체 시간(분)을 표시하지 않습니다.offset does not represent whole minutes.

calendarnull이 될 수 없는 경우calendar cannot be null.

yearcalendar 매개 변수의 MinSupportedDateTime.Year보다 작거나 MaxSupportedDateTime.Year보다 큽니다.year is less than the calendar parameter's MinSupportedDateTime.Year or greater than MaxSupportedDateTime.Year.

또는-or- monthcalendaryear에 있는 개월 수보다 작거나 큽니다.month is either less than or greater than the number of months in year in the calendar.

또는-or- day가 1보다 작거나 month의 일 수보다 큽니다.day is less than one or greater than the number of days in month.

또는-or- hour가 0보다 작거나 23보다 큽니다.hour is less than zero or greater than 23.

또는-or- minute가 0보다 작거나 59보다 큽니다.minute is less than 0 or greater than 59.

또는-or- second가 0보다 작거나 59보다 큽니다.second is less than 0 or greater than 59.

또는-or- millisecond가 0보다 작거나 999보다 큽니다.millisecond is less than 0 or greater than 999.

또는-or- offset이 -14시간보다 작거나 14시간보다 큽니다.offset is less than -14 hours or greater than 14 hours.

또는-or- year, monthday 매개 변수를 날짜 및 시간 값으로 나타낼 수 없습니다.The year, month, and day parameters cannot be represented as a date and time value.

또는-or- UtcDateTime 속성이 MinValue 이전이거나 MaxValue 이후입니다.The UtcDateTime property is earlier than MinValue or later than MaxValue.

예제

다음 예제에서는 둘 다의 인스턴스를 사용 합니다 HebrewCalendar 클래스 및 HijriCalendar 인스턴스화할 클래스를 DateTimeOffset 값입니다.The following example uses instances of both the HebrewCalendar class and the HijriCalendar class to instantiate a DateTimeOffset value. 해당 날짜 각 달력과 그레고리오 력 달력을 사용 하 여 콘솔에 표시 됩니다.That date is then displayed to the console using the respective calendars and the Gregorian calendar.

CultureInfo fmt;
int year; 
Calendar cal;
DateTimeOffset dateInCal;

// Instantiate DateTimeOffset with Hebrew calendar
year = 5770;
cal = new HebrewCalendar();
fmt = new CultureInfo("he-IL");
fmt.DateTimeFormat.Calendar = cal;      
dateInCal = new DateTimeOffset(year, 7, 12, 
                               15, 30, 0, 0, 
                               cal, 
                               new TimeSpan(2, 0, 0));
// Display the date in the Hebrew calendar
Console.WriteLine("Date in Hebrew Calendar: {0:g}", 
                   dateInCal.ToString(fmt));
// Display the date in the Gregorian calendar                         
Console.WriteLine("Date in Gregorian Calendar: {0:g}", dateInCal);
Console.WriteLine();

// Instantiate DateTimeOffset with Hijri calendar
year = 1431;
cal = new HijriCalendar();
fmt = new CultureInfo("ar-SA");
fmt.DateTimeFormat.Calendar = cal;
dateInCal = new DateTimeOffset(year, 7, 12, 
                               15, 30, 0, 0, 
                               cal, 
                               new TimeSpan(2, 0, 0));
// Display the date in the Hijri calendar
Console.WriteLine("Date in Hijri Calendar: {0:g}", 
                   dateInCal.ToString(fmt));
// Display the date in the Gregorian calendar                         
Console.WriteLine("Date in Gregorian Calendar: {0:g}", dateInCal);
Console.WriteLine();
Dim fmt As CultureInfo
Dim year As Integer
Dim cal As Calendar
Dim dateInCal As DateTimeOffset

' Instantiate DateTimeOffset with Hebrew calendar
year = 5770
cal = New HebrewCalendar()
fmt = New CultureInfo("he-IL")
fmt.DateTimeFormat.Calendar = cal      
dateInCal = New DateTimeOffset(year, 7, 12, _
                               15, 30, 0, 0, _
                               cal, _
                               New TimeSpan(2, 0, 0))
' Display the date in the Hebrew calendar
Console.WriteLine("Date in Hebrew Calendar: {0:g}", _
                   dateInCal.ToString(fmt))
' Display the date in the Gregorian calendar                         
Console.WriteLine("Date in Gregorian Calendar: {0:g}", dateInCal)
Console.WriteLine()

' Instantiate DateTimeOffset with Hijri calendar
year = 1431
cal = New HijriCalendar()
fmt = New CultureInfo("ar-SA")
fmt.DateTimeFormat.Calendar = cal
dateInCal = New DateTimeOffset(year, 7, 12, _
                               15, 30, 0, 0, _
                               cal, _
                               New TimeSpan(2, 0, 0))
' Display the date in the Hijri calendar
Console.WriteLine("Date in Hijri Calendar: {0:g}", _
                   dateInCal.ToString(fmt))
' Display the date in the Gregorian calendar                         
Console.WriteLine("Date in Gregorian Calendar: {0:g}", dateInCal)
Console.WriteLine()

설명

year, month, day, hour, minute, second, 및 millisecond 매개 변수는 모두 반영 하 여 지정 된 달력에 표현 된 값을 calendar 매개 변수입니다.The year, month, day, hour, minute, second, and millisecond parameters all reflect values expressed in the calendar specified by the calendar parameter. 이러한 값을 날짜 및 시간이이 달력을 사용 하 여 표현할 수 없는 경우 예외가 throw 됩니다.An exception is thrown if these values form a date and time that cannot be expressed by using this calendar.

중요

일본어 달력의 시대는 천황 통치 기간을 기준으로 하므로 변경되어야 합니다.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. 예를 들어 2019년 5월 1일은 JapaneseCalendarJapaneseLunisolarCalendar에서 레이와 시대의 시작을 나타냅니다.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. 이러한 시대 변경 내용은 해당 달력을 사용하는 모든 애플리케이션에 영향을 줍니다.Such a change of era affects all applications that use these calendars. 자세한 내용 및 현재 애플리케이션이 영향을 받는지 확인하는 방법은 .NET에서 일본식 달력의 새로운 세대 처리를 참조하세요.See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Windows 시스템에서 애플리케이션을 테스트하여 세대 변화에 대한 준비 상태를 확인하는 방법은 일본어 세대 변경을 위한 애플리케이션 준비를 참조하세요.See Prepare your application for the Japanese era change for information on testing your applications on Windows systems to ensure their readiness for the era change. 여러 시대가 포함된 달력을 지원하는 .NET의 기능과 여러 시대를 지원하는 달력을 사용할 때 모범 사례에 대해서는 시대 작업을 참조하세요.See Working with eras for features in .NET that support calendars with multiple eras and for best practices when working with calendars that support multiple eras.

추가 정보

적용 대상