DateTimeOffset Konstruktory
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Inicjuje DateTimeOffset nowe wystąpienie struktury.
Przeciążenia
DateTimeOffset(DateTime) |
Inicjuje nowe wystąpienie DateTimeOffset struktury przy użyciu określonej DateTime wartości. |
DateTimeOffset(DateTime, TimeSpan) |
Inicjuje DateTimeOffset nowe wystąpienie struktury przy użyciu określonej DateTime wartości i przesunięcia. |
DateTimeOffset(Int64, TimeSpan) |
Inicjuje nowe wystąpienie DateTimeOffset struktury przy użyciu określonej liczby znaczników i przesunięcia. |
DateTimeOffset(DateOnly, TimeOnly, TimeSpan) |
Inicjuje nowe wystąpienie DateTimeOffset struktury przy użyciu określonych |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) |
Inicjuje nowe wystąpienie struktury przy użyciu określonego DateTimeOffset roku, miesiąca, dnia, godziny, minuty, sekundy i przesunięcia. |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) |
Inicjuje nowe wystąpienie struktury przy użyciu określonego DateTimeOffset roku, miesiąca, dnia, godziny, minuty, sekundy, milisekundy i przesunięcia. |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) |
Inicjuje nowe wystąpienie struktury przy użyciu określonego DateTimeOffset roku, miesiąca, dnia, godziny, minuty, sekundy, milisekundy i przesunięcia określonego kalendarza. |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) |
Inicjuje nowe wystąpienie struktury przy użyciu określonego DateTimeOffset |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) |
Inicjuje nowe wystąpienie struktury przy użyciu określonego DateTimeOffset |
DateTimeOffset(DateTime)
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
Inicjuje nowe wystąpienie DateTimeOffset struktury przy użyciu określonej DateTime wartości.
public:
DateTimeOffset(DateTime dateTime);
public DateTimeOffset (DateTime dateTime);
new DateTimeOffset : DateTime -> DateTimeOffset
Public Sub New (dateTime As DateTime)
Parametry
- dateTime
- DateTime
Data i godzina.
Wyjątki
Data i godzina uniwersalnego czasu koordynowanego (UTC) wynikające z zastosowania przesunięcia jest wcześniejsza niż DateTimeOffset.MinValue.
-lub-
Data i godzina UTC wynikające z zastosowania przesunięcia jest późniejsza niż DateTimeOffset.MaxValue.
Przykłady
W poniższym przykładzie pokazano, jak wartość DateTime.Kind właściwości dateTime
parametru wpływa na wartość daty i godziny zwracanej przez ten konstruktor.
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
Uwagi
Zachowanie tego konstruktora zależy od wartości DateTime.Kind właściwości parametru dateTime
:
Jeśli wartość DateTime.Kind to DateTimeKind.Utc, DateTime właściwość nowego wystąpienia jest ustawiona na wartość
dateTime
, a Offset właściwość jest ustawiona na Zerowartość .Jeśli wartość to lub , DateTime właściwość nowego wystąpienia jest równa
dateTime
, a właściwość jest ustawiona na wartość , a Offset właściwość jest ustawiona na przesunięcie bieżącej strefy czasowej systemu lokalnegoDateTimeKind.Unspecified.DateTimeKind.LocalDateTime.Kind
Zobacz też
Dotyczy
DateTimeOffset(DateTime, TimeSpan)
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
Inicjuje DateTimeOffset nowe wystąpienie struktury przy użyciu określonej DateTime wartości i przesunięcia.
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)
Parametry
- dateTime
- DateTime
Data i godzina.
- offset
- TimeSpan
Przesunięcie czasu od skoordynowanego czasu uniwersalnego (UTC).
Wyjątki
dateTime.Kind
równa Utc się i offset
nie równa się zero.
-lub-
dateTime.Kind
Local równa się i offset
nie odpowiada przesunięciom lokalnej strefy czasowej systemu.
-lub-
offset
nie jest określony w ciągu całych minut.
offset
wartość jest mniejsza niż -14 godzin lub większa niż 14 godzin.
-lub-
UtcDateTime parametr jest mniejszy niż DateTimeOffset.MinValue lub większy niż DateTimeOffset.MaxValue.
Przykłady
W poniższym przykładzie pokazano, jak zainicjować DateTimeOffset obiekt z datą i godziną oraz przesunięciem lokalnej strefy czasowej, gdy ta strefa czasowa nie jest wcześniej znana.
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
Uwagi
Zachowanie tego konstruktora zależy częściowo od wartości Kind właściwości parametru dateTime
:
Jeśli wartość parametru Kind to DateTimeKind.Utc, wartość parametru
offset
musi wynosić 0 lub ArgumentException jest zgłaszana.Jeśli wartość KindDateTimeKind.Localto , wartość parametru
offset
musi być równa przesunięciom lokalnej strefy czasowej z uniwersalnego czasu koordynowanego (UTC) dla tej konkretnej daty lub ArgumentException jest zgłaszana wartość .Jeśli wartość Kind to DateTimeKind.Unspecified,
offset
parametr może mieć dowolną prawidłową wartość.
Zobacz też
Dotyczy
DateTimeOffset(Int64, TimeSpan)
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
Inicjuje nowe wystąpienie DateTimeOffset struktury przy użyciu określonej liczby znaczników i przesunięcia.
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)
Parametry
- ticks
- Int64
Data i godzina wyrażona jako liczba 100-nanosekundowych interwałów, które upłynęły od 12:00:00 północy 1 stycznia 0001 r.
- offset
- TimeSpan
Przesunięcie czasu od skoordynowanego czasu uniwersalnego (UTC).
Wyjątki
offset
nie jest określony w ciągu całych minut.
Właściwość UtcDateTime jest wcześniejsza niż DateTimeOffset.MinValue lub nowsza niż DateTimeOffset.MaxValue.
-lub-
ticks
wartość jest mniejsza niż DateTimeOffset.MinValue.Ticks
lub większa niż DateTimeOffset.MaxValue.Ticks
.
-lub-
Offset
mniejsza niż -14 godzin lub większa niż 14 godzin.
Przykłady
Poniższy przykład inicjuje DateTimeOffset obiekt przy użyciu liczby kleszczy w dowolnej dacie (w tym przypadku 16 lipca 2007 r., o 13:32) z przesunięciem -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
Uwagi
Zwykle próbuje wywołać konstruktora DateTimeOffset , aby utworzyć DateTimeOffset wystąpienie wartości w czasie lokalnym i przesunięcie inne niż w lokalnej strefie czasowej zgłasza błąd ArgumentException. Tego przeciążenia konstruktora DateTimeOffset można użyć do obejścia tego ograniczenia. W poniższym przykładzie użyto liczby znaczników czasu lokalnego do utworzenia wystąpienia DateTimeOffset wartości, której przesunięcie niekoniecznie reprezentuje czas lokalny:
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
Zobacz też
Dotyczy
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
Inicjuje nowe wystąpienie DateTimeOffset struktury przy użyciu określonych date
elementów , time
i 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)
Parametry
- date
- DateOnly
Część daty.
- time
- TimeOnly
Część czasowa.
- offset
- TimeSpan
Przesunięcie czasu od skoordynowanego czasu uniwersalnego (UTC).
Dotyczy
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
Inicjuje nowe wystąpienie struktury przy użyciu określonego DateTimeOffset roku, miesiąca, dnia, godziny, minuty, sekundy i przesunięcia.
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)
Parametry
- year
- Int32
Rok (od 1 do 9999).
- month
- Int32
Miesiąc (od 1 do 12).
- day
- Int32
Dzień (od 1 do liczby dni w ciągu month
).
- hour
- Int32
Godziny (od 0 do 23).
- minute
- Int32
Minuty (od 0 do 59).
- second
- Int32
Liczba sekund (od 0 do 59).
- offset
- TimeSpan
Przesunięcie czasu od skoordynowanego czasu uniwersalnego (UTC).
Wyjątki
offset
nie reprezentuje całych minut.
year
jest mniejszy niż jeden lub większy niż 9999.
-lub-
month
wartość jest mniejsza niż jedna lub większa niż 12.
-lub-
day
wartość jest mniejsza niż jedna lub większa niż liczba dni w ciągu month
.
-lub-
hour
wartość jest mniejsza niż zero lub większa niż 23.
-lub-
minute
wartość jest mniejsza niż 0 lub większa niż 59.
-lub-
second
wartość jest mniejsza niż 0 lub większa niż 59.
-lub-
offset
wartość jest mniejsza niż -14 godzin lub większa niż 14 godzin.
-lub-
Właściwość UtcDateTime jest wcześniejsza niż DateTimeOffset.MinValue lub nowsza niż DateTimeOffset.MaxValue.
Przykłady
Poniższy przykład tworzy wystąpienie DateTimeOffset obiektu przy użyciu przeciążenia konstruktora DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) .
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
Uwagi
Ten konstruktor interpretuje year
wartości , month
i day
jako rok, miesiąc i dzień w kalendarzu gregoriańskim. Aby utworzyć DateTimeOffset wystąpienie wartości przy użyciu roku, miesiąca i dnia w innym kalendarzu, wywołaj DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) konstruktor.
Zobacz też
Dotyczy
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
Inicjuje DateTimeOffset nowe wystąpienie struktury przy użyciu określonego roku, miesiąca, dnia, godziny, minuty, sekundy, milisekund i przesunięcia.
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)
Parametry
- year
- Int32
Rok (od 1 do 9999).
- month
- Int32
Miesiąc (od 1 do 12).
- day
- Int32
Dzień (od 1 do liczby dni w month
ciągu ).
- hour
- Int32
Godziny (od 0 do 23).
- minute
- Int32
Minuty (od 0 do 59).
- second
- Int32
Liczba sekund (od 0 do 59).
- millisecond
- Int32
Milisekundy (od 0 do 999).
- offset
- TimeSpan
Przesunięcie czasu od skoordynowanego czasu uniwersalnego (UTC).
Wyjątki
offset
nie reprezentuje całych minut.
year
jest mniejszy niż jeden lub większy niż 9999.
-lub-
month
wartość jest mniejsza niż jedna lub większa niż 12.
-lub-
day
wartość jest mniejsza niż jedna lub większa niż liczba dni w month
ciągu .
-lub-
hour
wartość jest mniejsza niż zero lub większa niż 23.
-lub-
minute
wartość jest mniejsza niż 0 lub większa niż 59.
-lub-
second
wartość jest mniejsza niż 0 lub większa niż 59.
-lub-
millisecond
jest mniejsza niż 0 lub większa niż 999.
-lub-
offset
wartość jest mniejsza niż -14 lub większa niż 14.
-lub-
Właściwość UtcDateTime jest wcześniejsza niż DateTimeOffset.MinValue lub nowsza niż DateTimeOffset.MaxValue.
Przykłady
Poniższy przykład tworzy wystąpienie DateTimeOffset obiektu przy użyciu przeciążenia konstruktora DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) .
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
Uwagi
Ten konstruktor interpretuje year
wartości , month
i day
jako rok, miesiąc i dzień w kalendarzu gregoriańskim. Aby utworzyć DateTimeOffset wystąpienie wartości przy użyciu roku, miesiąca i dnia w innym kalendarzu, wywołaj DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) konstruktor.
Zobacz też
Dotyczy
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
Inicjuje DateTimeOffset nowe wystąpienie struktury przy użyciu określonego roku, miesiąca, dnia, godziny, minuty, sekundy, milisekund i przesunięcia określonego kalendarza.
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)
Parametry
- year
- Int32
Rok.
- month
- Int32
Miesiąc (od 1 do 12).
- day
- Int32
Dzień (od 1 do liczby dni w month
ciągu ).
- hour
- Int32
Godziny (od 0 do 23).
- minute
- Int32
Minuty (od 0 do 59).
- second
- Int32
Liczba sekund (od 0 do 59).
- millisecond
- Int32
Milisekundy (od 0 do 999).
- calendar
- Calendar
Kalendarz używany do interpretowania year
, month
i day
.
- offset
- TimeSpan
Przesunięcie czasu od skoordynowanego czasu uniwersalnego (UTC).
Wyjątki
offset
nie reprezentuje całych minut.
calendar
nie może być null
.
year
jest mniejszy niż calendar
parametr MinSupportedDateTime.Year
lub większy niż MaxSupportedDateTime.Year
.
-lub-
month
wartość jest mniejsza niż lub większa niż liczba miesięcy w year
obiekcie calendar
.
-lub-
day
wartość jest mniejsza niż jedna lub większa niż liczba dni w month
ciągu .
-lub-
hour
wartość jest mniejsza niż zero lub większa niż 23.
-lub-
minute
wartość jest mniejsza niż 0 lub większa niż 59.
-lub-
second
wartość jest mniejsza niż 0 lub większa niż 59.
-lub-
millisecond
jest mniejsza niż 0 lub większa niż 999.
-lub-
offset
wartość jest mniejsza niż -14 godzin lub większa niż 14 godzin.
-lub-
Parametrów year
, month
i day
nie można przedstawić jako wartości daty i godziny.
-lub-
Właściwość UtcDateTime jest wcześniejsza niż DateTimeOffset.MinValue lub nowsza niż DateTimeOffset.MaxValue.
Przykłady
W poniższym przykładzie użyto wystąpień klasy HebrewCalendar i HijriCalendar klasy w celu utworzenia DateTimeOffset wystąpienia wartości. Ta data jest następnie wyświetlana w konsoli przy użyciu odpowiednich kalendarzy i kalendarza gregoriańskiego.
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()
Uwagi
Parametry year
, month
, day
hour
second
minute
i millisecond
odzwierciedlają wartości wyrażone w kalendarzu calendar
określonym przez parametr . Wyjątek jest zgłaszany, jeśli te wartości tworzą datę i godzinę, której nie można wyrazić za pomocą tego kalendarza.
Ważne
Era w japońskich kalendarzach opiera się na panowaniu cesarza i dlatego oczekuje się, że się zmieni. Na przykład 1 maja 2019 r. oznaczyła początek ery Reiwa w JapaneseCalendar erze i JapaneseLunisolarCalendar. Taka zmiana ery wpływa na wszystkie aplikacje korzystające z tych kalendarzy. Aby uzyskać więcej informacji i określić, czy twoje aplikacje mają wpływ, zobacz Obsługa nowej ery w kalendarzu japońskim na platformie .NET. Aby uzyskać informacje na temat testowania aplikacji w systemach Windows w celu zapewnienia gotowości do zmiany epoki, zobacz Przygotowywanie aplikacji do japońskiej zmiany epoki. Aby uzyskać informacje o funkcjach na platformie .NET, które obsługują kalendarze z wieloma erami i najlepsze rozwiązania dotyczące pracy z kalendarzami obsługującymi wiele epok, zobacz Praca z erami.
Zobacz też
Dotyczy
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
Inicjuje DateTimeOffset nowe wystąpienie struktury przy użyciu określonego year
, , month
second
day
hour
minute
, millisecond
, microsecond
i .offset
public:
DateTimeOffset(int year, int month, int day, int hour, int minute, int second, int millisecond, int microsecond, TimeSpan offset);
public DateTimeOffset (int year, int month, int day, int hour, int minute, int second, int millisecond, int microsecond, TimeSpan offset);
new DateTimeOffset : int * int * int * int * int * int * int * int * TimeSpan -> DateTimeOffset
Public Sub New (year As Integer, month As Integer, day As Integer, hour As Integer, minute As Integer, second As Integer, millisecond As Integer, microsecond As Integer, offset As TimeSpan)
Parametry
- year
- Int32
Rok (od 1 do 9999).
- month
- Int32
Miesiąc (od 1 do 12).
- day
- Int32
Dzień (od 1 do liczby dni w month
ciągu ).
- hour
- Int32
Godziny (od 0 do 23).
- minute
- Int32
Minuty (od 0 do 59).
- second
- Int32
Liczba sekund (od 0 do 59).
- millisecond
- Int32
Milisekundy (od 0 do 999).
- microsecond
- Int32
Mikrosekundy (od 0 do 999).
- offset
- TimeSpan
Przesunięcie czasu od skoordynowanego czasu uniwersalnego (UTC).
Wyjątki
offset
nie reprezentuje całych minut.
year
jest mniejsza niż 1 lub większa niż 9999.
-lub-
month
jest mniejsza niż 1 lub większa niż 12.
-lub-
day
wartość jest mniejsza niż 1 lub większa niż liczba dni w month
ciągu .
-lub-
hour
jest mniejsza niż 0 lub większa niż 23.
-lub-
minute
wartość jest mniejsza niż 0 lub większa niż 59.
-lub-
second
wartość jest mniejsza niż 0 lub większa niż 59.
-lub-
millisecond
jest mniejsza niż 0 lub większa niż 999.
-lub-
microsecond
jest mniejsza niż 0 lub większa niż 999.
Uwagi
Ten konstruktor interpretuje year
wartości , month
a day
jako rok, miesiąc i dzień w kalendarzu gregoriańskim. Aby utworzyć DateTimeOffset wystąpienie wartości przy użyciu roku, miesiąca i dnia w innym kalendarzu, wywołaj DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) konstruktor.
Dotyczy
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
- Źródło:
- DateTimeOffset.cs
Inicjuje DateTimeOffset nowe wystąpienie struktury przy użyciu określonego year
, , month
second
day
hour
minute
, millisecond
, microsecond
i .offset
public:
DateTimeOffset(int year, int month, int day, int hour, int minute, int second, int millisecond, int microsecond, System::Globalization::Calendar ^ calendar, TimeSpan offset);
public DateTimeOffset (int year, int month, int day, int hour, int minute, int second, int millisecond, int microsecond, System.Globalization.Calendar calendar, TimeSpan offset);
new DateTimeOffset : int * int * int * int * int * int * int * int * System.Globalization.Calendar * TimeSpan -> DateTimeOffset
Public Sub New (year As Integer, month As Integer, day As Integer, hour As Integer, minute As Integer, second As Integer, millisecond As Integer, microsecond As Integer, calendar As Calendar, offset As TimeSpan)
Parametry
- year
- Int32
Rok (od 1 do 9999).
- month
- Int32
Miesiąc (od 1 do 12).
- day
- Int32
Dzień (od 1 do liczby dni w month
ciągu ).
- hour
- Int32
Godziny (od 0 do 23).
- minute
- Int32
Minuty (od 0 do 59).
- second
- Int32
Liczba sekund (od 0 do 59).
- millisecond
- Int32
Milisekundy (od 0 do 999).
- microsecond
- Int32
Mikrosekundy (od 0 do 999).
- calendar
- Calendar
Kalendarz używany do interpretowania year
, month
i day
.
- offset
- TimeSpan
Przesunięcie czasu od skoordynowanego czasu uniwersalnego (UTC).
Wyjątki
offset
nie reprezentuje całych minut.
year
nie znajduje się w zakresie obsługiwanym przez calendar
usługę .
-lub-
month
wartość jest mniejsza niż 1 lub większa niż liczba miesięcy w parametrze calendar
.
-lub-
day
wartość jest mniejsza niż 1 lub większa niż liczba dni w month
ciągu .
-lub-
hour
jest mniejsza niż 0 lub większa niż 23.
-lub-
minute
wartość jest mniejsza niż 0 lub większa niż 59.
-lub-
second
wartość jest mniejsza niż 0 lub większa niż 59.
-lub-
millisecond
jest mniejsza niż 0 lub większa niż 999.
-lub-
microsecond
jest mniejsza niż 0 lub większa niż 999.
-lub-
offset
wartość jest mniejsza niż -14 godzin lub większa niż 14 godzin.
-lub-
Parametrów year
, month
i day
nie można przedstawić jako wartości daty i godziny.
-lub-
Właściwość jest wcześniejsza niż MinValue lub nowsza UtcDateTime niż MaxValue.
Uwagi
Ten konstruktor interpretuje year
wartości , month
a day
jako rok, miesiąc i dzień w kalendarzu gregoriańskim. Aby utworzyć DateTimeOffset wystąpienie wartości przy użyciu roku, miesiąca i dnia w innym kalendarzu, wywołaj DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) konstruktor.
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla