DateTimeOffset Konstruktoren

Definition

Initialisiert eine neue Instanz der DateTimeOffset-Struktur.Initializes a new instance of the DateTimeOffset structure.

Überlädt

DateTimeOffset(DateTime)

Initialisiert eine neue Instanz der DateTimeOffset-Struktur unter Verwendung des angegebenen DateTime-Werts.Initializes a new instance of the DateTimeOffset structure using the specified DateTime value.

DateTimeOffset(DateTime, TimeSpan)

Initialisiert eine neue Instanz der DateTimeOffset-Struktur unter Verwendung des angegebenen DateTime-Werts und -Offsets.Initializes a new instance of the DateTimeOffset structure using the specified DateTime value and offset.

DateTimeOffset(Int64, TimeSpan)

Initialisiert eine neue Instanz der DateTimeOffset-Struktur mit der angegebenen Anzahl von Ticks und dem Offset.Initializes a new instance of the DateTimeOffset structure using the specified number of ticks and offset.

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

Initialisiert eine neue Instanz der DateTimeOffset-Struktur mit den angegebenen Werten für Jahr, Monat, Tag, Stunde, Minute, Sekunde und Offset.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)

Initialisiert eine neue Instanz der DateTimeOffset-Struktur mit den angegebenen Werten für Jahr, Monat, Tag, Stunde, Minute, Sekunde, Millisekunde und Offset.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)

Initialisiert eine neue Instanz der DateTimeOffset-Struktur mit den angegebenen Werten für Jahr, Monat, Tag, Stunde, Minute, Sekunde, Millisekunde und Offset für einen angegebenen Kalender.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)

Initialisiert eine neue Instanz der DateTimeOffset-Struktur unter Verwendung des angegebenen DateTime-Werts.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

Parameter

dateTime
DateTime

Ein Datum und eine Uhrzeit.A date and time.

Ausnahmen

Der UTC-Zeitpunkt (Datum und Uhrzeit in koordinierter Weltzeit), der sich nach Anwenden des Offsets ergeben hat, liegt vor MinValue.The Coordinated Universal Time (UTC) date and time that results from applying the offset is earlier than MinValue.

- oder --or- Das UTC-Datum und die UTC-Uhrzeit nach der Anwendung des Offsets liegen nach MaxValue.The UTC date and time that results from applying the offset is later than MaxValue.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie sich der DateTime.Kind Wert der- dateTime Eigenschaft des-Parameters auf den Datums-und Uhrzeitwert auswirkt, der von diesem Konstruktor zurückgegeben wird.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      

Hinweise

Das Verhalten dieses Konstruktors hängt vom Wert der DateTime.Kind -Eigenschaft dateTime des-Parameters ab:This constructor's behavior depends on the value of the DateTime.Kind property of the dateTime parameter:

Siehe auch

DateTimeOffset(DateTime, TimeSpan)

Initialisiert eine neue Instanz der DateTimeOffset-Struktur unter Verwendung des angegebenen DateTime-Werts und -Offsets.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

Parameter

dateTime
DateTime

Ein Datum und eine Uhrzeit.A date and time.

offset
TimeSpan

Der UTC (Coordinated Universal Time)-Offset der Zeitangabe.The time's offset from Coordinated Universal Time (UTC).

Ausnahmen

dateTime.Kind ist gleich Utc und offset ist ungleich 0 (null).dateTime.Kind equals Utc and offset does not equal zero.

- oder --or- dateTime.Kind ist gleich Local, und offset ist nicht gleich dem Offset der lokalen Zeitzone des Systems.dateTime.Kind equals Local and offset does not equal the offset of the system's local time zone.

- oder --or- offset ist nicht in ganzen Minuten angegeben.offset is not specified in whole minutes.

offset ist kleiner als -14 Stunden oder größer als 14 Stunden.offset is less than -14 hours or greater than 14 hours.

- oder --or- UtcDateTime ist kleiner als MinValue oder größer als MaxValue.UtcDateTime is less than MinValue or greater than MaxValue.

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein DateTimeOffset -Objekt mit einem Datum und einer Uhrzeit und dem Offset der lokalen Zeitzone initialisiert wird, wenn diese Zeitzone nicht im Voraus bekannt ist.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

Hinweise

Das Verhalten dieses Konstruktors hängt teilweise vom Wert der Kind -Eigenschaft dateTime des-Parameters ab:This constructor's behavior depends in part on the value of the Kind property of the dateTime parameter:

Siehe auch

DateTimeOffset(Int64, TimeSpan)

Initialisiert eine neue Instanz der DateTimeOffset-Struktur mit der angegebenen Anzahl von Ticks und dem Offset.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)

Parameter

ticks
Int64

Ein Datum und eine Uhrzeit, die als Anzahl der 100-Nanosekunden-Intervalle ausgedrückt werden, die seit dem 1. Januar 0001, 00:00:00 vergangen sind.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

Der UTC (Coordinated Universal Time)-Offset der Zeitangabe.The time's offset from Coordinated Universal Time (UTC).

Ausnahmen

offset ist nicht in ganzen Minuten angegeben.offset is not specified in whole minutes.

Der Zeitpunkt, den die UtcDateTime -Eigenschaft angibt, liegt vor MinValue oder hinter MaxValue.The UtcDateTime property is earlier than MinValue or later than MaxValue.

- oder --or- ticks ist kleiner als DateTimeOffset.MinValue.Ticks oder größer als DateTimeOffset.MaxValue.Ticks.ticks is less than DateTimeOffset.MinValue.Ticks or greater than DateTimeOffset.MaxValue.Ticks.

- oder --or- Offset ist kleiner als -14 Stunden oder größer als 14 Stunden.Offset s less than -14 hours or greater than 14 hours.

Beispiele

Im folgenden Beispiel wird ein DateTimeOffset -Objekt initialisiert, indem die Anzahl der Ticks an einem beliebigen Datum (in diesem Fall 16, 2007, 1:32 Uhr) mit einem Offset von-5 verwendet wird.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

Hinweise

Normalerweise wird beim Versuch, DateTimeOffset den Konstruktor aufzurufen, um DateTimeOffset einen Wert mit einer lokalen Uhrzeit und einem anderen Offset als der der lokalen Zeitzone zu instanziieren, eine ArgumentExceptionausgelöst.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. Mit dieser Überladung des DateTimeOffset Konstruktors können Sie diese Einschränkung umgehen.You can use this overload of the DateTimeOffset constructor to work around this limitation. Im folgenden Beispiel wird die Anzahl der Ticks der Ortszeit verwendet, um einen DateTimeOffset Wert zu instanziieren, dessen Abweichung nicht notwendigerweise die der Ortszeit darstellt: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

Siehe auch

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

Initialisiert eine neue Instanz der DateTimeOffset-Struktur mit den angegebenen Werten für Jahr, Monat, Tag, Stunde, Minute, Sekunde und Offset.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)

Parameter

year
Int32

Das Jahr (1 bis 9999).The year (1 through 9999).

month
Int32

Der Monat (1 bis 12).The month (1 through 12).

day
Int32

Der Tag (1 bis zur Anzahl der Tage in month).The day (1 through the number of days in month).

hour
Int32

Die Stunden (0 bis 23).The hours (0 through 23).

minute
Int32

Die Minuten (0 bis 59).The minutes (0 through 59).

second
Int32

Die Sekunden (0 bis 59).The seconds (0 through 59).

offset
TimeSpan

Der UTC (Coordinated Universal Time)-Offset der Zeitangabe.The time's offset from Coordinated Universal Time (UTC).

Ausnahmen

offset gibt keine ganzen Minuten an.offset does not represent whole minutes.

year ist kleiner oder größer als 9999.year is less than one or greater than 9999.

- oder --or- month ist kleiner oder größer als 12.month is less than one or greater than 12.

- oder --or- day ist kleiner als 1 oder größer als die Anzahl der Tage in month.day is less than one or greater than the number of days in month.

- oder --or- hour ist kleiner als 0 oder größer als 23.hour is less than zero or greater than 23.

- oder --or- minute ist kleiner als 0 (null) oder größer als 59.minute is less than 0 or greater than 59.

- oder --or- second ist kleiner als 0 (null) oder größer als 59.second is less than 0 or greater than 59.

- oder --or- offset ist kleiner als -14 Stunden oder größer als 14 Stunden.offset is less than -14 hours or greater than 14 hours.

- oder --or- Die UtcDateTime-Eigenschaft liegt vor MinValue oder nach MaxValue.The UtcDateTime property is earlier than MinValue or later than MaxValue.

Beispiele

Im folgenden Beispiel wird ein DateTimeOffset -Objekt mithilfe der DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) -Konstruktorüberladung instanziiert.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      

Hinweise

Dieser Konstruktor interpretiert year, monthund day als Jahr, Monat und Tag im gregorianischen Kalender.This constructor interprets year, month, and day as a year, month, and day in the Gregorian calendar. Um einen DateTimeOffset Wert mithilfe von Jahr, Monat und Tag in einem anderen Kalender zu instanziieren, nennen Sie DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) den-Konstruktor.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.

Siehe auch

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

Initialisiert eine neue Instanz der DateTimeOffset-Struktur mit den angegebenen Werten für Jahr, Monat, Tag, Stunde, Minute, Sekunde, Millisekunde und Offset.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)

Parameter

year
Int32

Das Jahr (1 bis 9999).The year (1 through 9999).

month
Int32

Der Monat (1 bis 12).The month (1 through 12).

day
Int32

Der Tag (1 bis zur Anzahl der Tage in month).The day (1 through the number of days in month).

hour
Int32

Die Stunden (0 bis 23).The hours (0 through 23).

minute
Int32

Die Minuten (0 bis 59).The minutes (0 through 59).

second
Int32

Die Sekunden (0 bis 59).The seconds (0 through 59).

millisecond
Int32

Die Millisekunden (0 bis 999).The milliseconds (0 through 999).

offset
TimeSpan

Der UTC (Coordinated Universal Time)-Offset der Zeitangabe.The time's offset from Coordinated Universal Time (UTC).

Ausnahmen

offset gibt keine ganzen Minuten an.offset does not represent whole minutes.

year ist kleiner oder größer als 9999.year is less than one or greater than 9999.

- oder --or- month ist kleiner oder größer als 12.month is less than one or greater than 12.

- oder --or- day ist kleiner als 1 oder größer als die Anzahl der Tage in month.day is less than one or greater than the number of days in month.

- oder --or- hour ist kleiner als 0 oder größer als 23.hour is less than zero or greater than 23.

- oder --or- minute ist kleiner als 0 (null) oder größer als 59.minute is less than 0 or greater than 59.

- oder --or- second ist kleiner als 0 (null) oder größer als 59.second is less than 0 or greater than 59.

- oder --or- millisecond ist kleiner als 0 (null) oder größer als 999.millisecond is less than 0 or greater than 999.

- oder --or- offset ist kleiner als -14 oder größer als 14.offset is less than -14 or greater than 14.

- oder --or- Die UtcDateTime-Eigenschaft liegt vor MinValue oder nach MaxValue.The UtcDateTime property is earlier than MinValue or later than MaxValue.

Beispiele

Im folgenden Beispiel wird ein DateTimeOffset -Objekt mithilfe der DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) -Konstruktorüberladung instanziiert.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      

Hinweise

Dieser Konstruktor interpretiert year, monthund day als Jahr, Monat und Tag im gregorianischen Kalender.This constructor interprets year, month, and day as a year, month, and day in the Gregorian calendar. Um einen DateTimeOffset Wert mithilfe von Jahr, Monat und Tag in einem anderen Kalender zu instanziieren, nennen Sie DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) den-Konstruktor.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.

Siehe auch

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

Initialisiert eine neue Instanz der DateTimeOffset-Struktur mit den angegebenen Werten für Jahr, Monat, Tag, Stunde, Minute, Sekunde, Millisekunde und Offset für einen angegebenen Kalender.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

Parameter

year
Int32

Das Jahr.The year.

month
Int32

Der Monat (1 bis 12).The month (1 through 12).

day
Int32

Der Tag (1 bis zur Anzahl der Tage in month).The day (1 through the number of days in month).

hour
Int32

Die Stunden (0 bis 23).The hours (0 through 23).

minute
Int32

Die Minuten (0 bis 59).The minutes (0 through 59).

second
Int32

Die Sekunden (0 bis 59).The seconds (0 through 59).

millisecond
Int32

Die Millisekunden (0 bis 999).The milliseconds (0 through 999).

calendar
Calendar

Der Kalender, der zum Interpretieren von year, month und day verwendet wird.The calendar that is used to interpret year, month, and day.

offset
TimeSpan

Der UTC (Coordinated Universal Time)-Offset der Zeitangabe.The time's offset from Coordinated Universal Time (UTC).

Ausnahmen

offset gibt keine ganzen Minuten an.offset does not represent whole minutes.

calendar darf nicht nullsein.calendar cannot be null.

year ist kleiner als MinSupportedDateTime.Year oder größer als MaxSupportedDateTime.Year des calendar-Parameters.year is less than the calendar parameter's MinSupportedDateTime.Year or greater than MaxSupportedDateTime.Year.

- oder --or- month ist entweder kleiner oder größer als die Anzahl der Monate in year im calendar.month is either less than or greater than the number of months in year in the calendar.

- oder --or- day ist kleiner als 1 oder größer als die Anzahl der Tage in month.day is less than one or greater than the number of days in month.

- oder --or- hour ist kleiner als 0 oder größer als 23.hour is less than zero or greater than 23.

- oder --or- minute ist kleiner als 0 (null) oder größer als 59.minute is less than 0 or greater than 59.

- oder --or- second ist kleiner als 0 (null) oder größer als 59.second is less than 0 or greater than 59.

- oder --or- millisecond ist kleiner als 0 (null) oder größer als 999.millisecond is less than 0 or greater than 999.

- oder --or- offset ist kleiner als -14 Stunden oder größer als 14 Stunden.offset is less than -14 hours or greater than 14 hours.

- oder --or- Die Parameter year, month und day können nicht als Datums- und Uhrzeitwert dargestellt werden.The year, month, and day parameters cannot be represented as a date and time value.

- oder --or- Die UtcDateTime-Eigenschaft liegt vor MinValue oder nach MaxValue.The UtcDateTime property is earlier than MinValue or later than MaxValue.

Beispiele

Im folgenden Beispiel werden Instanzen der HebrewCalendar -Klasse und der HijriCalendar -Klasse verwendet, um einen DateTimeOffset -Wert zu instanziieren.The following example uses instances of both the HebrewCalendar class and the HijriCalendar class to instantiate a DateTimeOffset value. Dieses Datum wird dann in der Konsole mithilfe der jeweiligen Kalender und des gregorianischen Kalenders angezeigt.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()

Hinweise

Die yearParameter month,, day calendar , millisecond , ,secondundreflektieren alle Werte, die in dem Kalender ausgedrückt werden, der durch den-Parameter angegeben wird. minute hourThe year, month, day, hour, minute, second, and millisecond parameters all reflect values expressed in the calendar specified by the calendar parameter. Eine Ausnahme wird ausgelöst, wenn diese Werte ein Datum und eine Uhrzeit bilden, die nicht mithilfe dieses Kalenders ausgedrückt werden können.An exception is thrown if these values form a date and time that cannot be expressed by using this calendar.

Wichtig

Die Zeitrechnung in japanischen Kalendern basiert auf den Regierungsperioden der Kaiser und wird sich daher erwartungsgemäß ändern.Eras in the Japanese calendars are based on the emperor's reign and are therefore expected to change. Beispiel: Der 1. Mai 2019 markiert den Beginn des Reiwa-Zeitabschnitts in den Kalendern des Typs JapaneseCalendar und JapaneseLunisolarCalendar.For example, May 1, 2019 marked the beginning of the Reiwa era in the JapaneseCalendar and JapaneseLunisolarCalendar. Eine derartige Änderung der Zeitabschnitte betrifft alle Anwendungen, die diese Kalender verwenden.Such a change of era affects all applications that use these calendars. Unter Handling a new era in the Japanese calendar in .NET (Umgang mit einem neuen Zeitabschnitt im japanischen Kalender in .NET) finden Sie weiter Informationen und wie Sie bestimmen können, ob Ihre Anwendungen ebenfalls betroffen sind.See Handling a new era in the Japanese calendar in .NET for more information and to determine whether your applications are affected. Unter Prepare your application for the Japanese era change (Vorbereiten Ihrer Anwendung für die Änderung des Zeitabschnitts im japanischen Kalender) finden Sie Informationen zum Testen Ihrer Anwendungen auf Windows-Systemen, um deren Bereitschaft für die Änderung im Zeitabschnitt sicherzustellen.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. Unter Arbeiten mit Zeiträumen finden Sie Informationen zu Funktionen in .NET, die Kalender mit mehreren Zeitabschnitten unterstützen, sowie bewährte Vorgehensweisen bei der Arbeit mit solchen Kalendern.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.

Siehe auch

Gilt für: