DateTimeOffset Konstruktory

Odwołanie

Definicja

Przestrzeń nazw:: System

Zestaw:: System.Runtime.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

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 `date`elementów , `time`i `offset`.
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`year`elementu , , `month`, `hourdayminute`, , `second`, `millisecondmicrosecond` , i `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Inicjuje nowe wystąpienie struktury przy użyciu określonego DateTimeOffset`year`elementu , , `month`, `hourdayminute`, , `second`, `millisecondmicrosecond` , i `offset`.

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

ArgumentOutOfRangeException

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.Local DateTime.Kind

Zobacz też

Tworzenie wystąpienia obiektu DateTimeOffset

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

ArgumentException

dateTime.Kind równa Utc się i offset nie równa się zero.

-lub-

dateTime.KindLocal 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.

ArgumentOutOfRangeException

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ść Kind DateTimeKind.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ż

Tworzenie wystąpienia obiektu DateTimeOffset

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

ArgumentException

offset nie jest określony w ciągu całych minut.

ArgumentOutOfRangeException

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ż

Tworzenie wystąpienia obiektu DateTimeOffset

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 dateelementów , timei 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

ArgumentException

offset nie reprezentuje całych minut.

ArgumentOutOfRangeException

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 yearwartości , monthi 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ż

Tworzenie wystąpienia obiektu DateTimeOffset

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 monthcią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

ArgumentException

offset nie reprezentuje całych minut.

ArgumentOutOfRangeException

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 monthcią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

Zobacz też

Tworzenie wystąpienia obiektu DateTimeOffset

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 monthcią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, monthi day.

offset: TimeSpan

Przesunięcie czasu od skoordynowanego czasu uniwersalnego (UTC).

Wyjątki

ArgumentException

offset nie reprezentuje całych minut.

ArgumentNullException

calendar nie może być null.

ArgumentOutOfRangeException

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 monthcią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, monthi 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, dayhoursecondminutei 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ż

Tworzenie wystąpienia obiektu DateTimeOffset

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, , monthseconddayhourminute, 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 monthcią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

ArgumentException

offset nie reprezentuje całych minut.

ArgumentOutOfRangeException

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 monthcią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 yearwartoś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, , monthseconddayhourminute, 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 monthcią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, monthi day.

offset: TimeSpan

Przesunięcie czasu od skoordynowanego czasu uniwersalnego (UTC).

Wyjątki

ArgumentException

offset nie reprezentuje całych minut.

ArgumentOutOfRangeException

year nie znajduje się w zakresie obsługiwanym przez calendarusł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 monthcią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, monthi 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

Dotyczy

DateTimeOffset Konstruktory

Definicja

Przeciążenia

DateTimeOffset(DateTime)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

DateTimeOffset(DateTime, TimeSpan)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

DateTimeOffset(Int64, TimeSpan)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Parametry

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

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

Parametry

Wyjątki

Uwagi

Dotyczy

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

Parametry

Wyjątki

Uwagi

Dotyczy

Opinia

Dodatkowe zasoby