DateTimeOffset Constructors
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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 |
| DateTimeOffset(Int64, TimeSpan) |
Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van |
| DateTimeOffset(DateOnly, TimeOnly, TimeSpan) |
Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van de opgegeven |
| DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) |
Initialiseert een nieuw exemplaar van de DateTimeOffset structuur met behulp van de opgegeven |
| DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) |
Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van de opgegeven |
| DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) |
Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van de opgegeven |
| DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) |
Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van de opgegeven |
| DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) |
Initialiseert een nieuwe instantie van de DateTimeOffset structuur met behulp van de opgegeven |
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:
Als de waarde DateTime.Kind is DateTimeKind.Utc, wordt de DateTime eigenschap van het nieuwe exemplaar ingesteld op
dateTimeen wordt de Offset eigenschap gelijk aan Zeroingesteld.Als de waarde DateTime.Kind van is DateTimeKind.Local of DateTimeKind.Unspecified, wordt de DateTime eigenschap van het nieuwe exemplaar gelijk
dateTimeaan ingesteld en wordt de Offset eigenschap gelijk aan de verschuiving van de huidige tijdzone van het lokale systeem ingesteld.
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:
Als de waarde Kind is DateTimeKind.Utc, moet de waarde van de
offsetparameter 0 zijn of wordt er een ArgumentException gegenereerd.Als de waarde Kind is DateTimeKind.Local, moet de waarde van de
offsetparameter gelijk zijn aan de verschuiving van de lokale tijdzone ten opzichte van Coordinated Universal Time (UTC) voor die specifieke datum of wordt er een ArgumentException gegenereerd.Als de waarde Kind is DateTimeKind.Unspecified, kan de
offsetparameter een geldige waarde hebben.
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.