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.

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

Aşırı Yüklemeler

DateTimeOffset(DateTime)	Belirtilen DateTime değerini kullanarak DateTimeOffset yapısının yeni bir örneğini başlatır.
DateTimeOffset(DateTime, TimeSpan)	Belirtilen DateTime değerini ve uzaklığını kullanarak DateTimeOffset yapısının yeni bir örneğini başlatır.
DateTimeOffset(Int64, TimeSpan)	Belirtilen sayıda değer ve uzaklık kullanarak DateTimeOffset yapısının yeni bir örneğini başlatır.
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)	Belirtilen `date`, `time`ve `offset`kullanarak DateTimeOffset yapısının yeni bir örneğini başlatır.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Belirtilen yıl, ay, gün, saat, dakika, saniye ve uzaklığı kullanarak DateTimeOffset yapısının yeni bir örneğini 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 DateTimeOffset yapısının yeni bir örneğini başlatır.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Belirtilen takvimin belirtilen yıl, ay, gün, saat, dakika, saniye, milisaniye ve uzaklığını kullanarak DateTimeOffset yapısının yeni bir örneğini başlatır.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Belirtilen `year`, `month`, `day`, `hour`, `minute`, `second`, `millisecond`, `microsecond` ve `offset`kullanarak DateTimeOffset yapısının yeni bir örneğini başlatır.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Belirtilen `year`, `month`, `day`, `hour`, `minute`, `second`, `millisecond`, `microsecond` ve `offset`kullanarak DateTimeOffset yapısının yeni bir örneğini başlatır.

DateTimeOffset(DateTime)

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Belirtilen DateTime değerini kullanarak DateTimeOffset yapısının yeni bir örneğini 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ıyla sonuçlanan Eşgüdümlü Evrensel Saat (UTC) tarih ve saati, DateTimeOffset.MinValuedeğerinden daha eskidir.

-veya-

Uzaklık uygulanmasından kaynaklanan UTC tarih ve saati, DateTimeOffset.MaxValue'den daha geç olur.

Örnekler

Aşağıdaki örnekte, dateTime parametresinin DateTime.Kind özelliğinin değerinin 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ışı, dateTime parametresinin DateTime.Kind özelliğinin değerine bağlıdır:

DateTime.Kind değeri DateTimeKind.Utcise, yeni örneğin DateTime özelliği dateTimedeğerine, Offset özelliği de Zerodeğerine eşit olarak ayarlanır.
DateTime.Kind değeri DateTimeKind.Local veya DateTimeKind.Unspecifiedise, yeni örneğin DateTime özelliği dateTimedeğerine, Offset ö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ğerini ve uzaklığını kullanarak DateTimeOffset yapısının yeni bir örneğini 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

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

Özel durumlar

ArgumentException

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

-veya-

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

-veya-

offset dakika içinde belirtilmez.

ArgumentOutOfRangeException

offset -14 saatten kısa veya 14 saatten uzundur.

-veya-

UtcDateTime DateTimeOffset.MinValue veya DateTimeOffset.MaxValuedeğerinden büyüktür.

Örnekler

Aşağıdaki örnekte, tarih ve saat ile bir DateTimeOffset nesnesinin nasıl başlatıldığını ve bu 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 dateTime parametresinin Kind özelliğinin değerine bağlıdır:

Kind değeri DateTimeKind.Utcise, offset parametresinin değeri 0 olmalıdır veya bir ArgumentException oluşturulur.
Kind değeri DateTimeKind.Localise, offset parametresinin 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.
Kind değeri DateTimeKind.Unspecifiedise, offset parametresi geçerli 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 DateTimeOffset yapısının yeni bir örneğini 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 12:00:00 gece yarısından bu yana geçen 100 nanosaniyelik aralık sayısı olarak ifade edilen tarih ve saat.

offset: TimeSpan

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

Özel durumlar

ArgumentException

offset dakika içinde belirtilmez.

ArgumentOutOfRangeException

UtcDateTime özelliği DateTimeOffset.MinValue veya DateTimeOffset.MaxValuedeğerinden daha eskidir.

-veya-

ticks DateTimeOffset.MinValue.Ticks veya DateTimeOffset.MaxValue.Ticks'den büyüktür.

-veya-

offset -14 saatten kısa veya 14 saatten uzundur.

Örnekler

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

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 dilimi dışında bir uzaklık ile bir DateTimeOffset değeri örneği oluşturmak için DateTimeOffset oluşturucuyu çağırmaya çalışmak ArgumentExceptionoluşturur. Bu sınırlamayı geçici olarak çözmek için DateTimeOffset oluşturucusunun bu aşırı yüklemesini kullanabilirsiniz. Aşağıdaki örnek, uzaklığı yerel saatin değerini göstermek zorunda olmayan bir DateTimeOffset değeri örneği oluşturmak için yerel saatin değer sayısını kullanı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 DateTimeOffset yapısının yeni bir örneğini 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

Saatin 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 DateTimeOffset yapısının yeni bir örneğini 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 ile 9999 arasında).

month: Int32

Ay (1 ile 12 arasında).

day: Int32

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

hour: Int32

Saatler (0 ile 23 arasında).

minute: Int32

Dakika (0 ile 59 arasında).

second: Int32

Saniye (0 ile 59 arasında).

offset: TimeSpan

Saatin 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 daha büyük.

-veya-

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

-veya-

day, monthgün sayısından küçük veya daha büyük.

-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 kısa veya 14 saatten uzundur.

-veya-

UtcDateTime özelliği DateTimeOffset.MinValue veya DateTimeOffset.MaxValuedeğerinden daha eskidir.

Örnekler

Aşağıdaki örnek, DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) oluşturucu aşırı yüklemesini kullanarak bir DateTimeOffset nesnesinin örneğini 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 year, monthve day yıl, ay ve gün olarak yorumlar. Başka bir takvimde yıl, ay ve gün kullanarak bir DateTimeOffset değeri örneği oluşturmak için DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) oluşturucuyu çağırın.

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 DateTimeOffset yapısı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, 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 ile 9999 arasında).

month: Int32

Ay (1 ile 12 arasında).

day: Int32

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

hour: Int32

Saatler (0 ile 23 arasında).

minute: Int32

Dakika (0 ile 59 arasında).

second: Int32

Saniye (0 ile 59 arasında).

millisecond: Int32

Milisaniye (0 ile 999 arasında).

offset: TimeSpan

Saatin 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 daha büyük.

-veya-

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

-veya-

day, monthgün sayısından küçük veya daha büyük.

-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 veya 14'ten büyük.

-veya-

UtcDateTime özelliği DateTimeOffset.MinValue veya DateTimeOffset.MaxValuedeğerinden daha eskidir.

Örnekler

Aşağıdaki örnek, DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) oluşturucu aşırı yüklemesini kullanarak bir DateTimeOffset nesnesinin örneğini 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 belirtilen yıl, ay, gün, saat, dakika, saniye, milisaniye ve uzaklığını kullanarak DateTimeOffset yapısı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 ile 12 arasında).

day: Int32

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

hour: Int32

Saatler (0 ile 23 arasında).

minute: Int32

Dakika (0 ile 59 arasında).

second: Int32

Saniye (0 ile 59 arasında).

millisecond: Int32

Milisaniye (0 ile 999 arasında).

calendar: Calendar

year, monthve dayyorumlamak için kullanılan takvim.

offset: TimeSpan

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

Özel durumlar

ArgumentException

offset dakikaların tamamını temsil etmez.

ArgumentNullException

calendar nullolamaz.

ArgumentOutOfRangeException

year, calendar parametresinin MinSupportedDateTime.Year veya MaxSupportedDateTime.Yeardeğerinden büyüktür.

-veya-

month, calendaryear içindeki ay sayısından küçük veya ondan büyük.

-veya-

day, monthgün sayısından küçük veya daha büyük.

-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 kısa veya 14 saatten uzundur.

-veya-

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

-veya-

UtcDateTime özelliği DateTimeOffset.MinValue veya DateTimeOffset.MaxValuedeğerinden daha eskidir.

Örnekler

Aşağıdaki örnek, bir DateTimeOffset değeri örneği oluşturmak için hem HebrewCalendar sınıfı hem de HijriCalendar sınıfının ö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 parametreleri, calendar parametresi tarafından belirtilen takvimde ifade edilen değerleri yansıtır. Bu değerler bu takvim kullanılarak ifade edilemeyen bir tarih ve saat oluşturuyorsa bir ö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, JapaneseCalendar ve JapaneseLunisolarCalendarReiwa döneminin başlangıcını işaretledi. Bu tür bir dönem 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. .NETJapon takviminde yeni bir çağı işleme. Zaman değişikliğine hazır olduğundan emin olmak için uygulamalarınızı Windows sistemlerinde test etme hakkında bilgi için bkz. Uygulamanızı Japon çağı değişikliğine hazırlama. .NET'te birden çok çağa sahip takvimleri destekleyen özellikler ve birden çok çağı 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 year, month, day, hour, minute, second, millisecond, microsecond ve offsetkullanarak DateTimeOffset yapısı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, 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 ile 9999 arasında).

month: Int32

Ay (1 ile 12 arasında).

day: Int32

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

hour: Int32

Saatler (0 ile 23 arasında).

minute: Int32

Dakika (0 ile 59 arasında).

second: Int32

Saniye (0 ile 59 arasında).

millisecond: Int32

Milisaniye (0 ile 999 arasında).

microsecond: Int32

Mikrosaniyeler (0 ile 999 arasında).

offset: TimeSpan

Saatin 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, monthiçindeki gün sayısından 1'den küçük veya daha 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 takvimde year, month ve day yıl, ay ve gün olarak yorumlar. Başka bir takvimde yıl, ay ve gün kullanarak bir DateTimeOffset değeri örneği oluşturmak için DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) oluşturucuyu çağırın.

Şunlara uygulanır

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

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Belirtilen year, month, day, hour, minute, second, millisecond, microsecond ve offsetkullanarak DateTimeOffset yapısı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, 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 ile 9999 arasında).

month: Int32

Ay (1 ile 12 arasında).

day: Int32

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

hour: Int32

Saatler (0 ile 23 arasında).

minute: Int32

Dakika (0 ile 59 arasında).

second: Int32

Saniye (0 ile 59 arasında).

millisecond: Int32

Milisaniye (0 ile 999 arasında).

microsecond: Int32

Mikrosaniyeler (0 ile 999 arasında).

calendar: Calendar

year, monthve dayyorumlamak için kullanılan takvim.

offset: TimeSpan

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

Özel durumlar

ArgumentException

offset dakikaların tamamını temsil etmez.

ArgumentOutOfRangeException

year, calendartarafından desteklenen aralıkta değil.

-veya-

month, calendariçindeki ay sayısından 1'den küçük veya daha büyük.

-veya-

day, monthiçindeki gün sayısından 1'den küçük veya daha 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 kısa veya 14 saatten uzundur.

-veya-

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

-veya-

UtcDateTime özelliği, MinValue'den önce veya MaxValue'den sonraki bir özelliktir.

Açıklamalar

Şunlara uygulanır

Aracılığıyla paylaş

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

Ek kaynaklar