DateTimeOffset Konstruktoren

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Initialisiert eine neue Instanz der DateTimeOffset-Struktur.

Überlädt

DateTimeOffset(DateTime)	Initialisiert eine neue Instanz der DateTimeOffset-Struktur unter Verwendung des angegebenen DateTime-Werts.
DateTimeOffset(DateTime, TimeSpan)	Initialisiert eine neue Instanz der DateTimeOffset-Struktur unter Verwendung des angegebenen DateTime-Werts und -Offsets.
DateTimeOffset(Int64, TimeSpan)	Initialisiert eine neue Instanz der DateTimeOffset-Struktur mit der angegebenen Anzahl von Ticks und dem Offset.
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)	Initialisiert eine neue instance der DateTimeOffset -Struktur mit den angegebenen `date`, `time`und `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.
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.
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.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Initialisiert eine neue instance der DateTimeOffset -Struktur mit den angegebenen `year`, `month`, , `day`, `hourminute`, `secondmillisecond`, `microsecond` und `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Initialisiert eine neue instance der DateTimeOffset -Struktur mit den angegebenen `year`, `month`, , `day`, `hourminute`, `secondmillisecond`, `microsecond` und `offset`.

DateTimeOffset(DateTime)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialisiert eine neue Instanz der DateTimeOffset-Struktur unter Verwendung des angegebenen DateTime-Werts.

public:
 DateTimeOffset(DateTime dateTime);

public DateTimeOffset (DateTime dateTime);

new DateTimeOffset : DateTime -> DateTimeOffset

Public Sub New (dateTime As DateTime)

Parameter

dateTime: DateTime

Ein Datum und eine Uhrzeit.

Ausnahmen

ArgumentOutOfRangeException

Das UTC-Datum (Coordinated Universal Time), das sich aus dem Anwenden des Offsets ergibt, liegt vor DateTimeOffset.MinValue.

\- oder -

Das UTC-Datum und die Utc-Uhrzeit, die sich aus dem Anwenden des Offsets ergeben, liegt höher als DateTimeOffset.MaxValue.

Beispiele

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

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

let localNow = DateTime.Now
let localOffset = DateTimeOffset localNow
printfn $"{localOffset}"

let utcNow = DateTime.UtcNow
let utcOffset = DateTimeOffset utcNow
printfn "{utcOffset}"

let unspecifiedNow = DateTime.SpecifyKind(DateTime.Now, DateTimeKind.Unspecified)
let unspecifiedOffset = DateTimeOffset unspecifiedNow
printfn $"{unspecifiedOffset}"

// 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 des dateTime Parameters ab:

Wenn der Wert von DateTime.Kind ist, wird DateTimeKind.Utcdie DateTime -Eigenschaft der neuen instance gleich dateTimefestgelegt, und die Offset -Eigenschaft ist gleich Zerofestgelegt.
Wenn der Wert von DateTime.Kind oder DateTimeKind.UnspecifiedistDateTimeKind.Local, wird die DateTime -Eigenschaft der neuen instance gleich dateTimefestgelegt, und die Offset -Eigenschaft ist gleich dem Offset der aktuellen Zeitzone des lokalen Systems.

Weitere Informationen

Instanziieren eines DateTimeOffset-Objekts

Gilt für:

DateTimeOffset(DateTime, TimeSpan)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialisiert eine neue Instanz der DateTimeOffset-Struktur unter Verwendung des angegebenen DateTime-Werts und -Offsets.

public:
 DateTimeOffset(DateTime dateTime, TimeSpan offset);

public DateTimeOffset (DateTime dateTime, TimeSpan offset);

new DateTimeOffset : DateTime * TimeSpan -> DateTimeOffset

Public Sub New (dateTime As DateTime, offset As TimeSpan)

Parameter

dateTime: DateTime

Ein Datum und eine Uhrzeit.

offset: TimeSpan

Der UTC (Coordinated Universal Time)-Offset der Zeitangabe.

Ausnahmen

ArgumentException

dateTime.Kind ist gleich Utc und offset ist ungleich 0 (null).

- oder -

dateTime.Kind ist gleich Local und offset ist nicht mit dem Offset der lokalen Zeitzone des Systems identisch.

- oder -

offset ist nicht in ganzen Minuten angegeben.

ArgumentOutOfRangeException

offset ist kleiner als -14 Stunden oder größer als 14 Stunden.

- oder -

UtcDateTime ist kleiner als DateTimeOffset.MinValue oder größer als DateTimeOffset.MaxValue.

Beispiele

Das folgende Beispiel zeigt, 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.

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

let localTime = DateTime(2007, 07, 12, 06, 32, 00)
let dateAndOffset = DateTimeOffset(localTime, TimeZoneInfo.Local.GetUtcOffset localTime)
printfn $"{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 des dateTime Parameters ab:

Wenn der Wert von Kind ist DateTimeKind.Utc, muss der Wert des offset Parameters 0 sein, oder ein ArgumentException wird ausgelöst.
Wenn der Wert von Kind ist DateTimeKind.Local, muss der Wert des Parameters dem Offset der offset lokalen Zeitzone von utc (Coordinated Universal Time) für dieses bestimmte Datum entsprechen, oder ein ArgumentException wird ausgelöst.
Wenn der Wert von Kind ist DateTimeKind.Unspecified, kann der offset Parameter einen beliebigen gültigen Wert aufweisen.

Weitere Informationen

Instanziieren eines DateTimeOffset-Objekts

Gilt für:

DateTimeOffset(Int64, TimeSpan)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

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

offset: TimeSpan

Der UTC (Coordinated Universal Time)-Offset der Zeitangabe.

Ausnahmen

ArgumentException

offset ist nicht in ganzen Minuten angegeben.

ArgumentOutOfRangeException

Die UtcDateTime Eigenschaft ist älter als DateTimeOffset.MinValue oder höher als DateTimeOffset.MaxValue.

- oder -

ticks ist kleiner als DateTimeOffset.MinValue.Ticks oder größer als DateTimeOffset.MaxValue.Ticks.

- oder -

Offset ist kleiner als-14 Stunden oder größer als 14 Stunden.

Beispiele

Im folgenden Beispiel wird ein DateTimeOffset -Objekt initialisiert, indem die Anzahl von Teilstrichen in einem beliebigen Datum (in diesem Fall, 16. Juli 2007, um 13:32 Uhr) mit einem Offset von -5 verwendet wird.

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

let dateWithoutOffset = DateTime(2007, 7, 16, 13, 32, 00)
let timeFromTicks = DateTimeOffset(dateWithoutOffset.Ticks, TimeSpan(-5, 0, 0))
printfn $"{timeFromTicks}"
// 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, den DateTimeOffset Konstruktor aufzurufen, um einen DateTimeOffset Wert mit einer Ortszeit und einem anderen Offset als dem der lokalen Zeitzone zu instanziieren, eine ArgumentExceptionausgelöst. Sie können diese Überladung des DateTimeOffset Konstruktors verwenden, um diese Einschränkung zu umgehen. Im folgenden Beispiel wird die Anzahl der Teilstriche der Ortszeit verwendet, um einen DateTimeOffset Wert zu instanziieren, dessen Offset nicht unbedingt den Wert der Ortszeit darstellt:

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

let localTime = DateTime.Now
let nonLocalDateWithOffset = DateTimeOffset(localTime.Ticks, TimeSpan(2, 0, 0))
printfn $"{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

Weitere Informationen

Instanziieren eines DateTimeOffset-Objekts

Gilt für:

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialisiert eine neue instance der DateTimeOffset -Struktur mit den angegebenen date, timeund offset.

public:
 DateTimeOffset(DateOnly date, TimeOnly time, TimeSpan offset);

public DateTimeOffset (DateOnly date, TimeOnly time, TimeSpan offset);

new DateTimeOffset : DateOnly * TimeOnly * TimeSpan -> DateTimeOffset

Public Sub New (date As DateOnly, time As TimeOnly, offset As TimeSpan)

Parameter

date: DateOnly

Der Datumsteil.

time: TimeOnly

Der Zeitteil.

offset: TimeSpan

Der UTC (Coordinated Universal Time)-Offset der Zeitangabe.

Gilt für:

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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

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

month: Int32

Der Monat (1 bis 12).

day: Int32

Der Tag (1 bis zur Anzahl der Tage in month).

hour: Int32

Die Stunden (0 bis 23).

minute: Int32

Die Minuten (0 bis 59).

second: Int32

Die Sekunden (0 bis 59).

offset: TimeSpan

Der UTC (Coordinated Universal Time)-Offset der Zeitangabe.

Ausnahmen

ArgumentException

offset gibt keine ganzen Minuten an.

ArgumentOutOfRangeException

year ist kleiner oder größer als 9999.

- oder -

month ist kleiner oder größer als 12.

- oder -

day ist kleiner als eins oder größer als die Anzahl von Tagen in month.

- oder -

hour ist kleiner als 0 (null) oder größer als 23.

- oder -

minute ist kleiner als 0 (null) oder größer als 59.

- oder -

second ist kleiner als 0 (null) oder größer als 59.

- oder -

offset ist kleiner als -14 Stunden oder größer als 14 Stunden.

- oder -

Die UtcDateTime Eigenschaft ist älter als DateTimeOffset.MinValue oder höher als DateTimeOffset.MaxValue.

Beispiele

Im folgenden Beispiel wird ein DateTimeOffset -Objekt mithilfe der DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) Konstruktorüberladung instanziiert.

   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

let specificDate = DateTime(2008, 5, 1, 06, 32, 00)
let offsetDate = DateTimeOffset(specificDate.Year,
                                specificDate.Month,
                                specificDate.Day,
                                specificDate.Hour,
                                specificDate.Minute,
                                specificDate.Second,
                                TimeSpan(-5, 0, 0))
printfn $"Current time: {offsetDate}"
printfn $"Corresponding UTC time: {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. Rufen DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) Sie den Konstruktor auf, um einen DateTimeOffset Wert mithilfe von Jahr, Monat und Tag in einem anderen Kalender zu instanziieren.

Weitere Informationen

Instanziieren eines DateTimeOffset-Objekts

Gilt für:

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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

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

month: Int32

Der Monat (1 bis 12).

day: Int32

Der Tag (1 bis zur Anzahl der Tage in month).

hour: Int32

Die Stunden (0 bis 23).

minute: Int32

Die Minuten (0 bis 59).

second: Int32

Die Sekunden (0 bis 59).

millisecond: Int32

Die Millisekunden (0 bis 999).

offset: TimeSpan

Der UTC (Coordinated Universal Time)-Offset der Zeitangabe.

Ausnahmen

ArgumentException

offset gibt keine ganzen Minuten an.

ArgumentOutOfRangeException

year ist kleiner oder größer als 9999.

- oder -

month ist kleiner oder größer als 12.

- oder -

day ist kleiner als eins oder größer als die Anzahl von Tagen in month.

- oder -

hour ist kleiner als 0 (null) oder größer als 23.

- oder -

minute ist kleiner als 0 (null) oder größer als 59.

- oder -

second ist kleiner als 0 (null) oder größer als 59.

- oder -

millisecond ist kleiner als 0 (null) oder größer als 999.

- oder -

offset ist kleiner als -14 oder größer als 14.

- oder -

Die UtcDateTime Eigenschaft ist älter als DateTimeOffset.MinValue oder höher als DateTimeOffset.MaxValue.

Beispiele

Im folgenden Beispiel wird ein DateTimeOffset -Objekt mithilfe der DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) Konstruktorüberladung instanziiert.

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

let fmt = "dd MMM yyyy HH:mm:ss"
let thisDate = DateTime(2007, 06, 12, 19, 00, 14, 16)
let offsetDate = DateTimeOffset(thisDate.Year,
                                thisDate.Month,
                                thisDate.Day,
                                thisDate.Hour,
                                thisDate.Minute,
                                thisDate.Second,
                                thisDate.Millisecond,
                                TimeSpan(2, 0, 0))
printfn $"Current time: {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

Weitere Informationen

Instanziieren eines DateTimeOffset-Objekts

Gilt für:

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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

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.

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

Public Sub New (year As Integer, month As Integer, day As Integer, hour As Integer, minute As Integer, second As Integer, millisecond As Integer, calendar As Calendar, offset As TimeSpan)

Parameter

year: Int32

Das Jahr.

month: Int32

Der Monat (1 bis 12).

day: Int32

Der Tag (1 bis zur Anzahl der Tage in month).

hour: Int32

Die Stunden (0 bis 23).

minute: Int32

Die Minuten (0 bis 59).

second: Int32

Die Sekunden (0 bis 59).

millisecond: Int32

Die Millisekunden (0 bis 999).

calendar: Calendar

Der Kalender, der zum Interpretieren von year, month und day verwendet wird.

offset: TimeSpan

Der UTC (Coordinated Universal Time)-Offset der Zeitangabe.

Ausnahmen

ArgumentException

offset gibt keine ganzen Minuten an.

ArgumentNullException

calendar darf nicht null sein.

ArgumentOutOfRangeException

year ist kleiner als der MinSupportedDateTime.Year-Wert des calendar-Parameters oder größer als MaxSupportedDateTime.Year.

- oder -

month ist entweder kleiner oder größer als die Anzahl von Monaten in year im calendar.

- oder -

day ist kleiner als eins oder größer als die Anzahl von Tagen in month.

- oder -

hour ist kleiner als 0 (null) oder größer als 23.

- oder -

minute ist kleiner als 0 (null) oder größer als 59.

- oder -

second ist kleiner als 0 (null) oder größer als 59.

- oder -

millisecond ist kleiner als 0 (null) oder größer als 999.

- oder -

offset ist kleiner als -14 Stunden oder größer als 14 Stunden.

- oder -

Die Parameter year, month und day können nicht als Datums- und Zeitwert dargestellt werden.

- oder -

Die UtcDateTime Eigenschaft ist älter als DateTimeOffset.MinValue oder höher als DateTimeOffset.MaxValue.

Beispiele

Im folgenden Beispiel werden Instanzen der HebrewCalendar -Klasse und der HijriCalendar -Klasse verwendet, um einen DateTimeOffset Wert zu instanziieren. Dieses Datum wird dann in der Konsole mit den jeweiligen Kalendern und dem gregorianischen Kalender angezeigt.

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();

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

// Instantiate DateTimeOffset with Hijri calendar
let year = 1431
let cal = HijriCalendar()
let fmt = CultureInfo "ar-SA"
fmt.DateTimeFormat.Calendar <- cal
let dateInCal = DateTimeOffset(year, 7, 12,
                               15, 30, 0, 0,
                               cal,
                               TimeSpan(2, 0, 0))
// Display the date in the Hijri calendar
printfn $"Date in Hijri Calendar: {dateInCal.ToString fmt:g}"
// Display the date in the Gregorian calendar
printfn $"Date in Gregorian Calendar: {dateInCal:g}\n"

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, minutehour, secondund millisecond spiegeln alle Werte wider, die im durch den calendar -Parameter angegebenen Kalender ausgedrückt werden. Eine Ausnahme wird ausgelöst, wenn diese Werte ein Datum und eine Uhrzeit bilden, die nicht mithilfe dieses Kalenders ausgedrückt werden können.

Wichtig

Die Zeitrechnung in japanischen Kalendern basiert auf den Regierungsperioden der Kaiser und wird sich daher erwartungsgemäß ändern. Beispiel: Der 1. Mai 2019 markiert den Beginn des Reiwa-Zeitabschnitts in den Kalendern des Typs JapaneseCalendar und JapaneseLunisolarCalendar. Eine derartige Änderung der Zeitabschnitte betrifft alle Anwendungen, die diese Kalender verwenden. Weitere Informationen und informationen zum Ermitteln, ob Ihre Anwendungen betroffen sind, finden Sie unter Behandeln einer neuen Ära im japanischen Kalender in .NET. Informationen zum Testen Ihrer Anwendungen auf Windows-Systemen, um ihre Bereitschaft für den Zeitwechsel sicherzustellen, finden Sie unter Vorbereiten ihrer Anwendung auf die Änderung der japanischen Ära. Features in .NET, die Kalender mit mehreren Epochen unterstützen, und bewährte Methoden für die Arbeit mit Kalendern, die mehrere Epochen unterstützen, finden Sie unter Arbeiten mit Epochen.

Weitere Informationen

Instanziieren eines DateTimeOffset-Objekts

Gilt für:

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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialisiert eine neue instance der DateTimeOffset -Struktur mit den angegebenen year, month, , day, hourminute, secondmillisecond, microsecond und offset.

public:
 DateTimeOffset(int year, int month, int day, int hour, int minute, int second, int millisecond, int microsecond, TimeSpan offset);

public DateTimeOffset (int year, int month, int day, int hour, int minute, int second, int millisecond, int microsecond, TimeSpan offset);

new DateTimeOffset : int * 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, microsecond As Integer, offset As TimeSpan)

Parameter

year: Int32

Das Jahr (1 bis 9999).

month: Int32

Der Monat (1 bis 12).

day: Int32

Der Tag (1 bis zur Anzahl der Tage in month).

hour: Int32

Die Stunden (0 bis 23).

minute: Int32

Die Minuten (0 bis 59).

second: Int32

Die Sekunden (0 bis 59).

millisecond: Int32

Die Millisekunden (0 bis 999).

microsecond: Int32

Die Mikrosekunden (0 bis 999).

offset: TimeSpan

Der UTC (Coordinated Universal Time)-Offset der Zeitangabe.

Ausnahmen

ArgumentException

offset gibt keine ganzen Minuten an.

ArgumentOutOfRangeException

year ist kleiner als 1 oder größer als 9999.

- oder -

month ist kleiner als 1 oder größer als 12.

- oder -

day ist kleiner als 1 oder größer als die Anzahl der Tage in month.

- oder -

hour ist kleiner als 0 (null) oder größer als 23.

- oder -

minute ist kleiner als 0 (null) oder größer als 59.

- oder -

second ist kleiner als 0 (null) oder größer als 59.

- oder -

millisecond ist kleiner als 0 (null) oder größer als 999.

- oder -

microsecond ist kleiner als 0 (null) oder größer als 999.

Hinweise

Dieser Konstruktor interpretiert yearund monthday als Jahr, Monat und Tag im gregorianischen Kalender. Rufen Sie DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) den Konstruktor auf, um einen DateTimeOffset Wert mithilfe von Jahr, Monat und Tag in einem anderen Kalender zu instanziieren.

Gilt für:

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

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Source:: DateTimeOffset.cs

Initialisiert eine neue instance der DateTimeOffset -Struktur mit den angegebenen year, month, , day, hourminute, secondmillisecond, microsecond und offset.

public:
 DateTimeOffset(int year, int month, int day, int hour, int minute, int second, int millisecond, int microsecond, System::Globalization::Calendar ^ calendar, TimeSpan offset);

public DateTimeOffset (int year, int month, int day, int hour, int minute, int second, int millisecond, int microsecond, System.Globalization.Calendar calendar, TimeSpan offset);

new DateTimeOffset : int * int * int * int * int * int * int * int * System.Globalization.Calendar * 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, microsecond As Integer, calendar As Calendar, offset As TimeSpan)

Parameter

year: Int32

Das Jahr (1 bis 9999).

month: Int32

Der Monat (1 bis 12).

day: Int32

Der Tag (1 bis zur Anzahl der Tage in month).

hour: Int32

Die Stunden (0 bis 23).

minute: Int32

Die Minuten (0 bis 59).

second: Int32

Die Sekunden (0 bis 59).

millisecond: Int32

Die Millisekunden (0 bis 999).

microsecond: Int32

Die Mikrosekunden (0 bis 999).

calendar: Calendar

Der Kalender, der zum Interpretieren von year, month und day verwendet wird.

offset: TimeSpan

Der UTC (Coordinated Universal Time)-Offset der Zeitangabe.

Ausnahmen

ArgumentException

offset gibt keine ganzen Minuten an.

ArgumentOutOfRangeException

year befindet sich nicht im von calendar unterstützten Bereich.

- oder -

month ist kleiner als 1 oder größer als die Anzahl der Monate in calendar.

- oder -

day ist kleiner als 1 oder größer als die Anzahl der Tage in month.

- oder -

hour ist kleiner als 0 (null) oder größer als 23.

- oder -

minute ist kleiner als 0 (null) oder größer als 59.

- oder -

second ist kleiner als 0 (null) oder größer als 59.

- oder -

millisecond ist kleiner als 0 (null) oder größer als 999.

- oder -

microsecond ist kleiner als 0 (null) oder größer als 999.

- oder -

offset ist kleiner als -14 Stunden oder größer als 14 Stunden.

- oder -

Die Parameter year, month und day können nicht als Datums- und Zeitwert dargestellt werden.

- oder -

Der Zeitpunkt, den die UtcDateTime-Eigenschaft angibt, liegt vor MinValue oder hinter MaxValue.

Hinweise

Gilt für:

DateTimeOffset Konstruktoren

Definition

Überlädt

DateTimeOffset(DateTime)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

DateTimeOffset(DateTime, TimeSpan)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

DateTimeOffset(Int64, TimeSpan)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Parameter

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Ausnahmen

Hinweise

Gilt für:

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

Parameter

Ausnahmen

Hinweise

Gilt für:

Feedback

Zusätzliche Ressourcen