DateTimeOffset Konstruktor
Definisi
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 , , |
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 , , , |
DateTimeOffset(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, TimeSpan) |
Menginisialisasi instans baru struktur DateTimeOffset menggunakan , , , |
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
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.DateTimeDateTimeKind.UtcDateTime.KindJika 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
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
dateTime.Kind
Utc sama dengan dan offset
tidak sama dengan nol.
-atau-
dateTime.Kind
Local sama dengan dan offset
tidak sama dengan offset zona waktu lokal sistem.
-atau-
offset
tidak ditentukan dalam seluruh menit.
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 ArgumentExceptionDateTimeKind.Utc.Jika nilai Kind adalah , nilai
offset
parameter harus sama dengan offset zona waktu lokal dari Waktu Universal Terkoordinasi (UTC) untuk tanggal tertentu atau ArgumentExceptionDateTimeKind.Localdilemparkan.Jika nilai Kind adalah DateTimeKind.Unspecified,
offset
parameter dapat memiliki nilai yang valid.
Lihat juga
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
offset
tidak ditentukan dalam seluruh menit.
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
Berlaku untuk
DateTimeOffset(DateOnly, TimeOnly, TimeSpan)
- Sumber:
- DateTimeOffset.cs
- Sumber:
- DateTimeOffset.cs
Menginisialisasi instans DateTimeOffset baru struktur menggunakan , , time
dan offset
yang 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
offset
tidak mewakili seluruh menit.
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
, , 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, Calendar, TimeSpan) konstruktor.
Lihat juga
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
offset
tidak mewakili seluruh menit.
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
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
offset
tidak mewakili seluruh menit.
calendar
tidak bisa menjadi null
.
year
kurang dari calendar
parameter MinSupportedDateTime.Year
atau lebih besar dari MaxSupportedDateTime.Year
.
-atau-
month
kurang dari atau lebih besar dari jumlah bulan dalam year
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 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
, , day
month
hour
, 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
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
, minute
hour
, , second
, millisecond
, microsecond
dan offset
yang 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
offset
tidak mewakili seluruh menit.
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 , , , day
month
, minute
hour
, , second
, millisecond
, microsecond
dan offset
yang 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
, , month
dan day
.
- offset
- TimeSpan
Offset waktu dari Waktu Universal Terkoordinasi (UTC).
Pengecualian
offset
tidak mewakili seluruh menit.
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
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk