DateTimeOffset Oluşturucular

Başvuru

Tanım

Ad Alanı:: System

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Yapının yeni bir örneğini DateTimeOffset başlatır.

Aşırı Yüklemeler

DateTimeOffset(DateTime)	Belirtilen DateTime değeri kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.
DateTimeOffset(DateTime, TimeSpan)	Belirtilen DateTime değeri ve uzaklığı kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.
DateTimeOffset(Int64, TimeSpan)	Belirtilen sayıda değer ve uzaklık kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)	Belirtilen `date`, `time`ve `offset`kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Belirtilen yıl, ay, gün, saat, dakika, saniye ve uzaklığı kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Belirtilen yıl, ay, gün, saat, dakika, saniye, milisaniye ve uzaklığı kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Belirtilen takvimin DateTimeOffset belirtilen yıl, ay, gün, saat, dakika, saniye, milisaniye ve uzaklığını kullanarak yapının yeni bir örneğini başlatır.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Belirtilen , , , , `minutemillisecondsecondmicroseconddayhour`ve `offset`kullanarak yapının yeni bir örneğini DateTimeOffset başlatır. `monthyear`
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Belirtilen , , , , `minutemillisecondsecondmicroseconddayhour`ve `offset`kullanarak yapının yeni bir örneğini DateTimeOffset başlatır. `monthyear`

DateTimeOffset(DateTime)

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Belirtilen DateTime değeri kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.

public:
 DateTimeOffset(DateTime dateTime);

public DateTimeOffset (DateTime dateTime);

new DateTimeOffset : DateTime -> DateTimeOffset

Public Sub New (dateTime As DateTime)

Parametreler

dateTime: DateTime

Tarih ve saat.

Özel durumlar

ArgumentOutOfRangeException

Uzaklık uygulanmasından kaynaklanan Eşgüdümlü Evrensel Saat (UTC) tarih ve saati DateTimeOffset.MinValue değerinden daha eskidir.

-veya-

Uzaklık uygulanmasından kaynaklanan UTC tarih ve saati DateTimeOffset.MaxValue değerinden daha sonradır.

Örnekler

Aşağıdaki örnekte, parametresinin özelliğinin değerinin DateTime.KinddateTime bu oluşturucu tarafından döndürülen tarih ve saat değerini nasıl etkilediği gösterilmektedir.

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

Açıklamalar

Bu oluşturucunun davranışı, parametresinin özelliğinin DateTime.KinddateTime değerine bağlıdır:

değeri ise, yeni örneğin özelliği değerine eşitdateTimeOffset, özelliği ise değerine eşit Zeroolarak ayarlanır.DateTime DateTimeKind.Utc DateTime.Kind
değeri DateTime.Kind veya DateTime DateTimeKind.UnspecifiediseDateTimeKind.Local, yeni örneğin özelliği değerine eşit OffsetdateTime, özelliği ise yerel sistemin geçerli saat diliminin uzaklığıyla eşit olarak ayarlanır.

Ayrıca bkz.

DateTimeOffset Nesnesi Örneği Oluşturma

Şunlara uygulanır

DateTimeOffset(DateTime, TimeSpan)

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Belirtilen DateTime değeri ve uzaklığı kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.

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)

Parametreler

dateTime: DateTime

Tarih ve saat.

offset: TimeSpan

Zamanın Eşgüdümlü Evrensel Saat'ten (UTC) uzaklığı.

Özel durumlar

ArgumentException

dateTime.KindUtc eşittir ve offset sıfıra eşit değildir.

-veya-

dateTime.KindLocal eşittir ve offset sistemin yerel saat diliminin uzaklığıyla eşit değildir.

-veya-

offset tam dakika içinde belirtilmez.

ArgumentOutOfRangeException

offset -14 saatten az veya 14 saatten büyük.

-veya-

UtcDateTime DateTimeOffset.MinValue değerinden küçük veya DateTimeOffset.MaxValue değerinden büyük.

Örnekler

Aşağıdaki örnek, bir DateTimeOffset nesnenin tarih ve saatle nasıl başlatıldığını ve o saat dilimi önceden bilinmediğinde yerel saat diliminin uzaklığını gösterir.

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

Açıklamalar

Bu oluşturucunun davranışı kısmen parametresinin özelliğinin KinddateTime değerine bağlıdır:

değeri Kind ise DateTimeKind.Utc, parametresinin offset değeri 0 olmalıdır veya bir ArgumentException oluşturulur.
değeri Kind ise DateTimeKind.Local, parametrenin offset değeri, söz konusu tarih için eşgüdümlü Evrensel Saat 'ten (UTC) yerel saat diliminin uzaklığıyla eşit olmalıdır veya bir ArgumentException oluşturulur.
değeri Kind ise DateTimeKind.Unspecifiedparametresi geçerli offset bir değere sahip olabilir.

Ayrıca bkz.

DateTimeOffset Nesnesi Örneği Oluşturma

Şunlara uygulanır

DateTimeOffset(Int64, TimeSpan)

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Belirtilen sayıda değer ve uzaklık kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.

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)

Parametreler

ticks: Int64

1 Ocak 0001'de gece yarısı 12:00:00'dan bu yana geçen 100 nanosaniyelik aralık sayısı olarak ifade edilen tarih ve saat.

offset: TimeSpan

Zamanın Eşgüdümlü Evrensel Saat'ten (UTC) uzaklığı.

Özel durumlar

ArgumentException

offset tam dakika içinde belirtilmez.

ArgumentOutOfRangeException

UtcDateTime Özelliği DateTimeOffset.MinValue değerinden veya DateTimeOffset.MaxValue değerinden daha eskidir.

-veya-

ticks değerinden DateTimeOffset.MinValue.Ticks küçük veya büyüktür DateTimeOffset.MaxValue.Ticks.

-veya-

Offset -14 saatten az veya 14 saatten büyük.

Örnekler

Aşağıdaki örnek, rastgele bir tarihteki (bu örnekte, 16 Temmuz 2007, saat 13:32))-5 uzaklığındaki değer sayısını kullanarak bir nesneyi başlatır DateTimeOffset .

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

Açıklamalar

Normalde, yerel saat ve yerel saat diliminden farklı bir uzaklık ile bir DateTimeOffset değerin örneğini oluşturmak için oluşturucuyu çağırmaya DateTimeOffset çalışmak bir ArgumentExceptionoluşturur. Bu sınırlamayı geçici olarak çözmek için oluşturucunun DateTimeOffset bu aşırı yüklemesini kullanabilirsiniz. Aşağıdaki örnekte, uzaklığı yerel saatin değerini temsil etmeyen bir DateTimeOffset değerin örneğini oluşturmak için yerel saatin değer sayısı kullanılır:

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

Ayrıca bkz.

DateTimeOffset Nesnesi Örneği Oluşturma

Şunlara uygulanır

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Belirtilen date, timeve offsetkullanarak yapının yeni bir örneğini DateTimeOffset başlatır.

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)

Parametreler

date: DateOnly

Tarih bölümü.

time: TimeOnly

Zaman kısmı.

offset: TimeSpan

Zamanın Eşgüdümlü Evrensel Saat'ten (UTC) uzaklığı.

Şunlara uygulanır

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

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Belirtilen yıl, ay, gün, saat, dakika, saniye ve uzaklığı kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.

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)

Parametreler

year: Int32

Yıl (1-9999).

month: Int32

Ay (1-12).

day: Int32

Gün (1 ile içindeki monthgün sayısı arasında).

hour: Int32

Saat (0-23).

minute: Int32

Dakika (0-59).

second: Int32

Saniye (0-59).

offset: TimeSpan

Zamanın Eşgüdümlü Evrensel Saat'ten (UTC) uzaklığı.

Özel durumlar

ArgumentException

offset dakikaların tamamını temsil etmez.

ArgumentOutOfRangeException

year 9999'dan küçük veya 9999'dan büyük.

-veya-

month 12'den küçük veya 12'den büyük.

-veya-

dayiçindeki gün sayısından küçük veya daha büyük.month

-veya-

hour sıfırdan küçük veya 23'ten büyük.

-veya-

minute 0'dan küçük veya 59'dan büyük.

-veya-

second 0'dan küçük veya 59'dan büyük.

-veya-

offset -14 saatten az veya 14 saatten büyük.

-veya-

UtcDateTime Özelliği DateTimeOffset.MinValue değerinden veya DateTimeOffset.MaxValue değerinden daha eskidir.

Örnekler

Aşağıdaki örnek, oluşturucu aşırı yüklemesini kullanarak bir DateTimeOffset nesnenin örneğini DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) oluşturur.

   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

Açıklamalar

Bu oluşturucu, Gregoryen takvimde , monthve day değerlerini yıl, ay ve gün olarak yorumlaryear. Başka bir takvimde yıl, ay ve gün kullanarak bir DateTimeOffset değerin örneğini oluşturmak için oluşturucuyu çağırın DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) .

Ayrıca bkz.

DateTimeOffset Nesnesi Örneği Oluşturma

Şunlara uygulanır

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

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Belirtilen yıl, ay, gün, saat, dakika, saniye, milisaniye ve uzaklığı kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.

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)

Parametreler

year: Int32

Yıl (1-9999).

month: Int32

Ay (1-12).

day: Int32

Gün (1 ile içindeki monthgün sayısı arasında).

hour: Int32

Saat (0-23).

minute: Int32

Dakika (0-59).

second: Int32

Saniye (0-59).

millisecond: Int32

Milisaniye (0-999).

offset: TimeSpan

Zamanın Eşgüdümlü Evrensel Saat'ten (UTC) uzaklığı.

Özel durumlar

ArgumentException

offset dakikaların tamamını temsil etmez.

ArgumentOutOfRangeException

year 9999'dan küçük veya 9999'dan büyük.

-veya-

month 12'den küçük veya 12'den büyük.

-veya-

dayiçindeki gün sayısından küçük veya daha büyük.month

-veya-

hour sıfırdan küçük veya 23'ten büyük.

-veya-

minute 0'dan küçük veya 59'dan büyük.

-veya-

second 0'dan küçük veya 59'dan büyük.

-veya-

millisecond 0'dan küçük veya 999'dan büyük.

-veya-

offset -14'ten küçük veya 14'ten büyük.

-veya-

UtcDateTime Özelliği DateTimeOffset.MinValue değerinden veya DateTimeOffset.MaxValue değerinden daha eskidir.

Örnekler

Aşağıdaki örnek, oluşturucu aşırı yüklemesini kullanarak bir DateTimeOffset nesnenin örneğini DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) oluşturur.

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

Açıklamalar

Ayrıca bkz.

DateTimeOffset Nesnesi Örneği Oluşturma

Şunlara uygulanır

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

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Belirtilen takvimin DateTimeOffset belirtilen yıl, ay, gün, saat, dakika, saniye, milisaniye ve uzaklığını kullanarak yapının yeni bir örneğini başlatır.

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)

Parametreler

year: Int32

Yıl.

month: Int32

Ay (1-12).

day: Int32

Gün (1 ile içindeki monthgün sayısı arasında).

hour: Int32

Saat (0-23).

minute: Int32

Dakika (0-59).

second: Int32

Saniye (0-59).

millisecond: Int32

Milisaniye (0-999).

calendar: Calendar

, monthve dayyorumlarında yearkullanılan takvim.

offset: TimeSpan

Zamanın Eşgüdümlü Evrensel Saat'ten (UTC) uzaklığı.

Özel durumlar

ArgumentException

offset dakikaların tamamını temsil etmez.

ArgumentNullException

calendar olamaz null.

ArgumentOutOfRangeException

yearparametresinden MinSupportedDateTime.Year küçük veya değerinden calendar büyüktürMaxSupportedDateTime.Year.

-veya-

month içindeki ay yearcalendarsayısından küçük veya ondan büyük.

-veya-

dayiçindeki gün sayısından küçük veya daha büyük.month

-veya-

hour sıfırdan küçük veya 23'ten büyük.

-veya-

minute 0'dan küçük veya 59'dan büyük.

-veya-

second 0'dan küçük veya 59'dan büyük.

-veya-

millisecond 0'dan küçük veya 999'dan büyük.

-veya-

offset -14 saatten az veya 14 saatten büyük.

-veya-

year, monthve day parametreleri tarih ve saat değeri olarak temsil edilemez.

-veya-

UtcDateTime Özelliği DateTimeOffset.MinValue değerinden veya DateTimeOffset.MaxValue değerinden daha eskidir.

Örnekler

Aşağıdaki örnek, bir DateTimeOffset değerin örneğini oluşturmak için hem sınıfın hem de HebrewCalendar sınıfın HijriCalendar örneklerini kullanır. Bu tarih daha sonra ilgili takvimler ve Gregoryen takvim kullanılarak konsolda görüntülenir.

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

Açıklamalar

year, month, , day, hour, minute, secondve millisecond parametrelerinin tümü, parametresi tarafından calendar belirtilen takvimde ifade edilen değerleri yansıtır. Bu değerler bu takvim kullanılarak ifade edilemeyen bir tarih ve saat oluşturuyorsa özel durum oluşturulur.

Önemli

Japon takvimlerindeki dönemler imparatorun saltanatına dayanır ve bu nedenle değişmesi beklenir. Örneğin, 1 Mayıs 2019 ve JapaneseLunisolarCalendariçinde Reiwa döneminin başlangıcını işaretlediJapaneseCalendar. Bu tür bir çağ değişikliği, bu takvimleri kullanan tüm uygulamaları etkiler. Daha fazla bilgi edinmek ve uygulamalarınızın etkilenip etkilenmediğini belirlemek için bkz. .NET'te Japon takviminde yeni bir dönemi işleme. Uygulamalarınızı Windows sistemlerinde test ederek çağ değişikliğine hazır olmalarını sağlama hakkında bilgi için bkz. Uygulamanızı Japon dönemi değişikliğine hazırlama. .NET'te birden çok dönemi destekleyen takvimleri destekleyen özellikler ve birden çok dönemi destekleyen takvimlerle çalışırken en iyi yöntemler için bkz. Dönemlerle çalışma.

