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 日午前 00: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以外の値を現地時刻とオフセットをローカル時刻のゾーンがスローされます、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      

注釈

このコンス トラクターは解釈yearmonth、および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      

注釈

このコンス トラクターは解釈yearmonth、および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

yearmonth、および day を解釈するために使用される暦。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.

calendar として null を使用することはできません。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- month が、calendaryear の月数に満たないか、月数を超えています。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- yearmonth、および day の各パラメーターを日時の値として表すことができません。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()

注釈

yearmonthdayhourminutesecond、およびmillisecondすべてのパラメーターで指定された予定表で表される値の反映、calendarパラメーター。The year, month, day, hour, minute, second, and millisecond parameters all reflect values expressed in the calendar specified by the calendar parameter. これらの値は、このカレンダーを使用して表現できない日時を形成する場合は、例外がスローされます。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. たとえば、JapaneseCalendarJapaneseLunisolarCalendar において、2019 年 5 月 1 日から令和時代が始まることになりました。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 の機能や、複数の時代 (年号) をサポートしているカレンダーを操作する際のベスト プラクティスについては、「Working with eras (時代 (年号) の操作)」をご覧ください。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.

こちらもご覧ください

適用対象