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 baru struktur DateTimeOffset.

Overload

DateTimeOffset(DateTime)	Menginisialisasi instans baru struktur DateTimeOffset menggunakan nilai DateTime yang ditentukan.
DateTimeOffset(DateTime, TimeSpan)	Menginisialisasi instans baru struktur DateTimeOffset menggunakan nilai dan offset DateTime yang ditentukan.
DateTimeOffset(Int64, TimeSpan)	Menginisialisasi instans baru struktur DateTimeOffset menggunakan jumlah tick dan offset yang ditentukan.
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)	Menginisialisasi instans baru struktur DateTimeOffset menggunakan `date`yang ditentukan, `time`, dan `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Menginisialisasi instans baru struktur DateTimeOffset menggunakan tahun, bulan, hari, jam, menit, detik, dan offset yang ditentukan.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, TimeSpan)	Menginisialisasi instans baru struktur DateTimeOffset menggunakan tahun, bulan, hari, jam, menit, detik, milidetik, dan offset yang ditentukan.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Menginisialisasi instans baru struktur DateTimeOffset 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 `year`, `month`, `day`, `hour`, `minute`, `second`, `millisecond`, `microsecond` dan `offset`.
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan)	Menginisialisasi instans baru struktur DateTimeOffset menggunakan `year`, `month`, `day`, `hour`, `minute`, `second`, `millisecond`, `microsecond` dan `offset`.

DateTimeOffset(DateTime)

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Sumber:: DateTimeOffset.cs

Menginisialisasi instans baru struktur DateTimeOffset menggunakan nilai DateTime yang ditentukan.

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 lama dari DateTimeOffset.MinValue.

-atau-

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

Contoh

Contoh berikut menggambarkan bagaimana nilai properti DateTime.Kind parameter dateTime 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 properti DateTime.Kind parameter dateTime:

Jika nilai DateTime.Kind DateTimeKind.Utc, properti DateTime instans baru diatur sama dengan dateTime, dan properti Offset diatur sama dengan Zero.
Jika nilai DateTime.Kind DateTimeKind.Local atau DateTimeKind.Unspecified, properti DateTime instans baru diatur sama dengan dateTime, dan properti Offset 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 baru struktur DateTimeOffset menggunakan nilai dan offset DateTime yang ditentukan.

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.Kind sama dengan Utc dan offset tidak sama dengan nol.

-atau-

dateTime.Kind sama dengan Local dan offset tidak sama dengan offset zona waktu lokal sistem.

-atau-

offset tidak ditentukan dalam satu menit penuh.

ArgumentOutOfRangeException

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

-atau-

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

Contoh

Contoh berikut menunjukkan cara menginisialisasi objek DateTimeOffset 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 properti Kind parameter dateTime:

Jika nilai Kind DateTimeKind.Utc, nilai parameter offset harus 0 atau ArgumentException dilemparkan.
Jika nilai Kind DateTimeKind.Local, nilai parameter offset harus sama dengan offset zona waktu lokal dari Waktu Universal Terkoordinasi (UTC) untuk tanggal tertentu atau ArgumentException dilemparkan.
Jika nilai Kind DateTimeKind.Unspecified, parameter offset 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 baru struktur DateTimeOffset 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 12:00:00 tengah malam pada 1 Januari 0001.

offset: TimeSpan

Offset waktu dari Waktu Universal Terkoordinasi (UTC).

Pengecualian

ArgumentException

offset tidak ditentukan dalam satu menit penuh.

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 kurang dari -14 jam atau lebih besar dari 14 jam.

Contoh

Contoh berikut menginisialisasi objek DateTimeOffset dengan menggunakan jumlah kutu dalam tanggal arbitrer (dalam hal ini, 16 Juli 2007, pukul 13.32 WIB) 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 konstruktor DateTimeOffset untuk membuat instans nilai DateTimeOffset dengan waktu lokal dan offset selain zona waktu lokal melemparkan ArgumentException. Anda dapat menggunakan kelebihan konstruktor DateTimeOffset ini untuk mengatasi batasan ini. Contoh berikut menggunakan jumlah tanda centang waktu lokal untuk membuat instans nilai DateTimeOffset yang offsetnya tidak selalu mewakili waktu lokal:

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 baru struktur DateTimeOffset menggunakan dateyang ditentukan, time, dan offset.

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 baru struktur DateTimeOffset 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 besar dari 14 jam.

-atau-

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

Contoh

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

   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, month, dan day sebagai tahun, bulan, dan hari dalam kalender Gregorian. Untuk membuat instans nilai DateTimeOffset dengan menggunakan tahun, bulan, dan hari di kalender lain, panggil konstruktor DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan).

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 baru struktur DateTimeOffset 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 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).

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-

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 lebih baru dari DateTimeOffset.MaxValue.

Contoh

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

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

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 baru struktur DateTimeOffset 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 hingga 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 Waktu Universal Terkoordinasi (UTC).

Pengecualian

ArgumentException

offset tidak mewakili seluruh menit.

ArgumentNullException

calendar tidak dapat null.

ArgumentOutOfRangeException

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

-atau-

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

-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 besar dari 14 jam.

-atau-

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

-atau-

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

Contoh

Contoh berikut menggunakan instans kelas HebrewCalendar dan kelas HijriCalendar untuk membuat instans nilai DateTimeOffset. 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, month, day, hour, minute, second, dan millisecond semuanya mencerminkan nilai yang dinyatakan dalam kalender yang ditentukan oleh parameter calendar. 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 oleh karena itu diharapkan untuk berubah. Misalnya, 1 Mei 2019 menandai awal era Reiwa di JapaneseCalendar dan JapaneseLunisolarCalendar. Perubahan era seperti itu memengaruhi 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 kesiapan mereka 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 baru struktur DateTimeOffset menggunakan year, month, day, hour, minute, second, millisecond, microsecond dan offset.

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

Microseconds (0 hingga 999).

offset: TimeSpan

Offset waktu dari Waktu Universal Terkoordinasi (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 nilai DateTimeOffset dengan menggunakan tahun, bulan, dan hari di kalender lain, panggil konstruktor DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan).

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 year, month, day, hour, minute, second, millisecond, microsecond dan 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);

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

Microseconds (0 hingga 999).

calendar: Calendar

Kalender yang digunakan untuk menginterpretasikan year, month, dan 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 besar dari 14 jam.

-atau-

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

-atau-

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

Keterangan

Berlaku untuk

Bagikan melalui

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

Sumber Daya Tambahan: