DateTimeOffset Konstruktor

Referensi

Definisi

Ruang nama:: System

Rakitan:: System.Runtime.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menginisialisasi instans DateTimeOffset baru struktur.

Overload

DateTimeOffset(DateTime)	Menginisialisasi instans DateTimeOffset baru struktur menggunakan nilai yang ditentukan DateTime .
DateTimeOffset(DateTime, TimeSpan)	Menginisialisasi instans DateTimeOffset baru struktur menggunakan nilai dan offset yang ditentukan DateTime .
DateTimeOffset(Int64, TimeSpan)	Menginisialisasi instans DateTimeOffset baru struktur menggunakan jumlah tick dan offset yang ditentukan.
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)	Menginisialisasi instans DateTimeOffset baru struktur menggunakan , , `time`dan `offset`yang ditentukan`date`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Menginisialisasi instans DateTimeOffset baru struktur menggunakan tahun, bulan, hari, jam, menit, detik, dan offset yang ditentukan.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Menginisialisasi instans DateTimeOffset baru struktur menggunakan tahun, bulan, hari, jam, menit, detik, milidetik, dan offset yang ditentukan.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Menginisialisasi instans DateTimeOffset baru struktur menggunakan tahun, bulan, hari, jam, menit, detik, milidetik yang ditentukan, dan offset kalender tertentu.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Menginisialisasi instans baru struktur DateTimeOffset menggunakan , , , `daymonth`, `minutehour`, , `second`, `millisecond`, `microsecond` dan `offset`yang ditentukan`year`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Menginisialisasi instans baru struktur DateTimeOffset menggunakan , , , `daymonth`, `minutehour`, , `second`, `millisecond`, `microsecond` dan `offset`yang ditentukan`year`.

DateTimeOffset(DateTime)

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Menginisialisasi instans DateTimeOffset baru struktur menggunakan nilai yang ditentukan DateTime .

public:
 DateTimeOffset(DateTime dateTime);

public DateTimeOffset (DateTime dateTime);

new DateTimeOffset : DateTime -> DateTimeOffset

Public Sub New (dateTime As DateTime)

Parameter

dateTime: DateTime

Tanggal dan waktu.

Pengecualian

ArgumentOutOfRangeException

Tanggal dan waktu Waktu Universal Terkoordinasi (UTC) yang dihasilkan dari penerapan offset lebih awal dari DateTimeOffset.MinValue.

-atau-

Tanggal dan waktu UTC yang dihasilkan dari penerapan offset lebih lambat dari DateTimeOffset.MaxValue.

Contoh

Contoh berikut menggambarkan bagaimana nilai DateTime.Kind properti dateTime parameter memengaruhi nilai tanggal dan waktu yang dikembalikan oleh konstruktor ini.

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

Keterangan

Perilaku konstruktor ini tergantung pada nilai DateTime.Kind properti dateTime parameter:

Jika nilai adalah , properti instans baru diatur sama dengan dateTime, dan Offset properti diatur sama dengan Zero.DateTime DateTimeKind.Utc DateTime.Kind
Jika nilai DateTime.Kind adalah DateTimeKind.Local atau DateTimeKind.Unspecified, DateTime properti instans baru diatur sama dengan dateTime, dan Offset properti diatur sama dengan offset zona waktu sistem lokal saat ini.

Lihat juga

Membuat instans Objek DateTimeOffset

Berlaku untuk

DateTimeOffset(DateTime, TimeSpan)

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Menginisialisasi instans DateTimeOffset baru struktur menggunakan nilai dan offset yang ditentukan DateTime .

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)

Parameter

dateTime: DateTime

Tanggal dan waktu.

offset: TimeSpan

Offset waktu dari Waktu Universal Terkoordinasi (UTC).

Pengecualian

ArgumentException

dateTime.KindUtc sama dengan dan offset tidak sama dengan nol.

-atau-

dateTime.KindLocal sama dengan dan offset tidak sama dengan offset zona waktu lokal sistem.

-atau-

offset tidak ditentukan dalam seluruh menit.

ArgumentOutOfRangeException

offset kurang dari -14 jam atau lebih dari 14 jam.

-atau-

UtcDateTime kurang dari DateTimeOffset.MinValue atau lebih besar dari DateTimeOffset.MaxValue.

Contoh

Contoh berikut menunjukkan cara menginisialisasi DateTimeOffset objek dengan tanggal dan waktu dan offset zona waktu lokal ketika zona waktu tersebut tidak diketahui sebelumnya.

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

Keterangan

Perilaku konstruktor ini sebagian bergantung pada nilai Kind properti dateTime parameter:

Jika nilai Kind adalah , nilai offset parameter harus 0 atau dilemparkan ArgumentException DateTimeKind.Utc.
Jika nilai Kind adalah , nilai offset parameter harus sama dengan offset zona waktu lokal dari Waktu Universal Terkoordinasi (UTC) untuk tanggal tertentu atau ArgumentException DateTimeKind.Localdilemparkan.
Jika nilai Kind adalah DateTimeKind.Unspecified, offset parameter dapat memiliki nilai yang valid.

Lihat juga

Membuat instans Objek DateTimeOffset

Berlaku untuk

DateTimeOffset(Int64, TimeSpan)

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Menginisialisasi instans DateTimeOffset baru struktur menggunakan jumlah tick dan offset yang ditentukan.

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)

Parameter

ticks: Int64

Tanggal dan waktu yang dinyatakan sebagai jumlah interval 100 nanodetik yang telah berlalu sejak pukul 12:00:00 tengah malam pada 1 Januari 0001.

offset: TimeSpan

Offset waktu dari Waktu Universal Terkoordinasi (UTC).

Pengecualian

ArgumentException

offset tidak ditentukan dalam seluruh menit.

ArgumentOutOfRangeException

Properti UtcDateTime lebih lama dari DateTimeOffset.MinValue atau lebih baru dari DateTimeOffset.MaxValue.

-atau-

ticks kurang dari DateTimeOffset.MinValue.Ticks atau lebih besar dari DateTimeOffset.MaxValue.Ticks.

-atau-

Offset s kurang dari -14 jam atau lebih dari 14 jam.

Contoh

Contoh berikut menginisialisasi DateTimeOffset objek dengan menggunakan jumlah tick dalam tanggal arbitrer (dalam hal ini, 16 Juli 2007, pukul 13.32) dengan offset -5.

DateTime dateWithoutOffset = new DateTime(2007, 7, 16, 13, 32, 00);
DateTimeOffset timeFromTicks = new DateTimeOffset(dateWithoutOffset.Ticks,
                               new TimeSpan(-5, 0, 0));
Console.WriteLine(timeFromTicks.ToString());
// The code produces the following output:
//    7/16/2007 1:32:00 PM -05:00

let dateWithoutOffset = DateTime(2007, 7, 16, 13, 32, 00)
let timeFromTicks = DateTimeOffset(dateWithoutOffset.Ticks, TimeSpan(-5, 0, 0))
printfn $"{timeFromTicks}"
// The code produces the following output:
//    7/16/2007 1:32:00 PM -05:00

Dim dateWithoutOffset As Date = #07/16/2007 1:32PM#
Dim timeFromTicks As New DateTimeOffset(datewithoutOffset.Ticks, _
                         New TimeSpan(-5, 0, 0))
Console.WriteLine(timeFromTicks.ToString())
' The code produces the following output:
'    7/16/2007 1:32:00 PM -05:00

Keterangan

Biasanya, mencoba memanggil DateTimeOffset konstruktor untuk membuat instans DateTimeOffset nilai dengan waktu lokal dan offset selain zona waktu lokal melempar ArgumentException. Anda dapat menggunakan kelebihan beban DateTimeOffset konstruktor ini untuk mengatasi batasan ini. Contoh berikut menggunakan jumlah tanda centang waktu setempat untuk membuat instans DateTimeOffset nilai yang offsetnya tidak selalu mewakili waktu setempat:

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

Lihat juga

Membuat instans Objek DateTimeOffset

Berlaku untuk

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Menginisialisasi instans DateTimeOffset baru struktur menggunakan , , timedan offsetyang ditentukandate.

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)

Parameter

date: DateOnly

Bagian tanggal.

time: TimeOnly

Bagian waktu.

offset: TimeSpan

Offset waktu dari Waktu Universal Terkoordinasi (UTC).

Berlaku untuk

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

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Menginisialisasi instans DateTimeOffset baru struktur menggunakan tahun, bulan, hari, jam, menit, detik, dan offset yang ditentukan.

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)

Parameter

year: Int32

Tahun (1 sampai 9999).

month: Int32

Bulan (1 hingga 12).

day: Int32

Hari (1 hingga jumlah hari dalam month).

hour: Int32

Jam (0 hingga 23).

minute: Int32

Menit (0 sampai 59).

second: Int32

Detik (0 hingga 59).

offset: TimeSpan

Offset waktu dari Waktu Universal Terkoordinasi (UTC).

Pengecualian

ArgumentException

offset tidak mewakili seluruh menit.

ArgumentOutOfRangeException

year kurang dari satu atau lebih besar dari 9999.

-atau-

month kurang dari satu atau lebih besar dari 12.

-atau-

day kurang dari satu atau lebih besar dari jumlah hari dalam month.

-atau-

hour kurang dari nol atau lebih besar dari 23.

-atau-

minute kurang dari 0 atau lebih besar dari 59.

-atau-

second kurang dari 0 atau lebih besar dari 59.

-atau-

offset kurang dari -14 jam atau lebih dari 14 jam.

-atau-

Properti UtcDateTime lebih lama dari DateTimeOffset.MinValue atau lebih baru dari DateTimeOffset.MaxValue.

Contoh

Contoh berikut membuat instans DateTimeOffset objek dengan menggunakan DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) kelebihan beban konstruktor.

   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

Keterangan

Konstruktor ini menafsirkan year, , monthdan day sebagai tahun, bulan, dan hari dalam kalender Gregorian. Untuk membuat instans DateTimeOffset nilai dengan menggunakan tahun, bulan, dan hari di kalender lain, panggil DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) konstruktor.

Lihat juga

Membuat instans Objek DateTimeOffset

Berlaku untuk

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

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Menginisialisasi instans DateTimeOffset baru struktur menggunakan tahun, bulan, hari, jam, menit, detik, milidetik, dan offset yang ditentukan.

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)

Parameter

year: Int32

Tahun (1 hingga 9999).

month: Int32

Bulan (1 hingga 12).

day: Int32

Hari (1 hingga jumlah hari dalam month).

hour: Int32

Jam (0 sampai 23).

minute: Int32

Menit (0 sampai 59).

second: Int32

Detik (0 hingga 59).

millisecond: Int32

Milidetik (0 hingga 999).

offset: TimeSpan

Offset waktu dari Coordinated Universal Time (UTC).

Pengecualian

ArgumentException

offset tidak mewakili seluruh menit.

ArgumentOutOfRangeException

year kurang dari satu atau lebih besar dari 9999.

-atau-

month kurang dari satu atau lebih besar dari 12.

-atau-

day kurang dari satu atau lebih besar dari jumlah hari dalam month.

-atau-

hour kurang dari nol atau lebih besar dari 23.

-atau-

minute kurang dari 0 atau lebih besar dari 59.

-atau-

second kurang dari 0 atau lebih besar dari 59.

-atau-

millisecond kurang dari 0 atau lebih besar dari 999.

-atau-

offset kurang dari -14 atau lebih besar dari 14.

-atau-

Properti UtcDateTime lebih lama dari DateTimeOffset.MinValue atau yang lebih baru dari DateTimeOffset.MaxValue.

Contoh

Contoh berikut membuat instans DateTimeOffset objek dengan menggunakan DateTimeOffset.DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan) kelebihan beban konstruktor.

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

Keterangan

Konstruktor ini menafsirkan year, month, dan day sebagai tahun, bulan, dan hari di kalender Gregorian. Untuk membuat instans DateTimeOffset nilai dengan menggunakan tahun, bulan, dan hari di kalender lain, panggil DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) konstruktor.

Lihat juga

Membuat instans Objek DateTimeOffset

Berlaku untuk

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

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Menginisialisasi instans DateTimeOffset baru struktur menggunakan tahun, bulan, hari, jam, menit, detik, milidetik yang ditentukan, dan offset kalender tertentu.

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)

Parameter

year: Int32

Tahun ini.

month: Int32

Bulan (1 hingga 12).

day: Int32

Hari (1 hingga jumlah hari dalam month).

hour: Int32

Jam (0 sampai 23).

minute: Int32

Menit (0 sampai 59).

second: Int32

Detik (0 hingga 59).

millisecond: Int32

Milidetik (0 hingga 999).

calendar: Calendar

Kalender yang digunakan untuk menginterpretasikan year, month, dan day.

offset: TimeSpan

Offset waktu dari Coordinated Universal Time (UTC).

Pengecualian

ArgumentException

offset tidak mewakili seluruh menit.

ArgumentNullException

calendar tidak bisa menjadi null.

ArgumentOutOfRangeException

year kurang dari calendar parameter MinSupportedDateTime.Year atau lebih besar dari MaxSupportedDateTime.Year.

-atau-

month kurang dari atau lebih besar dari jumlah bulan dalam yearcalendar.

-atau-

day kurang dari satu atau lebih besar dari jumlah hari dalam month.

-atau-

hour kurang dari nol atau lebih besar dari 23.

-atau-

minute kurang dari 0 atau lebih besar dari 59.

-atau-

second kurang dari 0 atau lebih besar dari 59.

-atau-

millisecond kurang dari 0 atau lebih besar dari 999.

-atau-

offset kurang dari -14 jam atau lebih dari 14 jam.

-atau-

Parameter year, month, dan day tidak dapat direpresentasikan sebagai nilai tanggal dan waktu.

-atau-

Properti UtcDateTime lebih lama dari DateTimeOffset.MinValue atau yang lebih baru dari DateTimeOffset.MaxValue.

Contoh

Contoh berikut menggunakan instans kelas dan HijriCalendar kelas untuk membuat DateTimeOffset instans HebrewCalendar nilai. Tanggal tersebut kemudian ditampilkan ke konsol menggunakan kalender masing-masing dan kalender Gregorian.

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

Keterangan

Parameter year, , daymonthhour, minute, , second, dan millisecond semuanya mencerminkan nilai yang dinyatakan dalam kalender yang ditentukan oleh calendar parameter . Pengecualian dilemparkan jika nilai-nilai ini membentuk tanggal dan waktu yang tidak dapat diekspresikan dengan menggunakan kalender ini.

Penting

Era dalam kalender Jepang didasarkan pada pemerintahan kaisar dan karenanya diharapkan berubah. Misalnya, 1 Mei 2019 menandai awal era Reiwa di JapaneseCalendar dan JapaneseLunisolarCalendar. Perubahan era seperti itu mempengaruhi semua aplikasi yang menggunakan kalender ini. Untuk informasi selengkapnya dan untuk menentukan apakah aplikasi Anda terpengaruh, lihat Menangani era baru di kalender Jepang di .NET. Untuk informasi tentang menguji aplikasi Anda pada sistem Windows untuk memastikan kesiapannya untuk perubahan era, lihat Menyiapkan aplikasi Anda untuk perubahan era Jepang. Untuk fitur di .NET yang mendukung kalender dengan beberapa era dan untuk praktik terbaik saat bekerja dengan kalender yang mendukung beberapa era, lihat Bekerja dengan era.

Lihat juga

Membuat instans Objek DateTimeOffset

Berlaku untuk

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

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Menginisialisasi instans DateTimeOffset baru struktur menggunakan , , month, day, minutehour, , second, millisecond, microsecond dan offsetyang ditentukanyear.

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)

Parameter

year: Int32

Tahun (1 hingga 9999).

month: Int32

Bulan (1 hingga 12).

day: Int32

Hari (1 hingga jumlah hari dalam month).

hour: Int32

Jam (0 sampai 23).

minute: Int32

Menit (0 sampai 59).

second: Int32

Detik (0 hingga 59).

millisecond: Int32

Milidetik (0 hingga 999).

microsecond: Int32

Mikrostik (0 hingga 999).

offset: TimeSpan

Offset waktu dari Coordinated Universal Time (UTC).

Pengecualian

ArgumentException

offset tidak mewakili seluruh menit.

ArgumentOutOfRangeException

year kurang dari 1 atau lebih besar dari 9999.

-atau-

month kurang dari 1 atau lebih besar dari 12.

-atau-

day kurang dari 1 atau lebih besar dari jumlah hari dalam month.

-atau-

hour kurang dari 0 atau lebih besar dari 23.

-atau-

minute kurang dari 0 atau lebih besar dari 59.

-atau-

second kurang dari 0 atau lebih besar dari 59.

-atau-

millisecond kurang dari 0 atau lebih besar dari 999.

-atau-

microsecond kurang dari 0 atau lebih besar dari 999.

Keterangan

Konstruktor ini menafsirkan year, month dan day sebagai tahun, bulan dan hari dalam kalender Gregorian. Untuk membuat instans DateTimeOffset nilai dengan menggunakan tahun, bulan, dan hari di kalender lain, panggil DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) konstruktor.

Berlaku untuk

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

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Menginisialisasi instans baru struktur DateTimeOffset menggunakan , , , daymonth, minutehour, , second, millisecond, microsecond dan offsetyang ditentukanyear.

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)

Parameter

year: Int32

Tahun (1 sampai 9999).

month: Int32

Bulan (1 hingga 12).

day: Int32

Hari (1 hingga jumlah hari dalam month).

hour: Int32

Jam (0 hingga 23).

minute: Int32

Menit (0 sampai 59).

second: Int32

Detik (0 hingga 59).

millisecond: Int32

Milidetik (0 hingga 999).

microsecond: Int32

Mikro detik (0 hingga 999).

calendar: Calendar

Kalender yang digunakan untuk menafsirkan year, , monthdan day.

offset: TimeSpan

Offset waktu dari Waktu Universal Terkoordinasi (UTC).

Pengecualian

ArgumentException

offset tidak mewakili seluruh menit.

ArgumentOutOfRangeException

year tidak dalam rentang yang didukung oleh calendar.

-atau-

month kurang dari 1 atau lebih besar dari jumlah bulan dalam calendar.

-atau-

day kurang dari 1 atau lebih besar dari jumlah hari dalam month.

-atau-

hour kurang dari 0 atau lebih besar dari 23.

-atau-

minute kurang dari 0 atau lebih besar dari 59.

-atau-

second kurang dari 0 atau lebih besar dari 59.

-atau-

millisecond kurang dari 0 atau lebih besar dari 999.

-atau-

microsecond kurang dari 0 atau lebih besar dari 999.

-atau-

offset kurang dari -14 jam atau lebih dari 14 jam.

-atau-

Parameter year, month, dan day tidak dapat direpresentasikan sebagai nilai tanggal dan waktu.

-atau-

Properti UtcDateTime lebih awal dari MinValue atau lebih baru dari MaxValue.

Keterangan

Berlaku untuk

DateTimeOffset Konstruktor

Definisi

Overload

DateTimeOffset(DateTime)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

DateTimeOffset(DateTime, TimeSpan)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

DateTimeOffset(Int64, TimeSpan)

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

DateTimeOffset(DateOnly, TimeOnly, TimeSpan)

Parameter

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Pengecualian

Keterangan

Berlaku untuk

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

Parameter

Pengecualian

Keterangan

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: