DateTimeOffset Constructors

Definitie

Initialiseert een nieuw exemplaar van de DateTimeOffset structuur.

Overloads

Name Description
DateTimeOffset(DateTime)

Initialiseert een nieuw exemplaar van de DateTimeOffset structuur met behulp van de opgegeven DateTime waarde.

DateTimeOffset(DateTime, TimeSpan)

Initialiseert een nieuw exemplaar van de DateTimeOffset structuur met behulp van de opgegeven DateTime waarde en offset.

DateTimeOffset(Int64, TimeSpan)

Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van ticks het opgegeven aantal en offset.

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van de opgegeven date, timeen offset.

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

Initialiseert een nieuw exemplaar van de DateTimeOffset structuur met behulp van de opgegeven year, , monthday, hour, minute, , seconden offset.

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

Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van de opgegeven year, , month, dayhourminute, , second, , en millisecondoffset.

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

Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van de opgegeven year, , monthdayhourminutesecond, milliseconden . calendaroffset

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

Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van de opgegeven year, , monthdayhourminutesecond, milliseconden . microsecondoffset

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

Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van de opgegeven year, , month, day, minutehour, second, millisecond, , microseconden offsetcalendar.

DateTimeOffset(DateTime)

Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs

Initialiseert een nieuw exemplaar van de DateTimeOffset structuur met behulp van de opgegeven DateTime waarde.

public:
 DateTimeOffset(DateTime dateTime);
public DateTimeOffset(DateTime dateTime);
new DateTimeOffset : DateTime -> DateTimeOffset
Public Sub New (dateTime As DateTime)

Parameters

dateTime
DateTime

Een datum en tijd.

Uitzonderingen

De utc-datum en -tijd (Coordinated Universal Time) die het resultaat zijn van het toepassen van de offset, is eerder dan DateTimeOffset.MinValue.

– of –

De UTC-datum en -tijd die het resultaat zijn van het toepassen van de offset, is later dan DateTimeOffset.MaxValue.

Voorbeelden

In het volgende voorbeeld ziet u hoe de waarde van de DateTime.Kind eigenschap van de dateTime parameter van invloed is op de datum- en tijdwaarde die wordt geretourneerd door deze 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
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

Opmerkingen

Het gedrag van deze constructor is afhankelijk van de waarde van de DateTime.Kind eigenschap van de dateTime parameter:

Zie ook

Van toepassing op

DateTimeOffset(DateTime, TimeSpan)

Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs

Initialiseert een nieuw exemplaar van de DateTimeOffset structuur met behulp van de opgegeven DateTime waarde en 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)

Parameters

dateTime
DateTime

Een datum en tijd.

offset
TimeSpan

De tijdsverschil van Coordinated Universal Time (UTC).

Uitzonderingen

dateTime.Kind is Utc gelijk aan en offset is niet gelijk aan nul.

– of –

dateTime.Kind Local is gelijk aan en offset is niet gelijk aan de verschuiving van de lokale tijdzone van het systeem.

– of –

offset wordt niet in hele minuten opgegeven.

offset is minder dan -14 uur of langer dan 14 uur.

– of –

UtcDateTime is kleiner dan DateTimeOffset.MinValue of hoger dan DateTimeOffset.MaxValue.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een DateTimeOffset object initialiseert met een datum en tijd en de offset van de lokale tijdzone wanneer die tijdzone niet van tevoren bekend is.

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

Opmerkingen

Het gedrag van deze constructor is deels afhankelijk van de waarde van de Kind eigenschap van de dateTime parameter:

Zie ook

Van toepassing op

DateTimeOffset(Int64, TimeSpan)

Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs

Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van ticks het opgegeven aantal en 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)

Parameters

ticks
Int64

Een datum en tijd uitgedrukt als het aantal intervallen van 100 nanoseconden die zijn verstreken sinds 12:00:00 middernacht op 1 januari 0001.

offset
TimeSpan

De tijdsverschil van Coordinated Universal Time (UTC).

Uitzonderingen

offset wordt niet in hele minuten opgegeven.

De UtcDateTime eigenschap is ouder dan DateTimeOffset.MinValue of hoger dan DateTimeOffset.MaxValue.

– of –

ticks is kleiner dan DateTimeOffset.MinValue.Ticks of groter dan DateTimeOffset.MaxValue.Ticks.

– of –

offset is minder dan -14 uur of langer dan 14 uur.

Voorbeelden

In het volgende voorbeeld wordt een DateTimeOffset object geïnitialiseerd met behulp van het aantal tikken in een willekeurige datum (in dit geval 16 juli 2007 om 13:32 uur) met een offset van -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
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

Opmerkingen

Normaal gesproken probeert de DateTimeOffset constructor een waarde te instantiëren DateTimeOffset met een lokale tijd en een andere offset dan die van de lokale tijdzone genereert een ArgumentException. U kunt deze overbelasting van de DateTimeOffset constructor gebruiken om deze beperking te omzeilen. In het volgende voorbeeld wordt het aantal tikken van de lokale tijd gebruikt om een DateTimeOffset waarde te instantiëren waarvan de verschuiving niet noodzakelijkerwijs overeenkomt met die van de lokale tijd:

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

Zie ook

Van toepassing op

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs

Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van de opgegeven date, timeen 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)

Parameters

date
DateOnly

Het datumgedeelte.

time
TimeOnly

Het tijdgedeelte.

offset
TimeSpan

De tijdsverschil van Coordinated Universal Time (UTC).

Van toepassing op

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

Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs

Initialiseert een nieuw exemplaar van de DateTimeOffset structuur met behulp van de opgegeven year, , monthday, hour, minute, , seconden 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)

Parameters

year
Int32

Het jaar (1 tot en met 9999).

month
Int32

De maand (1 tot en met 12).

day
Int32

De dag (1 tot en met het aantal dagen in month).

hour
Int32

De uren (0 tot en met 23).

minute
Int32

De minuten (0 tot en met 59).

second
Int32

De seconden (0 tot en met 59).

offset
TimeSpan

De tijdsverschil van Coordinated Universal Time (UTC).

Uitzonderingen

offset vertegenwoordigt geen hele minuten.

year is kleiner dan een of meer dan 9999.

– of –

month is kleiner dan een of meer dan 12.

– of –

day is kleiner dan een of meer dagen dan het aantal dagen in month.

– of –

hour is kleiner dan nul of groter dan 23.

– of –

minute is kleiner dan 0 of groter dan 59.

– of –

second is kleiner dan 0 of groter dan 59.

– of –

offset is minder dan -14 uur of langer dan 14 uur.

– of –

De UtcDateTime eigenschap is ouder dan DateTimeOffset.MinValue of hoger dan DateTimeOffset.MaxValue.

Voorbeelden

In het volgende voorbeeld wordt een DateTimeOffset object geïnstitueerd met behulp van de overbelasting van de DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) constructor.

   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

Opmerkingen

Deze constructor interpreteert year, monthen day als een jaar, maand en dag in de Gregoriaanse kalender. Als u een DateTimeOffset waarde wilt instantiëren met behulp van het jaar, de maand en de dag in een andere kalender, roept u de DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructor aan.

Zie ook

Van toepassing op

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

Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs

Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van de opgegeven year, , month, dayhourminute, , second, , en millisecondoffset.

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)

Parameters

year
Int32

Het jaar (1 tot en met 9999).

month
Int32

De maand (1 tot en met 12).

day
Int32

De dag (1 tot en met het aantal dagen in month).

hour
Int32

De uren (0 tot en met 23).

minute
Int32

De minuten (0 tot en met 59).

second
Int32

De seconden (0 tot en met 59).

millisecond
Int32

De milliseconden (0 tot en met 999).

offset
TimeSpan

De tijdsverschil van Coordinated Universal Time (UTC).

Uitzonderingen

offset vertegenwoordigt geen hele minuten.

year is kleiner dan een of meer dan 9999.

– of –

month is kleiner dan een of meer dan 12.

– of –

day is kleiner dan een of meer dagen dan het aantal dagen in month.

– of –

hour is kleiner dan nul of groter dan 23.

– of –

minute is kleiner dan 0 of groter dan 59.

– of –

second is kleiner dan 0 of groter dan 59.

– of –

millisecond is kleiner dan 0 of groter dan 999.

– of –

offset is kleiner dan -14 of groter dan 14.

– of –

De UtcDateTime eigenschap is ouder dan DateTimeOffset.MinValue of hoger dan DateTimeOffset.MaxValue.

Voorbeelden

In het volgende voorbeeld wordt een DateTimeOffset object geïnstitueerd met behulp van de overbelasting van de DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) constructor.

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

Opmerkingen

Deze constructor interpreteert year, monthen day als een jaar, maand en dag in de Gregoriaanse kalender. Als u een DateTimeOffset waarde wilt instantiëren met behulp van het jaar, de maand en de dag in een andere kalender, roept u de DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructor aan.

Zie ook

Van toepassing op

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

Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs

Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van de opgegeven year, , monthdayhourminutesecond, milliseconden . calendaroffset

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)

Parameters

year
Int32

Het jaar.

month
Int32

De maand (1 tot en met 12).

day
Int32

De dag (1 tot en met het aantal dagen in month).

hour
Int32

De uren (0 tot en met 23).

minute
Int32

De minuten (0 tot en met 59).

second
Int32

De seconden (0 tot en met 59).

millisecond
Int32

De milliseconden (0 tot en met 999).

calendar
Calendar

De kalender die wordt gebruikt om te interpreteren year, monthen day.

offset
TimeSpan

De tijdsverschil van Coordinated Universal Time (UTC).

Uitzonderingen

offset vertegenwoordigt geen hele minuten.

calendar kan niet zijn null.

year is kleiner dan de calendar parameter MinSupportedDateTime.Year of groter dan MaxSupportedDateTime.Year.

– of –

month is kleiner dan of groter dan het aantal maanden in year de calendar.

– of –

day is kleiner dan een of meer dagen dan het aantal dagen in month.

– of –

hour is kleiner dan nul of groter dan 23.

– of –

minute is kleiner dan 0 of groter dan 59.

– of –

second is kleiner dan 0 of groter dan 59.

– of –

millisecond is kleiner dan 0 of groter dan 999.

– of –

offset is minder dan -14 uur of langer dan 14 uur.

– of –

De year, monthen day parameters kunnen niet worden weergegeven als een datum- en tijdwaarde.

– of –

De UtcDateTime eigenschap is ouder dan DateTimeOffset.MinValue of hoger dan DateTimeOffset.MaxValue.

Voorbeelden

In het volgende voorbeeld worden exemplaren van zowel de HebrewCalendar klasse als de HijriCalendar klasse gebruikt om een DateTimeOffset waarde te instantiëren. Deze datum wordt vervolgens weergegeven in de console met behulp van de respectieve kalenders en de Gregoriaanse kalender.

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

Opmerkingen

De yearparameters , , monthday, hour, en minutesecondmillisecondparameters weerspiegelen allemaal waarden die zijn uitgedrukt in de kalender die is opgegeven door de calendar parameter. Er wordt een uitzondering gegenereerd als deze waarden een datum en tijd vormen die niet kunnen worden uitgedrukt met behulp van deze kalender.

Important

Tijdperken in de Japanse kalenders zijn gebaseerd op het keizerrijk en zullen daarom naar verwachting veranderen. Bijvoorbeeld: 1 mei 2019 markeerde het begin van het Reiwa-tijdperk in de JapaneseCalendar en JapaneseLunisolarCalendar. Een dergelijke wijziging van het tijdperk is van invloed op alle toepassingen die gebruikmaken van deze agenda's. Zie Verwerken van een nieuw tijdperk in de Japanse kalender in .NET voor meer informatie en om te bepalen of uw toepassingen worden beïnvloed. Zie Uw toepassing voorbereiden voor de wijziging in het Japanse tijdperk voor informatie over het testen van uw toepassingen op Windows-systemen om ervoor te zorgen dat deze gereed zijn voor de wijziging van het tijdperk. Zie Werken met tijdperken voor functies in .NET die agenda's met meerdere tijdperken ondersteunen en voor aanbevolen procedures bij het werken met agenda's die meerdere tijdperken ondersteunen.

