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

Przeciążenia

DateTimeOffset(DateTime)	Inicjuje nowe wystąpienie struktury DateTimeOffset przy użyciu określonej wartości DateTime.
DateTimeOffset(DateTime, TimeSpan)	Inicjuje nowe wystąpienie struktury DateTimeOffset przy użyciu określonej wartości DateTime i przesunięcia.
DateTimeOffset(Int64, TimeSpan)	Inicjuje nowe wystąpienie struktury DateTimeOffset przy użyciu określonej liczby znaczników i przesunięcia.
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)	Inicjuje nowe wystąpienie struktury DateTimeOffset przy użyciu określonego `date`, `time`i `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Inicjuje nowe wystąpienie struktury DateTimeOffset przy użyciu określonego roku, miesiąca, dnia, godziny, minuty, sekundy i przesunięcia.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Inicjuje nowe wystąpienie struktury DateTimeOffset przy użyciu określonego 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 DateTimeOffset przy użyciu określonego 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 DateTimeOffset przy użyciu określonego `year`, `month`, `day`, `hour`, `minute`, `second`, `millisecond`, `microsecond` i `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Inicjuje nowe wystąpienie struktury DateTimeOffset przy użyciu określonego `year`, `month`, `day`, `hour`, `minute`, `second`, `millisecond`, `microsecond` i `offset`.

DateTimeOffset(DateTime)

Źródło:: DateTimeOffset.cs

Źródło:: DateTimeOffset.cs

Źródło:: DateTimeOffset.cs

Inicjuje nowe wystąpienie struktury DateTimeOffset przy użyciu określonej wartości DateTime.

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 uniwersalnej koordynowanej godziny (UTC) wynikającej 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ść właściwości DateTime.Kind 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 właściwości DateTime.Kind parametru dateTime:

Jeśli wartość DateTime.Kind jest DateTimeKind.Utc, właściwość DateTime nowego wystąpienia jest ustawiona na wartość dateTime, a właściwość Offset jest równa Zero.
Jeśli wartość DateTime.Kind jest DateTimeKind.Local lub DateTimeKind.Unspecified, właściwość DateTime nowego wystąpienia jest ustawiona na wartość dateTime, a właściwość Offset jest ustawiona na przesunięcie bieżącej strefy czasowej systemu lokalnego.

Zobacz też

utworzenie wystąpienia obiektu DateTimeOffset

Dotyczy

DateTimeOffset(DateTime, TimeSpan)

Źródło:: DateTimeOffset.cs

Źródło:: DateTimeOffset.cs

Źródło:: DateTimeOffset.cs

Inicjuje nowe wystąpienie struktury DateTimeOffset przy użyciu określonej wartości DateTime 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 z uniwersalnego czasu koordynowanego (UTC).

Wyjątki

ArgumentException

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

-lub-

dateTime.Kind równa się Local i offset nie jest równe przesunięcie lokalnej strefy czasowej systemu.

-lub-

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

ArgumentOutOfRangeException

offset jest krótszy niż -14 godzin lub dłuższy niż 14 godzin.

-lub-

UtcDateTime jest mniejsza niż DateTimeOffset.MinValue lub nowsza niż DateTimeOffset.MaxValue.

Przykłady

W poniższym przykładzie pokazano, jak zainicjować obiekt DateTimeOffset 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 właściwości Kind parametru dateTime:

Jeśli wartość Kind jest DateTimeKind.Utc, wartość parametru offset musi wynosić 0 lub zostanie zgłoszony ArgumentException.
Jeśli wartość Kind jest DateTimeKind.Local, 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.
Jeśli wartość Kind jest DateTimeKind.Unspecified, parametr offset może mieć dowolną prawidłową wartość.

Zobacz też

utworzenie 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 struktury DateTimeOffset 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 roku.

offset: TimeSpan

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

Wyjątki

ArgumentException

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

ArgumentOutOfRangeException

Właściwość UtcDateTime jest wcześniejsza niż DateTimeOffset.MinValue lub nowsza niż DateTimeOffset.MaxValue.

-lub-

ticks jest mniejsza niż DateTimeOffset.MinValue.Ticks lub większa niż DateTimeOffset.MaxValue.Ticks.

-lub-

offset jest krótszy niż -14 godzin lub dłuższy niż 14 godzin.

Przykłady

Poniższy przykład inicjuje obiekt DateTimeOffset przy użyciu liczby znaczników w dowolnej dacie (w tym przypadku 16 lipca 2007 r., o godzinie 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

Zazwyczaj próbuje wywołać konstruktora DateTimeOffset, aby utworzyć wystąpienie wartości DateTimeOffset z czasem lokalnym i przesunięciem innym niż lokalna strefa czasowa zgłasza 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 wartości DateTimeOffset, 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ż

utworzenie wystąpienia obiektu DateTimeOffset

Dotyczy

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Źródło:: DateTimeOffset.cs

Źródło:: DateTimeOffset.cs

Inicjuje nowe wystąpienie struktury DateTimeOffset przy użyciu określonego date, 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

Inicjuje nowe wystąpienie struktury DateTimeOffset przy użyciu określonego 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 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 jest mniejsza niż jedna lub większa niż 12.

-lub-

day jest mniejsza niż jedna lub większa niż liczba dni w month.

-lub-

hour jest mniejsza niż zero lub większa niż 23.

-lub-

minute jest mniejsza niż 0 lub większa niż 59.

-lub-

second jest mniejsza niż 0 lub większa niż 59.

-lub-

offset jest krótszy niż -14 godzin lub dłuższy 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 obiektu DateTimeOffset 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, monthi day jako rok, miesiąc i dzień w kalendarzu gregoriańskim. Aby utworzyć wystąpienie wartości DateTimeOffset przy użyciu roku, miesiąca i dnia w innym kalendarzu, wywołaj konstruktor DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan).

Zobacz też

utworzenie 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 nowe wystąpienie struktury DateTimeOffset przy użyciu określonego roku, miesiąca, dnia, godziny, minuty, sekundy, milisekundy 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).

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 jest mniejsza niż jedna lub większa niż 12.

-lub-

day jest mniejsza niż jedna lub większa niż liczba dni w month.

-lub-

hour jest mniejsza niż zero lub większa niż 23.

-lub-

minute jest mniejsza niż 0 lub większa niż 59.

-lub-

second jest mniejsza niż 0 lub większa niż 59.

-lub-

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

-lub-

offset 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 obiektu DateTimeOffset 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ż

utworzenie 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 nowe wystąpienie struktury DateTimeOffset przy użyciu określonego roku, miesiąca, dnia, godziny, minuty, sekundy, milisekundy 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).

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żna null.

ArgumentOutOfRangeException

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

-lub-

month jest mniejsza lub większa niż liczba miesięcy w year w calendar.

-lub-

day jest mniejsza niż jedna lub większa niż liczba dni w month.

-lub-

hour jest mniejsza niż zero lub większa niż 23.

-lub-

minute jest mniejsza niż 0 lub większa niż 59.

-lub-

second jest mniejsza niż 0 lub większa niż 59.

-lub-

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

-lub-

offset jest krótszy niż -14 godzin lub dłuższy niż 14 godzin.

-lub-

Nie można przedstawić parametrów year, monthi day 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 klasy HebrewCalendar, jak i klasy HijriCalendar, aby utworzyć wystąpienie wartości DateTimeOffset. 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, minute, secondi millisecond wszystkie parametry odzwierciedlają wartości wyrażone w kalendarzu określonym przez parametr calendar. 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 Prepare your application for the Japanese era change. 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ż

utworzenie 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 nowe wystąpienie struktury DateTimeOffset przy użyciu określonego year, month, day, hour, minute, second, 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).

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 jest mniejsza niż 1 lub większa niż 9999.

-lub-

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

-lub-

day jest mniejsza niż 1 lub większa niż liczba dni w month.

-lub-

hour jest mniejsza niż 0 lub większa niż 23.

-lub-

minute jest mniejsza niż 0 lub większa niż 59.

-lub-

second 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, month i day jako rok, miesiąc i dzień w kalendarzu gregoriańskim. Aby utworzyć wystąpienie wartości DateTimeOffset przy użyciu roku, miesiąca i dnia w innym kalendarzu, wywołaj konstruktor DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan).

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 nowe wystąpienie struktury DateTimeOffset przy użyciu określonego year, month, day, hour, minute, second, 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).

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

-lub-

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

-lub-

day jest mniejsza niż 1 lub większa niż liczba dni w month.

-lub-

hour jest mniejsza niż 0 lub większa niż 23.

-lub-

minute jest mniejsza niż 0 lub większa niż 59.

-lub-

second 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 jest krótszy niż -14 godzin lub dłuższy niż 14 godzin.

-lub-

Nie można przedstawić parametrów year, monthi day jako wartości daty i godziny.

-lub-

Właściwość UtcDateTime jest wcześniejsza niż MinValue lub nowsza niż MaxValue.

Uwagi

Ten konstruktor interpretuje year, month i day jako rok, miesiąc i dzień w kalendarzu gregoriańskim. Aby utworzyć wystąpienie wartości DateTimeOffset przy użyciu roku, miesiąca i dnia w innym kalendarzu, wywołaj konstruktor DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan).

Dotyczy

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

Dodatkowe zasoby