Ayrıca bkz.

DateTimeOffset Nesnesi Örneği Oluşturma

Şunlara uygulanır

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

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Belirtilen , , , , minutemillisecondsecondmicroseconddayhourve offsetkullanarak yapının yeni bir örneğini DateTimeOffset başlatır. monthyear

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)

Parametreler

year: Int32

Yıl (1-9999).

month: Int32

Ay (1-12).

day: Int32

Gün (1 ile içindeki monthgün sayısı arasında).

hour: Int32

Saat (0-23).

minute: Int32

Dakika (0-59).

second: Int32

Saniye (0-59).

millisecond: Int32

Milisaniye (0-999).

microsecond: Int32

Mikrosaniyeler (0 ile 999 arasında).

offset: TimeSpan

Zamanın Eşgüdümlü Evrensel Saat'ten (UTC) uzaklığı.

Özel durumlar

ArgumentException

offset dakikaların tamamını temsil etmez.

ArgumentOutOfRangeException

year 1'den küçük veya 9999'dan büyük.

-veya-

month 1'den küçük veya 12'den büyük.

-veya-

day 1'den küçük veya içindeki monthgün sayısından büyük.

-veya-

hour 0'dan küçük veya 23'ten büyük.

-veya-

minute 0'dan küçük veya 59'dan büyük.

-veya-

second 0'dan küçük veya 59'dan büyük.

-veya-

millisecond 0'dan küçük veya 999'dan büyük.

-veya-

microsecond 0'dan küçük veya 999'dan büyük.

Açıklamalar

Bu oluşturucu Gregoryen takviminde yıl, ay ve gün olarak ve monthday değerlerini yorumlaryear. Başka bir takvimde yıl, ay ve gün kullanarak bir DateTimeOffset değerin örneğini oluşturmak için oluşturucuyu çağırın DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) .

Şunlara uygulanır

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

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Belirtilen , , , , minutemillisecondsecondmicroseconddayhourve offsetkullanarak yapının yeni bir örneğini DateTimeOffset başlatır. monthyear

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)

Parametreler

year: Int32

Yıl (1-9999).

month: Int32

Ay (1-12).

day: Int32

Gün (1 ile içindeki monthgün sayısı arasında).

hour: Int32

Saat (0-23).

minute: Int32

Dakika (0-59).

second: Int32

Saniye (0-59).

millisecond: Int32

Milisaniye (0-999).

microsecond: Int32

Mikrosaniyeler (0 ile 999 arasında).

calendar: Calendar

, monthve dayyorumlarında yearkullanılan takvim.

offset: TimeSpan

Zamanın Eşgüdümlü Evrensel Saat'ten (UTC) uzaklığı.

Özel durumlar

ArgumentException

offset dakikaların tamamını temsil etmez.

ArgumentOutOfRangeException

year tarafından calendardesteklenen aralıkta değil.

-veya-

month 1'den küçük veya içindeki calendaray sayısından büyük.

-veya-

day 1'den küçük veya içindeki monthgün sayısından büyük.

-veya-

hour 0'dan küçük veya 23'ten büyük.

-veya-

minute 0'dan küçük veya 59'dan büyük.

-veya-

second 0'dan küçük veya 59'dan büyük.

-veya-

millisecond 0'dan küçük veya 999'dan büyük.

-veya-

microsecond 0'dan küçük veya 999'dan büyük.

-veya-

offset -14 saatten az veya 14 saatten büyük.

-veya-

year, monthve day parametreleri tarih ve saat değeri olarak temsil edilemez.

-veya-

UtcDateTime özelliği, değerinden MinValue önceki veya daha MaxValuesonraki bir özelliktir.

Açıklamalar

Şunlara uygulanır

DateTimeOffset Oluşturucular

Tanım

Aşırı Yüklemeler

DateTimeOffset(DateTime)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

DateTimeOffset(DateTime, TimeSpan)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

DateTimeOffset(Int64, TimeSpan)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Parametreler

Şunlara uygulanır

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

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

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

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

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

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

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

Parametreler

Özel durumlar

Açıklamalar

Şunlara uygulanır

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

Parametreler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Geri Bildirim

Ek kaynaklar