DateTimeOffset Konstruktory
Definice
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í
DateTimeOffset(DateTime) |
Inicializuje novou instanci DateTimeOffset struktury pomocí zadané DateTime hodnoty. |
DateTimeOffset(DateTime, TimeSpan) |
Inicializuje novou instanci DateTimeOffset struktury pomocí zadané DateTime hodnoty a posunu. |
DateTimeOffset(Int64, TimeSpan) |
Inicializuje novou instanci DateTimeOffset struktury pomocí zadaného počtu zaškrtnutí a posunu. |
DateTimeOffset(DateOnly, TimeOnly, TimeSpan) |
Inicializuje novou instanci DateTimeOffset struktury pomocí zadaných |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) |
Inicializuje novou instanci struktury pomocí zadaného DateTimeOffset roku, měsíce, dne, hodiny, minuty, sekundy a posunu. |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) |
Inicializuje novou instanci struktury pomocí zadaného DateTimeOffset roku, měsíce, dne, hodiny, minuty, sekundy, milisekund a posunu. |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) |
Inicializuje novou instanci struktury pomocí zadaného DateTimeOffset roku, měsíce, dne, hodiny, minuty, sekundy, milisekund a posunu zadaného kalendáře. |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) |
Inicializuje novou instanci struktury pomocí zadaných DateTimeOffset |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) |
Inicializuje novou instanci struktury pomocí zadaných DateTimeOffset |
DateTimeOffset(DateTime)
- 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
Datum a čas utc (Coordinated Universal Time), který je výsledkem použití posunu, je dřívější než DateTimeOffset.MinValue.
-nebo-
Datum a čas UTC, který je výsledkem použití posunu, je pozdější než DateTimeOffset.MaxValue.
Příklady
Následující příklad ukazuje, jak hodnota DateTime.Kind vlastnosti parametru dateTime
ovlivňuje hodnotu data a času, která je vrácena 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 DateTimeKind.Utchodnota parametru DateTime.Kind , DateTime je vlastnost nové instance nastavena na
dateTime
hodnotu a Offset vlastnost je nastavena na Zerohodnotu .Pokud je hodnota DateTime.Kind je DateTimeKind.Local nebo DateTimeKind.Unspecified, DateTime je vlastnost nové instance nastavena na
dateTime
hodnotu a Offset vlastnost je nastavena na hodnotu rovna posunu aktuálního časového pásma místního systému.
Viz také
Platí pro
DateTimeOffset(DateTime, TimeSpan)
- Zdroj:
- DateTimeOffset.cs
- Zdroj:
- DateTimeOffset.cs
- Zdroj:
- DateTimeOffset.cs
Inicializuje novou instanci DateTimeOffset struktury pomocí zadané DateTime hodnoty a posunu.
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
Časový posun vzhledem ke koordinovanému světovému času (UTC).
Výjimky
dateTime.Kind
Utc rovná se a offset
nerovná se nule.
-nebo-
dateTime.Kind
Local rovná se a offset
nerovná se posunu místního časového pásma systému.
-nebo-
offset
není zadán v celých minutách.
offset
je kratší než -14 hodin nebo více 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 parametru Kind , musí být hodnota parametru
offset
0 nebo ArgumentException je vyvolán.Pokud je DateTimeKind.Localhodnota parametru Kind , musí být hodnota parametru
offset
rovna posunu místního časového pásma od koordinovaného univerzálního ArgumentException času (UTC) pro dané datum nebo je vyvolána.Pokud je DateTimeKind.Unspecifiedhodnota parametru Kind ,
offset
parametr může mít libovolnou platnou hodnotu.
Viz také
Platí pro
DateTimeOffset(Int64, TimeSpan)
- Zdroj:
- DateTimeOffset.cs
- Zdroj:
- DateTimeOffset.cs
- Zdroj:
- DateTimeOffset.cs
Inicializuje novou instanci DateTimeOffset struktury pomocí zadaného počtu zaškrtnutí a posunu.
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 100 nanosekundových intervalů, které uplynuly od 1. ledna 000:00 půlnoci.
- offset
- TimeSpan
Časový posun vzhledem ke koordinovanému světovému času (UTC).
Výjimky
offset
není zadán v celých minutách.
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
s kratší než -14 hodin nebo více než 14 hodin.
Příklady
Následující příklad inicializuje DateTimeOffset objekt pomocí počtu zaškrtnutí v libovolném datu (v tomto případě 16. července 2007 ve 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 pokus o volání konstruktoru DateTimeOffset pro vytvoření instance DateTimeOffset hodnoty s místním časem a jiným posunem než místním časovým pásmem vyvolá ArgumentException. Toto přetížení konstruktoru DateTimeOffset můžete použít k řešení tohoto omezení. Následující příklad používá počet značek místního času k vytvoření DateTimeOffset instance 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é
Platí pro
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)
- Zdroj:
- DateTimeOffset.cs
- Zdroj:
- DateTimeOffset.cs
Inicializuje novou instanci DateTimeOffset struktury pomocí zadaných date
, time
a 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 kalendářního data.
- time
- TimeOnly
Časová část.
- offset
- TimeSpan
Časový posun vzhledem ke koordinovanému světovému času (UTC).
Platí pro
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)
- Zdroj:
- DateTimeOffset.cs
- Zdroj:
- DateTimeOffset.cs
- Zdroj:
- DateTimeOffset.cs
Inicializuje novou instanci struktury pomocí zadaného DateTimeOffset roku, měsíce, dne, hodiny, minuty, sekundy a posunu.
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
Časový posun vzhledem ke koordinovanému světovému času (UTC).
Výjimky
offset
nepředstavuje celé minuty.
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
systému .
-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 kratší než -14 hodin nebo více 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ří instanci objektu DateTimeOffset 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
, month
a day
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, Calendar, TimeSpan) konstruktor.
Viz také
Platí pro
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)
- Zdroj:
- DateTimeOffset.cs
- Zdroj:
- DateTimeOffset.cs
- Zdroj:
- DateTimeOffset.cs
Inicializuje novou instanci struktury pomocí zadaného DateTimeOffset roku, měsíce, dne, hodiny, minuty, sekundy, milisekund a posunu.
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
Časový posun vzhledem ke koordinovanému světovému času (UTC).
Výjimky
offset
nepředstavuje celé minuty.
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
systému .
-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ří instanci objektu DateTimeOffset 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
Tento konstruktor interpretuje year
, month
a day
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, Calendar, TimeSpan) konstruktor.
Viz také
Platí pro
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)
- Zdroj:
- DateTimeOffset.cs
- Zdroj:
- DateTimeOffset.cs
- Zdroj:
- DateTimeOffset.cs
Inicializuje novou instanci struktury pomocí zadaného DateTimeOffset roku, měsíce, dne, hodiny, minuty, sekundy, milisekund a posunu zadaného kalendáře.
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
, month
a day
.
- offset
- TimeSpan
Časový posun vzhledem ke koordinovanému světovému času (UTC).
Výjimky
offset
nepředstavuje celé minuty.
calendar
nemůže být null
.
year
je menší než hodnota parametru calendar
MinSupportedDateTime.Year
nebo větší než MaxSupportedDateTime.Year
.
-nebo-
month
je menší než nebo větší než počet měsíců v year
calendar
.
-nebo-
day
je menší než jeden nebo větší než počet dnů v month
systému .
-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 kratší než -14 hodin nebo více než 14 hodin.
-nebo-
Parametry year
, month
a day
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 třídy i HebrewCalendarHijriCalendar třídy k vytvoření DateTimeOffset instance 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
Parametry year
, month
, day
, hour
, minute
second
, a millisecond
odrážejí hodnoty vyjádřené v kalendáři určeném parametremcalendar
. Pokud tyto hodnoty tvoří datum a čas, které nelze vyjádřit pomocí tohoto kalendáře, vyvolá se výjimka.
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ěten 2019 označil začátek éry Reiwa v JapaneseCalendar éře a JapaneseLunisolarCalendar. Taková změna éry ovlivní všechny aplikace, které tyto kalendáře používají. Další informace a informace o tom, jestli jsou vaše aplikace ovlivněné, najdete v tématu Zpracování nové éry v japonském kalendáři v .NET. Informace o testování aplikací v systémech Windows pro zajištění jejich připravenosti na změnu éry najdete v tématu Příprava aplikace na změnu japonské éry. Informace o funkcích v .NET, které podporují kalendáře s více érami, a osvědčené postupy při práci s kalendáři, které podporují více ér, najdete v tématu Práce s érami.
Viz také
Platí pro
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)
- Zdroj:
- DateTimeOffset.cs
- Zdroj:
- DateTimeOffset.cs
- Zdroj:
- DateTimeOffset.cs
Inicializuje novou instanci struktury pomocí zadaných DateTimeOffsetyear
, month
, day
, hour
, minute
, second
, , millisecond
a microsecond
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
Časový posun vzhledem ke koordinovanému světovému času (UTC).
Výjimky
offset
nepředstavuje celé minuty.
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
systému .
-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 year
a month
day
jako rok, měsíc a den v gregoriánském kalendáři. Pokud chcete vytvořit DateTimeOffset instanci hodnoty pomocí roku, měsíce a dne v jiném kalendáři, 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
Inicializuje novou instanci struktury pomocí zadaných DateTimeOffsetyear
, month
, day
, hour
, minute
, second
, , millisecond
a microsecond
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
, month
a day
.
- offset
- TimeSpan
Časový posun vzhledem ke koordinovanému světovému času (UTC).
Výjimky
offset
nepředstavuje celé minuty.
year
není v rozsahu podporovaném nástrojem calendar
.
-nebo-
month
je menší než 1 nebo větší než počet měsíců v calendar
systému .
-nebo-
day
je menší než 1 nebo větší než počet dnů v month
systému .
-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 kratší než -14 hodin nebo více než 14 hodin.
-nebo-
Parametry year
, month
a day
nelze reprezentovat jako hodnotu data a času.
-nebo-
Vlastnost UtcDateTime je starší než MinValue nebo novější než MaxValue.
Poznámky
Tento konstruktor interpretuje year
a month
day
jako rok, měsíc a den v gregoriánském kalendáři. Pokud chcete vytvořit DateTimeOffset instanci hodnoty pomocí roku, měsíce a dne v jiném kalendáři, zavolejte DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) konstruktor.
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro