DateTimeOffset Konstruktory

Definicja

Przestrzeń nazw:: System

Zestawy:: mscorlib.dll, System.Runtime.dll

Zestawy:: netstandard.dll, System.Runtime.dll

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 nowe wystąpienie DateTimeOffset struktury.

Przeciążenia

Nazwa	Opis
DateTimeOffset(DateTime)	Inicjuje nowe wystąpienie DateTimeOffset struktury przy użyciu określonej DateTime wartości.
DateTimeOffset(DateTime, TimeSpan)	Inicjuje nowe wystąpienie DateTimeOffset struktury przy użyciu określonej DateTime wartości i `offset`.
DateTimeOffset(Int64, TimeSpan)	Inicjuje nowe wystąpienie DateTimeOffset struktury przy użyciu określonej liczby `ticks` i `offset`.
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)	Inicjuje nowe wystąpienie DateTimeOffset struktury przy użyciu określonego `date`elementu , `time`i `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Inicjuje nowe wystąpienie DateTimeOffset struktury przy użyciu określonego `year`, , `month`, `dayhour`, `minutesecond`i `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Inicjuje nowe wystąpienie struktury przy użyciu określonego elementu , , `daymillisecondsecondhourmonthminute`i .`offset`DateTimeOffset`year`
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Inicjuje nowe wystąpienie struktury przy użyciu określonego elementu , , `dayminutemonthcalendarsecondhourmillisecond`i .`offset`DateTimeOffset`year`
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Inicjuje nowe wystąpienie struktury przy użyciu określonego elementu , , `dayminutemonthmicrosecondsecondhourmillisecond`i .`offset`DateTimeOffset`year`
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Inicjuje nowe wystąpienie struktury przy użyciu określonego elementu , , `dayminutemillisecondmonthcalendarsecondhourmicrosecond`i .`offset`DateTimeOffset`year`

DateTimeOffset(DateTime)

Źródło:: DateTimeOffset.cs

Źródło:: DateTimeOffset.cs

Ź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ącą z zastosowania przesunięcia jest wcześniejsza niż DateTimeOffset.MinValue.

-lub-

Data i godzina UTC, która wynika 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 parametru dateTime wpływa na wartość daty i godziny zwracaną 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ść to , właściwość nowego wystąpienia jest ustawiona na wartość dateTime, a Offset właściwość jest ustawiona na wartość Zero.DateTime DateTimeKind.Utc DateTime.Kind
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

Źródło:: DateTimeOffset.cs

Źródło:: DateTimeOffset.cs

Inicjuje nowe wystąpienie DateTimeOffset struktury przy użyciu określonej DateTime wartości i 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)

Parametry

dateTime: DateTime

Data i godzina.

offset: TimeSpan

Przesunięcie czasu z uniwersalnego czasu koordynowanego (UTC).

Wyjątki

ArgumentException

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

-lub-

dateTime.Kind Local równa się i offset nie jest równe przesunięcie 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 wartość jest mniejsza niż DateTimeOffset.MinValue lub większa 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 znana z wyprzedzeniem.

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 to DateTimeKind.Local, wartość offset parametru musi być równa przesunięciom lokalnej strefy czasowej z uniwersalnego czasu koordynowanego (UTC) dla tej konkretnej daty lub ArgumentException jest zgłaszana.
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

Źródło:: DateTimeOffset.cs

Źródło:: DateTimeOffset.cs

Inicjuje nowe wystąpienie DateTimeOffset struktury przy użyciu określonej liczby ticks i 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)

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 roku.

offset: TimeSpan

Przesunięcie czasu z uniwersalnego czasu koordynowanego (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ż lub większa niż DateTimeOffset.MinValue.TicksDateTimeOffset.MaxValue.Ticks.

-lub-

offset wartość jest 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 godzinie 1: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

Zazwyczaj próbuje wywołać konstruktora DateTimeOffset , aby utworzyć wystąpienie DateTimeOffset wartości z czasem lokalnym i przesunięciem innym niż lokalna strefa czasowa 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, aby utworzyć wystąpienie DateTimeOffset wartości, której przesunięcie nie musi reprezentować czasu lokalnego:

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

Źródło:: DateTimeOffset.cs

Źródło:: DateTimeOffset.cs

Inicjuje nowe wystąpienie DateTimeOffset struktury przy użyciu określonego dateelementu , 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 z uniwersalnego czasu koordynowanego (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

Źródło:: DateTimeOffset.cs

Źródło:: DateTimeOffset.cs

Inicjuje nowe wystąpienie DateTimeOffset struktury przy użyciu określonego year, , month, dayhour, minutesecondi 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)

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

Sekundy (od 0 do 59).

offset: TimeSpan

Przesunięcie czasu z uniwersalnego czasu koordynowanego (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

Źródło:: DateTimeOffset.cs

Źródło:: DateTimeOffset.cs

Inicjuje nowe wystąpienie struktury przy użyciu określonego elementu , , daymillisecondsecondhourmonthminutei .offsetDateTimeOffsetyear

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 ciągu month).

hour: Int32

Godziny (od 0 do 23).

minute: Int32

Minuty (od 0 do 59).

second: Int32

Sekundy (od 0 do 59).

millisecond: Int32

Milisekundy (od 0 do 999).

offset: TimeSpan

Przesunięcie czasu z uniwersalnego czasu koordynowanego (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-

millisecond wartość 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

Źródło:: DateTimeOffset.cs

Źródło:: DateTimeOffset.cs

Inicjuje nowe wystąpienie struktury przy użyciu określonego elementu , , dayminutemonthcalendarsecondhourmillisecondi .offsetDateTimeOffsetyear

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 ciągu month).

hour: Int32

Godziny (od 0 do 23).

minute: Int32

Minuty (od 0 do 59).

second: Int32

Sekundy (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 z uniwersalnego czasu koordynowanego (UTC).

Wyjątki

ArgumentException

offset nie reprezentuje całych minut.

ArgumentNullException

calendar nie może być null.

ArgumentOutOfRangeException

year parametr jest mniejszy niż calendar parametr MinSupportedDateTime.Year lub większy niż MaxSupportedDateTime.Year.

-lub-

month wartość jest mniejsza 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 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-

millisecond wartość jest mniejsza niż 0 lub większa niż 999.

-lub-

offset wartość jest mniejsza niż -14 godzin lub większa niż 14 godzin.

-lub-

yearParametrów , 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ń zarówno HebrewCalendar klasy, jak i HijriCalendar klasy, aby utworzyć DateTimeOffset wystąpienie 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, , dayminutehoursecondmonth, 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ć przy użyciu tego kalendarza.

Ważny

Era w japońskich kalendarzach opiera się na panowaniu cesarza i dlatego oczekuje się, że się zmieni. Na przykład 1 maja 2019 r. oznaczało początek ery Reiwa w JapaneseCalendar 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 ery, zobacz Przygotowanie aplikacji do zmiany w erze japońskiej. Aby uzyskać informacje o funkcjach na platformie .NET, które obsługują kalendarze z wieloma epokami i aby uzyskać 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

Źródło:: DateTimeOffset.cs

Źródło:: DateTimeOffset.cs

Inicjuje nowe wystąpienie struktury przy użyciu określonego elementu , , dayminutemonthmicrosecondsecondhourmillisecondi .offsetDateTimeOffsetyear

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 ciągu month).

hour: Int32

Godziny (od 0 do 23).

minute: Int32

Minuty (od 0 do 59).

second: Int32

Sekundy (od 0 do 59).

millisecond: Int32

Milisekundy (od 0 do 999).

microsecond: Int32

Mikrosekundy (od 0 do 999).

offset: TimeSpan

Przesunięcie czasu z uniwersalnego czasu koordynowanego (UTC).

Wyjątki

ArgumentException

offset nie reprezentuje całych minut.

ArgumentOutOfRangeException

year wartość jest mniejsza niż 1 lub większa niż 9999.

-lub-

month wartość jest mniejsza niż 1 lub większa niż 12.

-lub-

day wartość jest mniejsza niż 1 lub większa niż liczba dni w ciągu month.

-lub-

hour wartość 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 wartość jest mniejsza niż 0 lub większa niż 999.

-lub-

microsecond wartość jest mniejsza niż 0 lub większa niż 999.

Uwagi

Ten konstruktor interpretuje yearwartości , month i day jako rok, miesiąc i dzień w kalendarzu gregoriańskim. Aby utworzyć wystąpienie DateTimeOffset 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

Źródło:: DateTimeOffset.cs

Źródło:: DateTimeOffset.cs

Inicjuje nowe wystąpienie struktury przy użyciu określonego elementu , , dayminutemillisecondmonthcalendarsecondhourmicrosecondi .offsetDateTimeOffsetyear

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 ciągu month).

hour: Int32

Godziny (od 0 do 23).

minute: Int32

Minuty (od 0 do 59).

second: Int32

Sekundy (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 z uniwersalnego czasu koordynowanego (UTC).

Wyjątki

ArgumentException

offset nie reprezentuje całych minut.

ArgumentOutOfRangeException

year nie znajduje się w zakresie obsługiwanym przez calendarprogram .

-lub-

month wartość jest mniejsza niż 1 lub większa niż liczba miesięcy w pliku calendar.

-lub-

day wartość jest mniejsza niż 1 lub większa niż liczba dni w ciągu month.

-lub-

hour wartość 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 wartość jest mniejsza niż 0 lub większa niż 999.

-lub-

microsecond wartość jest mniejsza niż 0 lub większa niż 999.

-lub-

offset wartość jest mniejsza niż -14 godzin lub większa niż 14 godzin.

-lub-

yearParametrów , 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

Opinia

Czy ta strona była pomocna?

Udostępnij za pośrednictwem

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