Zie ook

Van toepassing op

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

Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs

Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van de opgegeven year, , monthdayhourminutesecond, milliseconden . microsecondoffset

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)

Parameters

year
Int32

Het jaar (1 tot en met 9999).

month
Int32

De maand (1 tot en met 12).

day
Int32

De dag (1 tot en met het aantal dagen in month).

hour
Int32

De uren (0 tot en met 23).

minute
Int32

De minuten (0 tot en met 59).

second
Int32

De seconden (0 tot en met 59).

millisecond
Int32

De milliseconden (0 tot en met 999).

microsecond
Int32

De microseconden (0 tot en met 999).

offset
TimeSpan

De tijdsverschil van Coordinated Universal Time (UTC).

Uitzonderingen

offset vertegenwoordigt geen hele minuten.

year is kleiner dan 1 of groter dan 9999.

– of –

month is kleiner dan 1 of groter dan 12.

– of –

day is kleiner dan 1 of groter dan het aantal dagen in month.

– of –

hour is kleiner dan 0 of groter dan 23.

– of –

minute is kleiner dan 0 of groter dan 59.

– of –

second is kleiner dan 0 of groter dan 59.

– of –

millisecond is kleiner dan 0 of groter dan 999.

– of –

microsecond is kleiner dan 0 of groter dan 999.

Opmerkingen

Deze constructor interpreteert year, month en day als een jaar, maand en dag in de Gregoriaanse kalender. Als u een DateTimeOffset waarde wilt instantiëren met behulp van het jaar, de maand en de dag in een andere kalender, roept u de DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructor aan.

Van toepassing op

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

Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs
Bron:
DateTimeOffset.cs

Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van de opgegeven year, , month, day, minutehour, second, millisecond, , microseconden offsetcalendar.

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)

Parameters

year
Int32

Het jaar (1 tot en met 9999).

month
Int32

De maand (1 tot en met 12).

day
Int32

De dag (1 tot en met het aantal dagen in month).

hour
Int32

De uren (0 tot en met 23).

minute
Int32

De minuten (0 tot en met 59).

second
Int32

De seconden (0 tot en met 59).

millisecond
Int32

De milliseconden (0 tot en met 999).

microsecond
Int32

De microseconden (0 tot en met 999).

calendar
Calendar

De kalender die wordt gebruikt om te interpreteren year, monthen day.

offset
TimeSpan

De tijdsverschil van Coordinated Universal Time (UTC).

Uitzonderingen

offset vertegenwoordigt geen hele minuten.

year bevindt zich niet in het bereik dat wordt ondersteund door calendar.

– of –

month is kleiner dan 1 of groter dan het aantal maanden in calendar.

– of –

day is kleiner dan 1 of groter dan het aantal dagen in month.

– of –

hour is kleiner dan 0 of groter dan 23.

– of –

minute is kleiner dan 0 of groter dan 59.

– of –

second is kleiner dan 0 of groter dan 59.

– of –

millisecond is kleiner dan 0 of groter dan 999.

– of –

microsecond is kleiner dan 0 of groter dan 999.

– of –

offset is minder dan -14 uur of langer dan 14 uur.

– of –

De year, monthen day parameters kunnen niet worden weergegeven als een datum- en tijdwaarde.

– of –

De UtcDateTime eigenschap is ouder dan MinValue of later dan MaxValue.

Opmerkingen

Deze constructor interpreteert year, month en day als een jaar, maand en dag in de Gregoriaanse kalender. Als u een DateTimeOffset waarde wilt instantiëren met behulp van het jaar, de maand en de dag in een andere kalender, roept u de DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) constructor aan.

Van toepassing op