DateTimeOffset Oluşturucular
Tanım
Ö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 |
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 , , , , |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) |
Belirtilen , , , , |
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
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şit
dateTime
Offset, özelliği ise değerine eşit Zeroolarak ayarlanır.DateTimeDateTimeKind.UtcDateTime.Kinddeğeri DateTime.Kind veya DateTimeDateTimeKind.UnspecifiediseDateTimeKind.Local, yeni örneğin özelliği değerine eşit Offset
dateTime
, özelliği ise yerel sistemin geçerli saat diliminin uzaklığıyla eşit olarak ayarlanır.
Ayrıca bkz.
Ş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
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.
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.
Ş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
offset
tam dakika içinde belirtilmez.
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.
Şunlara uygulanır
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)
- Kaynak:
- DateTimeOffset.cs
- Kaynak:
- DateTimeOffset.cs
Belirtilen date
, time
ve offset
kullanarak 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 month
gü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
offset
dakikaların tamamını temsil etmez.
year
9999'dan küçük veya 9999'dan büyük.
-veya-
month
12'den küçük veya 12'den büyük.
-veya-
day
iç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 , month
ve 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.
Ş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 month
gü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
offset
dakikaların tamamını temsil etmez.
year
9999'dan küçük veya 9999'dan büyük.
-veya-
month
12'den küçük veya 12'den büyük.
-veya-
day
iç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
Bu oluşturucu, Gregoryen takvimde , month
ve 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.
Ş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 month
gü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
, month
ve day
yorumlarında year
kullanılan takvim.
- offset
- TimeSpan
Zamanın Eşgüdümlü Evrensel Saat'ten (UTC) uzaklığı.
Özel durumlar
offset
dakikaların tamamını temsil etmez.
calendar
olamaz null
.
year
parametresinden MinSupportedDateTime.Year
küçük veya değerinden calendar
büyüktürMaxSupportedDateTime.Year
.
-veya-
month
içindeki ay year
calendar
sayısından küçük veya ondan büyük.
-veya-
day
iç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
, month
ve 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
, second
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 ö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.
Şunlara uygulanır
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)
- Kaynak:
- DateTimeOffset.cs
- Kaynak:
- DateTimeOffset.cs
- Kaynak:
- DateTimeOffset.cs
Belirtilen , , , , minute
millisecond
second
microsecond
day
hour
ve offset
kullanarak yapının yeni bir örneğini DateTimeOffset başlatır. month
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-9999).
- month
- Int32
Ay (1-12).
- day
- Int32
Gün (1 ile içindeki month
gü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
offset
dakikaların tamamını temsil etmez.
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 month
gü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 month
day
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 , , , , minute
millisecond
second
microsecond
day
hour
ve offset
kullanarak yapının yeni bir örneğini DateTimeOffset başlatır. month
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-9999).
- month
- Int32
Ay (1-12).
- day
- Int32
Gün (1 ile içindeki month
gü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
, month
ve day
yorumlarında year
kullanılan takvim.
- offset
- TimeSpan
Zamanın Eşgüdümlü Evrensel Saat'ten (UTC) uzaklığı.
Özel durumlar
offset
dakikaların tamamını temsil etmez.
year
tarafından calendar
desteklenen aralıkta değil.
-veya-
month
1'den küçük veya içindeki calendar
ay sayısından büyük.
-veya-
day
1'den küçük veya içindeki month
gü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
, month
ve 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
Bu oluşturucu Gregoryen takviminde yıl, ay ve gün olarak ve month
day
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
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin