DateTimeOffset Oluşturucular

Tanım

Ad Alanı:: System

Bütünleştirilmiş Kodlar:: mscorlib.dll, System.Runtime.dll

Bütünleştirilmiş Kodlar:: netstandard.dll, System.Runtime.dll

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

Name	Description
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 `offset`kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.
DateTimeOffset(Int64, TimeSpan)	Belirtilen ve sayısını `ticksoffset`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 , , , `secondminutemonthhourday`ve `offset`kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.`year`
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Belirtilen , , , `daymonth`, `millisecondminutesecondhour`ve `offset`kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.`year`
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Belirtilen , , , `monthday`, `secondminutehour`, `calendarmillisecond`, ve `offset`kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.`year`
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Belirtilen , , , `monthday`, `secondminutehour`, `microsecondmillisecond`, ve `offset`kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.`year`
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Belirtilen , , , `month`, `day`, `millisecondhourcalendarminutemicrosecondsecond`ve `offset`kullanarak yapının yeni bir örneğini DateTimeOffset başlatır.`year`

DateTimeOffset(DateTime)

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

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 geç olur.

Örnekler

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

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 DateTime.Kind özelliğinin dateTime değerine bağlıdır:

değeri ise, yeni örneğin özelliği değerine, dateTimeOffset ö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, OffsetdateTimeözelliği ise yerel sistemin geçerli saat diliminin uzaklığı değerine 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

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

belirtilen DateTime değeri ve offsetkullanarak 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

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 tam dakika içinde belirtilmez.

ArgumentOutOfRangeException

offset -14 saatten az veya 14 saatten uzundur.

-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 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 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, parametresinin 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

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Belirtilen ve sayısını ticksoffsetkullanarak 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 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 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 uzundur.

Ö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 dilimi dışında bir uzaklık ile bir DateTimeOffset değer örneği 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 örnek, uzaklığı yerel saatin değerini temsil etmemesi gereken bir DateTimeOffset değerin örneğini 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

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

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

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

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

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 içindeki 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 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 uzundur.

-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 year, monthve day değerlerini yıl, ay ve gün olarak yorumlar. 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

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Belirtilen , , , daymonth, millisecondminutesecondhourve offsetkullanarak yapının yeni bir örneğini DateTimeOffset başlatır.year

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 içindeki 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 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 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

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Belirtilen , , , monthday, secondminutehour, calendarmillisecond, ve offsetkullanarak yapının yeni bir örneğini DateTimeOffset başlatır.year

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 içindeki 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

, monthve dayyorumlarında yearkullanı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 null olamaz.

ArgumentOutOfRangeException

yearparametresinin MinSupportedDateTime.Year değerinden küçük veya değerinden calendarMaxSupportedDateTime.Yearbüyüktür.

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

-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, , secondminute, ve 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 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

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Belirtilen , , , monthday, secondminutehour, microsecondmillisecond, ve offsetkullanarak yapının yeni bir örneğini DateTimeOffset başlatır.year

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 içindeki 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 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 year, Gregoryen takvimde yıl month , ay ve gün olarak ve day yorumlar. 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

Kaynak:: DateTimeOffset.cs

Kaynak:: DateTimeOffset.cs

Belirtilen , , , month, day, millisecondhourcalendarminutemicrosecondsecondve offsetkullanarak yapının yeni bir örneğini DateTimeOffset başlatır.year

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 içindeki 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

, monthve dayyorumlarında yearkullanı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 tarafından calendardesteklenen aralıkta değil.

-veya-

monthiçindeki ay sayısından 1'den küçük veya daha büyük.calendar

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

-veya-

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

-veya-

UtcDateTime özelliği, değerinden MinValue önceki veya sonraki MaxValuebir özelliktir.

Açıklamalar

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

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

Geri Bildirim