DateTimeOffset Konstruktoren
Definition
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
| Name | Beschreibung |
|---|---|
| DateTimeOffset(DateTime) |
Initialisiert eine neue Instanz der DateTimeOffset Struktur mithilfe des angegebenen DateTime Werts. |
| DateTimeOffset(DateTime, TimeSpan) |
Initialisiert eine neue Instanz der DateTimeOffset Struktur mit dem angegebenen DateTime Wert und |
| DateTimeOffset(Int64, TimeSpan) |
Initialisiert eine neue Instanz der DateTimeOffset Struktur mithilfe der angegebenen Anzahl von |
| DateTimeOffset(DateOnly, TimeOnly, TimeSpan) |
Initialisiert eine neue Instanz der Struktur mithilfe des DateTimeOffset angegebenen |
| DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) |
Initialisiert eine neue Instanz der Struktur mithilfe der DateTimeOffset angegebenen , , |
| DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) |
Initialisiert eine neue Instanz der Struktur mithilfe der angegebenen , , |
| DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) |
Initialisiert eine neue Instanz der Struktur mithilfe der angegebenen , , |
| DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) |
Initialisiert eine neue Instanz der Struktur mithilfe der angegebenen , , |
| DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) |
Initialisiert eine neue Instanz der Struktur mithilfe der DateTimeOffset angegebenen , , |
DateTimeOffset(DateTime)
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
Initialisiert eine neue Instanz der DateTimeOffset Struktur mithilfe 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
Das Datum und die Uhrzeit der koordinierten Weltzeit (Coordinated Universal Time, UTC), die aus der Anwendung des Offsets resultiert, ist früher als DateTimeOffset.MinValue.
-oder-
Das UTC-Datum und die Uhrzeit, die aus der Anwendung des Offsets resultiert, ist später 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 DateTime.Kind ist DateTimeKind.Utc, wird die DateTime Eigenschaft der neuen Instanz auf den Wert festgelegt
dateTime, und die Offset Eigenschaft wird auf "gleich" Zerofestgelegt.Ist der Wert oder DateTime.KindDateTimeKind.LocalDateTimeKind.Unspecified, wird die DateTime Eigenschaft der neuen Instanz gleich
dateTimefestgelegt, und die Offset Eigenschaft wird auf den Offset der aktuellen Zeitzone des lokalen Systems festgelegt.
Weitere Informationen
Gilt für:
DateTimeOffset(DateTime, TimeSpan)
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
Initialisiert eine neue Instanz der DateTimeOffset Struktur mit dem angegebenen DateTime Wert und offset.
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 Zeitversatz von koordinierter Weltzeit (UTC).
Ausnahmen
dateTime.Kind
Utc ist gleich null und offset nicht gleich Null.
-oder-
dateTime.Kind
Local entspricht und offset entspricht nicht dem Offset der lokalen Zeitzone des Systems.
-oder-
offset wird in ganzen Minuten nicht angegeben.
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 Sie ein DateTimeOffset Objekt mit einem Datum und einer Uhrzeit initialisieren und den Offset der lokalen Zeitzone, wenn diese Zeitzone im Voraus nicht 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 Kind des Werts ist DateTimeKind.Utc, muss der Wert des
offsetParameters 0 oder ein ArgumentException Auslösen sein.Wenn der Wert Kind ist DateTimeKind.Local, muss der Wert des
offsetParameters dem Offset der lokalen Zeitzone von koordinierter Weltzeit (UTC) für dieses bestimmte Datum oder einen ArgumentException Auslösen entsprechen.Wenn der Wert Kind des Werts ist DateTimeKind.Unspecified, kann der
offsetParameter einen beliebigen gültigen Wert aufweisen.
Weitere Informationen
Gilt für:
DateTimeOffset(Int64, TimeSpan)
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
Initialisiert eine neue Instanz der DateTimeOffset Struktur mithilfe der angegebenen Anzahl von ticks und 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
Datum und Uhrzeit, ausgedrückt als Anzahl von 100-Nanosekunden-Intervallen, die seit 12:00:00 Mitternacht am 1. Januar 0001 verstrichen sind.
- offset
- TimeSpan
Der Zeitversatz von koordinierter Weltzeit (UTC).
Ausnahmen
offset wird in ganzen Minuten nicht angegeben.
Die UtcDateTime Eigenschaft ist vor 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 der Teilstriche in einem beliebigen Datum (in diesem Fall, 16. Juli 2007, um 1:32 Uhr) mit einem Offset von -5 initialisiert 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
Ordinarily, trying to call the DateTimeOffset constructor to instanziate a DateTimeOffset value with a local time and an offset other than that of the local time zone throws an ArgumentException. 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 notwendigerweise die 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
Gilt für:
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
Initialisiert eine neue Instanz der Struktur mithilfe des DateTimeOffset 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 Zeitversatz von koordinierter Weltzeit (UTC).
Gilt für:
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
Initialisiert eine neue Instanz der Struktur mithilfe der DateTimeOffset angegebenen , , month, , day, hour, minute, , , secondund offsetyear.
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 Zeitversatz von koordinierter Weltzeit (UTC).
Ausnahmen
offset stellt nicht ganze Minuten dar.
year ist kleiner als ein oder mehr als 9999.
-oder-
month ist kleiner als ein oder größer als 12.
-oder-
day ist kleiner als ein oder größer als die Anzahl der Tage in month.
-oder-
hour ist kleiner als null oder größer als 23.
-oder-
minute ist kleiner als 0 oder größer als 59.
-oder-
second ist kleiner als 0 oder größer als 59.
-oder-
offset ist kleiner als -14 Stunden oder größer als 14 Stunden.
-oder-
Die UtcDateTime Eigenschaft ist vor 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, und monthday als Jahr, Monat und Tag im gregorianischen Kalender. Rufen Sie den DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) Konstruktor auf, um einen DateTimeOffset Wert mithilfe von Jahr, Monat und Tag in einem anderen Kalender zu instanziieren.
Weitere Informationen
Gilt für:
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
Initialisiert eine neue Instanz der Struktur mithilfe der angegebenen , , month, , day, hour, minute, second, , , und . millisecondoffsetyearDateTimeOffset
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 Zeitversatz von koordinierter Weltzeit (UTC).
Ausnahmen
offset stellt nicht ganze Minuten dar.
year ist kleiner als ein oder mehr als 9999.
-oder-
month ist kleiner als ein oder größer als 12.
-oder-
day ist kleiner als ein oder größer als die Anzahl der Tage in month.
-oder-
hour ist kleiner als null oder größer als 23.
-oder-
minute ist kleiner als 0 oder größer als 59.
-oder-
second ist kleiner als 0 oder größer als 59.
-oder-
millisecond ist kleiner als 0 oder größer als 999.
-oder-
offset ist kleiner als -14 oder größer als 14.
-oder-
Die UtcDateTime Eigenschaft ist vor 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
Dieser Konstruktor interpretiert year, und monthday als Jahr, Monat und Tag im gregorianischen Kalender. Rufen Sie den DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) Konstruktor auf, um einen DateTimeOffset Wert mithilfe von Jahr, Monat und Tag in einem anderen Kalender zu instanziieren.
Weitere Informationen
Gilt für:
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
Initialisiert eine neue Instanz der Struktur mithilfe der angegebenen , , month, , day, hour, minute, secondmillisecond, , und offsetcalendar.yearDateTimeOffset
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 verwendet wird, um zu interpretieren year, monthund day.
- offset
- TimeSpan
Der Zeitversatz von koordinierter Weltzeit (UTC).
Ausnahmen
offset stellt nicht ganze Minuten dar.
calendar darf nicht null sein.
year ist kleiner als die calendarMinSupportedDateTime.Year Parameter oder größer als MaxSupportedDateTime.Year.
-oder-
month ist entweder kleiner als oder größer als die Anzahl der Monate in year der calendar.
-oder-
day ist kleiner als ein oder größer als die Anzahl der Tage in month.
-oder-
hour ist kleiner als null oder größer als 23.
-oder-
minute ist kleiner als 0 oder größer als 59.
-oder-
second ist kleiner als 0 oder größer als 59.
-oder-
millisecond ist kleiner als 0 oder größer als 999.
-oder-
offset ist kleiner als -14 Stunden oder größer als 14 Stunden.
-oder-
Die yearParameter und monthDie day Parameter können nicht als Datums- und Uhrzeitwert dargestellt werden.
-oder-
Die UtcDateTime Eigenschaft ist vor 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 instanziieren zu können. Dieses Datum wird dann mithilfe der entsprechenden Kalender und des gregorianischen Kalenders in der Konsole 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, secondmillisecondhourminuteund die Parameter spiegeln werte in dem durch den calendar Parameter angegebenen Kalender wider. Eine Ausnahme wird ausgelöst, wenn diese Werte ein Datum und eine Uhrzeit bilden, die nicht mithilfe dieses Kalenders ausgedrückt werden kann.
Wichtig
Äran in den japanischen Kalendern basieren auf der Herrschaft des Kaisers und werden daher voraussichtlich geändert. Beispielsweise markierte der 1. Mai 2019 den Anfang der Reiwa-Ära in der JapaneseCalendar und JapaneseLunisolarCalendar. Eine solche Änderung des Zeitalters wirkt sich auf alle Anwendungen aus, die diese Kalender verwenden. Unter Handling a new era in the Japanese calendar in .NET (Umgang mit einem neuen Zeitabschnitt im japanischen Kalender in .NET) finden Sie weitere Informationen und wie Sie bestimmen können, ob Ihre Anwendungen ebenfalls betroffen sind. Informationen zum Testen Ihrer Anwendungen auf Windows-Systemen, um ihre Bereitschaft für die Änderung der Ära sicherzustellen, finden Sie unter "Vorbereiten Ihrer Anwendung für die Änderung im japanischen Zeitalter". Features in .NET, die Kalender mit mehreren Epochen unterstützen und bewährte Methoden beim Arbeiten mit Kalendern, die mehrere Epochen unterstützen, finden Sie unter Arbeiten mit Eras.
Weitere Informationen
Gilt für:
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
Initialisiert eine neue Instanz der Struktur mithilfe der angegebenen , , month, , day, hour, minute, secondmillisecond, , und offsetmicrosecond.yearDateTimeOffset
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 Zeitversatz von koordinierter Weltzeit (UTC).
Ausnahmen
offset stellt nicht ganze Minuten dar.
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 oder größer als 23.
-oder-
minute ist kleiner als 0 oder größer als 59.
-oder-
second ist kleiner als 0 oder größer als 59.
-oder-
millisecond ist kleiner als 0 oder größer als 999.
-oder-
microsecond ist kleiner als 0 oder größer als 999.
Hinweise
Dieser Konstruktor interpretiert und monthday als yearJahr, Monat und Tag im gregorianischen Kalender. Rufen Sie den DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) 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)
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
- Quelle:
- DateTimeOffset.cs
Initialisiert eine neue Instanz der Struktur mithilfe der DateTimeOffset angegebenen , , month, , day, hour, minute, second, millisecondcalendarmicrosecondund offset.year
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 verwendet wird, um zu interpretieren year, monthund day.
- offset
- TimeSpan
Der Zeitversatz von koordinierter Weltzeit (UTC).
Ausnahmen
offset stellt nicht ganze Minuten dar.
year befindet sich nicht im bereich, der von calendar.
-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 oder größer als 23.
-oder-
minute ist kleiner als 0 oder größer als 59.
-oder-
second ist kleiner als 0 oder größer als 59.
-oder-
millisecond ist kleiner als 0 oder größer als 999.
-oder-
microsecond ist kleiner als 0 oder größer als 999.
-oder-
offset ist kleiner als -14 Stunden oder größer als 14 Stunden.
-oder-
Die yearParameter und monthDie day Parameter können nicht als Datums- und Uhrzeitwert dargestellt werden.
-oder-
Die UtcDateTime Eigenschaft ist früher als MinValue oder höher als MaxValue.
Hinweise
Dieser Konstruktor interpretiert und monthday als yearJahr, Monat und Tag im gregorianischen Kalender. Rufen Sie den DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) Konstruktor auf, um einen DateTimeOffset Wert mithilfe von Jahr, Monat und Tag in einem anderen Kalender zu instanziieren.