Bagikan melalui

DateTimeOffset.Subtract Metode

  • Referensi

Definisi

Ruang nama:
System
Rakitan:
System.Runtime.dll
Rakitan:
mscorlib.dll
Rakitan:
netstandard.dll

Mengurangi waktu atau durasi tertentu dari objek saat ini DateTimeOffset .

Overload

Subtract(DateTimeOffset)

Mengurangi DateTimeOffset nilai yang mewakili tanggal dan waktu tertentu dari objek saat ini DateTimeOffset .
Subtract(TimeSpan)

Mengurangi interval waktu yang ditentukan dari objek saat ini DateTimeOffset .

Subtract(DateTimeOffset)

Sumber:
DateTimeOffset.cs
Sumber:
DateTimeOffset.cs
Sumber:
DateTimeOffset.cs

Mengurangi DateTimeOffset nilai yang mewakili tanggal dan waktu tertentu dari objek saat ini DateTimeOffset .

public:
 TimeSpan Subtract(DateTimeOffset value);
public TimeSpan Subtract (DateTimeOffset value);
member this.Subtract : DateTimeOffset -> TimeSpan
Public Function Subtract (value As DateTimeOffset) As TimeSpan

Parameter

value
DateTimeOffset

Objek yang mewakili nilai untuk dikurangi.

Mengembalikan

TimeSpan

Objek yang menentukan interval antara dua DateTimeOffset objek.

Contoh

Contoh berikut mengilustrasikan pengurangan Subtract(DateTimeOffset) yang menggunakan metode .

DateTimeOffset firstDate = new DateTimeOffset(2018, 10, 25, 18, 0, 0,
                                              new TimeSpan(-7, 0, 0));
DateTimeOffset secondDate = new DateTimeOffset(2018, 10, 25, 18, 0, 0,
                                               new TimeSpan(-5, 0, 0));
DateTimeOffset thirdDate = new DateTimeOffset(2018, 9, 28, 9, 0, 0,
                                              new TimeSpan(-7, 0, 0));
TimeSpan difference;

difference = firstDate.Subtract(secondDate);
Console.WriteLine($"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}");

difference = firstDate.Subtract(thirdDate);
Console.WriteLine($"({firstDate}) - ({thirdDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}");

// The example produces the following output:
//    (10/25/2018 6:00:00 PM -07:00) - (10/25/2018 6:00:00 PM -05:00): 0 days, 2:00
//    (10/25/2018 6:00:00 PM -07:00) - (9/28/2018 9:00:00 AM -07:00): 27 days, 9:00

let firstDate = DateTimeOffset(2018, 10, 25, 18, 0, 0, TimeSpan(-7, 0, 0))
let secondDate = DateTimeOffset(2018, 10, 25, 18, 0, 0, TimeSpan(-5, 0, 0))
let thirdDate = DateTimeOffset(2018, 9, 28, 9, 0, 0, TimeSpan(-7, 0, 0))

let difference = firstDate.Subtract secondDate
printfn $"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}"

let difference = firstDate.Subtract thirdDate
printfn $"({firstDate}) - ({thirdDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}"

// The example produces the following output:
//    (10/25/2018 6:00:00 PM -07:00) - (10/25/2018 6:00:00 PM -05:00): 0 days, 2:00
//    (10/25/2018 6:00:00 PM -07:00) - (9/28/2018 9:00:00 AM -07:00): 27 days, 9:00

Dim firstDate As New DateTimeOffset(#10/25/2018 6:00PM#, _
                                    New TimeSpan(-7, 0, 0))
Dim secondDate As New DateTimeOffset(#10/25/2018 6:00PM#, _
                                     New TimeSpan(-5, 0, 0))
Dim thirdDate As New DateTimeOffset(#9/28/2018 9:00AM#, _
                                    New TimeSpan(-7, 0, 0))
Dim difference As TimeSpan

difference = firstDate.Subtract(secondDate)
Console.WriteLine($"({firstDate}) - ({secondDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}")

difference = firstDate.Subtract(thirdDate)
Console.WriteLine($"({firstDate}) - ({thirdDate}): {difference.Days} days, {difference.Hours}:{difference.Minutes:d2}")

' The example produces the following output:
'    (10/25/2018 6:00:00 PM -07:00) - (10/25/2018 6:00:00 PM -05:00): 0 days, 2:00
'    (10/25/2018 6:00:00 PM -07:00) - (9/28/2018 9:00:00 AM -07:00): 27 days, 9:00

Keterangan

Metode ini mengonversi kedua DateTimeOffset objek menjadi Waktu Universal Terkoordinasi (UTC) sebelum menghitung interval waktu yang memisahkannya. Ini menghapus efek apa pun yang mungkin dimiliki offset yang berbeda dari UTC pada perbandingan.

Catatan

Untuk bahasa yang mendukung operator kustom, Anda juga dapat melakukan pengurangan tanggal dan waktu dengan menggunakan operator pengurangan. Untuk detailnya, lihat Subtraction metode .

Karena objek saat ini DateTimeOffset maupun value parameter tidak mewakili tanggal dan waktu dalam zona waktu tertentu, Subtract(DateTimeOffset) metode ini tidak mempertimbangkan aturan penyesuaian zona waktu tertentu ketika mengurangi tanggal dan waktu.

Lihat juga

Berlaku untuk

Subtract(TimeSpan)

Sumber:
DateTimeOffset.cs
Sumber:
DateTimeOffset.cs
Sumber:
DateTimeOffset.cs

Mengurangi interval waktu yang ditentukan dari objek saat ini DateTimeOffset .

public:
 DateTimeOffset Subtract(TimeSpan value);
public DateTimeOffset Subtract (TimeSpan value);
member this.Subtract : TimeSpan -> DateTimeOffset
Public Function Subtract (value As TimeSpan) As DateTimeOffset

Parameter

value
TimeSpan

Interval waktu untuk mengurangi.

Mengembalikan

DateTimeOffset

Objek yang sama dengan tanggal dan waktu yang diwakili oleh objek saat ini DateTimeOffset , dikurangi interval waktu yang diwakili oleh value.

Pengecualian

ArgumentOutOfRangeException

Nilai yang DateTimeOffset dihasilkan kurang dari DateTimeOffset.MinValue.

-atau-

Nilai yang DateTimeOffset dihasilkan lebih besar dari DateTimeOffset.MaxValue.

Contoh

Contoh berikut mengilustrasikan pengurangan Subtract yang menggunakan metode .

DateTimeOffset offsetDate = new DateTimeOffset(2007, 12, 3, 11, 30, 0,
                               new TimeSpan(-8, 0, 0));
TimeSpan duration = new TimeSpan(7, 18, 0, 0);
Console.WriteLine(offsetDate.Subtract(duration).ToString());  // Displays 11/25/2007 5:30:00 PM -08:00

let offsetDate = DateTimeOffset(2007, 12, 3, 11, 30, 0, TimeSpan(-8, 0, 0))
let duration = TimeSpan(7, 18, 0, 0)
printfn $"{offsetDate.Subtract duration}"  // Displays 11/25/2007 5:30:00 PM -08:00

Dim offsetDate As New DateTimeOffset(#12/3/2007 11:30AM#, _
                               New TimeSpan(-8, 0, 0)) 
Dim duration As New TimeSpan(7, 18, 0, 0)
Console.WriteLine(offsetDate.Subtract(duration))    ' Displays 11/25/2007 5:30:00 PM -08:00

Keterangan

Anda dapat menggunakan Subtract metode untuk mengurangi lebih dari satu jenis interval waktu (hari, jam, menit, detik, atau milidetik) dalam satu operasi. Perilakunya identik Subtraction(DateTimeOffset, TimeSpan) dengan metode , yang mendefinisikan operator pengurangan. Struktur ini DateTimeOffset juga mendukung metode penambahan khusus (seperti AddDays, , AddHoursdan AddMinutes) yang memungkinkan Anda melakukan pengurangan dengan menetapkan nilai negatif ke parameter metode.

Catatan

Metode ini mengembalikan objek baru DateTimeOffset . Ini tidak mengubah nilai objek saat ini dengan mengurangi value dari tanggal dan waktunya.

Metode Subtract ini tidak memengaruhi nilai DateTimeOffset properti objek Offset . Objek yang dikembalikan DateTimeOffset memiliki offset yang sama dengan objek asli.

Karena objek saat ini DateTimeOffset tidak mewakili tanggal dan waktu dalam zona waktu tertentu, Subtract(TimeSpan) metode tidak mempertimbangkan aturan penyesuaian zona waktu tertentu ketika melakukan pengurangan.

Lihat juga

Berlaku untuk