DateTimeOffset Konstruktory

Definice

Obor názvů:: System

Sestavení:: mscorlib.dll, System.Runtime.dll

Sestavení:: netstandard.dll, System.Runtime.dll

Sestavení:: System.Runtime.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Inicializuje novou instanci DateTimeOffset struktury.

Přetížení

Name	Description
DateTimeOffset(DateTime)	Inicializuje novou instanci DateTimeOffset struktury pomocí zadané DateTime hodnoty.
DateTimeOffset(DateTime, TimeSpan)	Inicializuje novou instanci DateTimeOffset struktury pomocí zadané DateTime hodnoty a `offset`.
DateTimeOffset(Int64, TimeSpan)	Inicializuje novou instanci struktury pomocí zadaného DateTimeOffset`ticks` počtu a `offset`.
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)	Inicializuje novou instanci DateTimeOffset struktury pomocí zadaného `date`, `time`a `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Inicializuje novou instanci DateTimeOffset struktury pomocí zadané `year`, `month`, `day`, , `hour`, `minutesecond`a `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Inicializuje novou instanci DateTimeOffset struktury pomocí zadané `year`, `month`, `day`, , `hour`, `minute`, , `secondmillisecond`a `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Inicializuje novou instanci DateTimeOffset struktury pomocí zadané `year`, `month`, `day`, , `hour`, `minute`, `second`, , `millisecond`, `calendar`, a `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Inicializuje novou instanci DateTimeOffset struktury pomocí zadané `year`, `month`, `day`, , `hour`, `minute`, `second`, , `millisecond`, `microsecond`, a `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Inicializuje novou instanci DateTimeOffset struktury pomocí zadané `year`, `month`, , `day`, `hour`, `minute`, , `second`, `millisecond`, `microsecond`, `calendar`, a `offset`.

DateTimeOffset(DateTime)

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Inicializuje novou instanci DateTimeOffset struktury pomocí zadané DateTime hodnoty.

public:
 DateTimeOffset(DateTime dateTime);

public DateTimeOffset(DateTime dateTime);

new DateTimeOffset : DateTime -> DateTimeOffset

Public Sub New (dateTime As DateTime)

Parametry

dateTime: DateTime

Datum a čas.

Výjimky

ArgumentOutOfRangeException

Datum a čas koordinovaného univerzálního času (UTC), které má za následek použití posunu, je dřívější než DateTimeOffset.MinValue.

-nebo-

Datum a čas UTC, které mají za následek použití posunu, je pozdější než DateTimeOffset.MaxValue.

Příklady

Následující příklad ukazuje, jak hodnota DateTime.Kind vlastnosti dateTime parametru ovlivňuje hodnotu data a času vrácenou tímto konstruktorem.

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

Poznámky

Chování tohoto konstruktoru závisí na hodnotě DateTime.Kind vlastnosti parametru dateTime :

Pokud je hodnota , vlastnost nové instance je nastavena rovná dateTime, a Offset vlastnost je nastavena rovná Zero.DateTime DateTime.Kind DateTimeKind.Utc
Pokud je hodnota DateTime.Kind nebo DateTimeKind.Local DateTimeKind.Unspecified, DateTime vlastnost nové instance je nastavena rovná dateTime, a Offset vlastnost je nastavena rovná posunu aktuálního časového pásma místního systému.

Viz také

Vytvoření instance objektu DateTimeOffset

Platí pro

DateTimeOffset(DateTime, TimeSpan)

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Inicializuje novou instanci DateTimeOffset struktury pomocí zadané DateTime hodnoty a 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

Datum a čas.

offset: TimeSpan

Posun času od koordinovaného univerzálního času (UTC).

Výjimky

ArgumentException

dateTime.Kindrovná se a offset nerovná Utc se nule.

-nebo-

dateTime.Kindrovná se a offset nerovná Local se posunu místního časového pásma systému.

-nebo-

offset není zadán v celých minutách.

ArgumentOutOfRangeException

offset je menší než -14 hodin nebo větší než 14 hodin.

-nebo-

UtcDateTime je menší než DateTimeOffset.MinValue nebo větší než DateTimeOffset.MaxValue.

Příklady

Následující příklad ukazuje, jak inicializovat DateTimeOffset objekt s datem a časem a posunem místního časového pásma, pokud toto časové pásmo není předem známo.

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

Poznámky

Chování tohoto konstruktoru závisí částečně na hodnotě Kind vlastnosti parametru dateTime :

Pokud je DateTimeKind.Utchodnota Kind , hodnota parametru offset musí být 0 nebo ArgumentException je vyvolán.
Pokud je DateTimeKind.Localhodnota , hodnota parametru offset musí být rovna posunu místního časového pásma od koordinovaného univerzálního Kind času (UTC) pro dané konkrétní datum nebo ArgumentException je vyvolána.
Pokud je DateTimeKind.Unspecifiedhodnota Kind , parametr může mít libovolnou platnou offset hodnotu.

Viz také

Vytvoření instance objektu DateTimeOffset

Platí pro

DateTimeOffset(Int64, TimeSpan)

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Inicializuje novou instanci struktury pomocí zadaného DateTimeOffsetticks počtu a 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

Datum a čas vyjádřený jako počet intervalů 100 nanosekund, které uplynuly od 12:00:00 půlnoci 1. ledna 0001.

offset: TimeSpan

Posun času od koordinovaného univerzálního času (UTC).

Výjimky

ArgumentException

offset není zadán v celých minutách.

ArgumentOutOfRangeException

Vlastnost UtcDateTime je starší než DateTimeOffset.MinValue nebo novější než DateTimeOffset.MaxValue.

-nebo-

ticks je menší než DateTimeOffset.MinValue.Ticks nebo větší než DateTimeOffset.MaxValue.Ticks.

-nebo-

offset je menší než -14 hodin nebo větší než 14 hodin.

Příklady

Následující příklad inicializuje DateTimeOffset objekt pomocí počtu záškrtů v libovolném datu (v tomto případě 16. července 2007 v 13:32) s posunem -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

Poznámky

Obvykle se snaží volat DateTimeOffset konstruktor, který vytvoří instanci DateTimeOffset hodnoty s místním časem a posunem jiného než místního časového pásma vyvolá ArgumentExceptionvýjimku . Toto přetížení konstruktoru DateTimeOffset můžete použít k vyřešení tohoto omezení. Následující příklad používá počet záškrtů místního času k vytvoření instance DateTimeOffset hodnoty, jejíž posun nemusí nutně představovat hodnotu místního času:

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

Viz také

Vytvoření instance objektu DateTimeOffset

Platí pro

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Inicializuje novou instanci DateTimeOffset struktury pomocí zadaného date, timea 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

Část data.

time: TimeOnly

Časová část.

offset: TimeSpan

Posun času od koordinovaného univerzálního času (UTC).

Platí pro

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

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Inicializuje novou instanci DateTimeOffset struktury pomocí zadané year, month, day, , hour, minuteseconda 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 (1 až 9999).

month: Int32

Měsíc (1 až 12).

day: Int32

Den (1 až počet dní v month).

hour: Int32

Hodiny (0 až 23).

minute: Int32

Minuty (0 až 59).

second: Int32

Sekundy (0 až 59).

offset: TimeSpan

Posun času od koordinovaného univerzálního času (UTC).

Výjimky

ArgumentException

offset nepředstavuje celé minuty.

ArgumentOutOfRangeException

year je menší než jedna nebo větší než 9999.

-nebo-

month je menší než jedna nebo větší než 12.

-nebo-

day je menší než jeden nebo větší než počet dnů v month.

-nebo-

hour je menší než nula nebo větší než 23.

-nebo-

minute je menší než 0 nebo větší než 59.

-nebo-

second je menší než 0 nebo větší než 59.

-nebo-

offset je menší než -14 hodin nebo větší než 14 hodin.

-nebo-

Vlastnost UtcDateTime je starší než DateTimeOffset.MinValue nebo novější než DateTimeOffset.MaxValue.

Příklady

Následující příklad vytvoří DateTimeOffset instanci objektu pomocí přetížení konstruktoru 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

Poznámky

Tento konstruktor interpretuje year, montha day jako rok, měsíc a den v gregoriánském kalendáři. Chcete-li vytvořit instanci DateTimeOffset hodnoty pomocí roku, měsíce a dne v jiném kalendáři, zavolejte DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) konstruktor.

Viz také

Vytvoření instance objektu DateTimeOffset

Platí pro

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

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Inicializuje novou instanci DateTimeOffset struktury pomocí zadané year, month, day, , hour, minute, , secondmilliseconda offset.

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 (1 až 9999).

month: Int32

Měsíc (1 až 12).

day: Int32

Den (1 až počet dní v month).

hour: Int32

Hodiny (0 až 23).

minute: Int32

Minuty (0 až 59).

second: Int32

Sekundy (0 až 59).

millisecond: Int32

Milisekundy (0 až 999).

offset: TimeSpan

Posun času od koordinovaného univerzálního času (UTC).

Výjimky

ArgumentException

offset nepředstavuje celé minuty.

ArgumentOutOfRangeException

year je menší než jedna nebo větší než 9999.

-nebo-

month je menší než jedna nebo větší než 12.

-nebo-

day je menší než jeden nebo větší než počet dnů v month.

-nebo-

hour je menší než nula nebo větší než 23.

-nebo-

minute je menší než 0 nebo větší než 59.

-nebo-

second je menší než 0 nebo větší než 59.

-nebo-

millisecond je menší než 0 nebo větší než 999.

-nebo-

offset je menší než -14 nebo větší než 14.

-nebo-

Vlastnost UtcDateTime je starší než DateTimeOffset.MinValue nebo novější než DateTimeOffset.MaxValue.

Příklady

Následující příklad vytvoří DateTimeOffset instanci objektu pomocí přetížení konstruktoru 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

Poznámky

Viz také

Vytvoření instance objektu DateTimeOffset

Platí pro

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

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Inicializuje novou instanci DateTimeOffset struktury pomocí zadané year, month, day, , hour, minute, second, , millisecond, calendar, a offset.

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

Měsíc (1 až 12).

day: Int32

Den (1 až počet dní v month).

hour: Int32

Hodiny (0 až 23).

minute: Int32

Minuty (0 až 59).

second: Int32

Sekundy (0 až 59).

millisecond: Int32

Milisekundy (0 až 999).

calendar: Calendar

Kalendář, který se používá k interpretaci year, montha day.

offset: TimeSpan

Posun času od koordinovaného univerzálního času (UTC).

Výjimky

ArgumentException

offset nepředstavuje celé minuty.

ArgumentNullException

calendar nemůže být null.

ArgumentOutOfRangeException

yearje menší než parametr MinSupportedDateTime.Year nebo větší než .calendarMaxSupportedDateTime.Year

-nebo-

monthje buď menší než nebo větší než počet měsíců v yearcalendar

-nebo-

day je menší než jeden nebo větší než počet dnů v month.

-nebo-

hour je menší než nula nebo větší než 23.

-nebo-

minute je menší než 0 nebo větší než 59.

-nebo-

second je menší než 0 nebo větší než 59.

-nebo-

millisecond je menší než 0 nebo větší než 999.

-nebo-

offset je menší než -14 hodin nebo větší než 14 hodin.

-nebo-

Parametr yeara parametry monthday nelze reprezentovat jako hodnotu data a času.

-nebo-

Vlastnost UtcDateTime je starší než DateTimeOffset.MinValue nebo novější než DateTimeOffset.MaxValue.

Příklady

Následující příklad používá instance HebrewCalendar třídy i HijriCalendar třídy k vytvoření instance DateTimeOffset hodnoty. Toto datum se pak zobrazí v konzole pomocí příslušných kalendářů a gregoriánského kalendáře.

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()

Poznámky

Všechny yearparametry , , month, dayhour, secondminutea millisecond parametry odrážejí hodnoty vyjádřené v kalendáři určeném parametremcalendar. Výjimka se vyvolá, pokud tyto hodnoty tvoří datum a čas, které nelze vyjádřit pomocí tohoto kalendáře.

Důležitý

Éry v japonských kalendářích jsou založeny na vládě císaře, a proto se očekává, že se změní. Například 1. května 2019 označilo začátek období Reiwa v JapaneseCalendar a JapaneseLunisolarCalendar. Taková změna éry ovlivňuje všechny aplikace, které tyto kalendáře používají. Další informace a určení, zda jsou ovlivněny vaše aplikace, naleznete v tématu Zpracování nové éry v japonském kalendáři v .NET. Informace o testování aplikací v systémech Windows za účelem zajištění připravenosti na změnu v éře najdete v tématu Příprava aplikace na změnu japonské éry. Funkce v .NET, které podporují kalendáře s více obdobími a osvědčené postupy při práci s kalendáři, které podporují více období, najdete v tématu Práce s obdobími.

Viz také

Vytvoření instance objektu DateTimeOffset

Platí pro

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

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Inicializuje novou instanci DateTimeOffset struktury pomocí zadané year, month, day, , hour, minute, second, , millisecond, microsecond, a 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 (1 až 9999).

month: Int32

Měsíc (1 až 12).

day: Int32

Den (1 až počet dní v month).

hour: Int32

Hodiny (0 až 23).

minute: Int32

Minuty (0 až 59).

second: Int32

Sekundy (0 až 59).

millisecond: Int32

Milisekundy (0 až 999).

microsecond: Int32

Mikrosekundy (0 až 999).

offset: TimeSpan

Posun času od koordinovaného univerzálního času (UTC).

Výjimky

ArgumentException

offset nepředstavuje celé minuty.

ArgumentOutOfRangeException

year je menší než 1 nebo větší než 9999.

-nebo-

month je menší než 1 nebo větší než 12.

-nebo-

day je menší než 1 nebo větší než počet dní v month.

-nebo-

hour je menší než 0 nebo větší než 23.

-nebo-

minute je menší než 0 nebo větší než 59.

-nebo-

second je menší než 0 nebo větší než 59.

-nebo-

millisecond je menší než 0 nebo větší než 999.

-nebo-

microsecond je menší než 0 nebo větší než 999.

Poznámky

Tento konstruktor interpretuje yeara monthday jako rok, měsíc a den v gregoriánském kalendáři. Pokud chcete vytvořit instanci hodnoty pomocí roku, měsíce a dne v jiném kalendáři DateTimeOffset , zavolejte DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) konstruktor.

Platí pro

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

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Zdroj:: DateTimeOffset.cs

Inicializuje novou instanci DateTimeOffset struktury pomocí zadané year, month, , day, hour, minute, , second, millisecond, microsecond, calendar, a 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 (1 až 9999).

month: Int32

Měsíc (1 až 12).

day: Int32

Den (1 až počet dní v month).

hour: Int32

Hodiny (0 až 23).

minute: Int32

Minuty (0 až 59).

second: Int32

Sekundy (0 až 59).

millisecond: Int32

Milisekundy (0 až 999).

microsecond: Int32

Mikrosekundy (0 až 999).

calendar: Calendar

Kalendář, který se používá k interpretaci year, montha day.

offset: TimeSpan

Posun času od koordinovaného univerzálního času (UTC).

Výjimky

ArgumentException

offset nepředstavuje celé minuty.

ArgumentOutOfRangeException

year není v rozsahu, který calendarpodporuje .

-nebo-

month je menší než 1 nebo větší než počet měsíců v calendar.

-nebo-

day je menší než 1 nebo větší než počet dní v month.

-nebo-

hour je menší než 0 nebo větší než 23.

-nebo-

minute je menší než 0 nebo větší než 59.

-nebo-

second je menší než 0 nebo větší než 59.

-nebo-

millisecond je menší než 0 nebo větší než 999.

-nebo-

microsecond je menší než 0 nebo větší než 999.

-nebo-

offset je menší než -14 hodin nebo větší než 14 hodin.

-nebo-

Parametr yeara parametry monthday nelze reprezentovat jako hodnotu data a času.

-nebo-

Vlastnost UtcDateTime je starší než nebo novější než MinValue MaxValue.

Poznámky

Platí pro

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

DateTimeOffset Konstruktory

Definice

Přetížení

DateTimeOffset(DateTime)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

DateTimeOffset(DateTime, TimeSpan)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

DateTimeOffset(Int64, TimeSpan)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Parametry

Platí pro

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

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

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

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

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

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

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

Parametry

Výjimky

Poznámky

Platí pro

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

Parametry

Výjimky

Poznámky

Platí pro

Váš názor