DateTime.CompareTo Metódus

Definíció

Névtér:: System

Szerelvények:: mscorlib.dll, System.Runtime.dll

Szerelvények:: netstandard.dll, System.Runtime.dll

Szerelvény:: System.Runtime.dll

Szerelvény:: mscorlib.dll

Szerelvény:: netstandard.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Összehasonlítja a példány értékét egy megadott DateTime értékkel, és jelzi, hogy ez a példány korábbi-e, mint a megadott érték, megegyezik-e a megadott DateTime értékkel.

Túlterhelések

Name	Description
CompareTo(DateTime)	Összehasonlítja a példány értékét egy megadott DateTime értékkel, és egy egész számot ad vissza, amely jelzi, hogy ez a példány a megadott DateTime értéknél korábbi, azonos vagy későbbi-e.
CompareTo(Object)	Összehasonlítja a példány értékét egy megadott DateTime értéket tartalmazó objektummal, és egy egész számot ad vissza, amely jelzi, hogy ez a példány a megadott DateTime értéknél korábbi, azonos vagy későbbi-e.

Megjegyzések

A metódus két túlterhelése CompareTo egy aláírt számot ad vissza, amely a példány és az value argumentum relatív értékét jelzi az alábbi táblázatban látható módon.

Érték	Leírás
Nullánál kisebb	Ez a példány korábbi, mint `value`.
Nulla	Ez a példány ugyanaz, mint `value`a .
Nullánál nagyobb	Ez a példány későbbi, mint `value`.

CompareTo(DateTime)

Forrás:: DateTime.cs

Forrás:: DateTime.cs

Forrás:: DateTime.cs

Forrás:: DateTime.cs

Forrás:: DateTime.cs

Összehasonlítja a példány értékét egy megadott DateTime értékkel, és egy egész számot ad vissza, amely jelzi, hogy ez a példány a megadott DateTime értéknél korábbi, azonos vagy későbbi-e.

public:
 virtual int CompareTo(DateTime value);

public int CompareTo(DateTime value);

abstract member CompareTo : DateTime -> int
override this.CompareTo : DateTime -> int

Public Function CompareTo (value As DateTime) As Integer

Paraméterek

value: DateTime

Az aktuális példányhoz hasonlítandó objektum.

Válaszok

Int32

Aláírt szám, amely a példány és a paraméter relatív értékeit value jelzi.

Érték	Leírás
Nullánál kisebb	Ez a példány korábbi, mint `value`.
Nulla	Ez a példány ugyanaz, mint `value`a .
Nullánál nagyobb	Ez a példány későbbi, mint `value`.

Megvalósítás

CompareTo(T)

Példák

Az alábbi példa három DateTime objektumot hoz létre, az egyik a mai dátumot jelöli, a másik az egy évvel korábbi dátumot, a harmadik pedig az egy évvel korábbi dátumot. Ezután meghívja a metódust CompareTo(DateTime) , és megjeleníti az összehasonlítás eredményét.

open System

type DateComparisonResult =
    | Earlier = -1
    | Later = 1
    | TheSame = 0

[<EntryPoint>]
let main _ =
    let thisDate = DateTime.Today

    // Define two DateTime objects for today's date next year and last year		
    // Call AddYears instance method to add/substract 1 year
    let thisDateNextYear = thisDate.AddYears 1
    let thisDateLastYear = thisDate.AddYears -1

    // Compare today to last year
    let comparison = thisDate.CompareTo thisDateLastYear |> enum<DateComparisonResult>
    printfn $"CompareTo method returns {int comparison}: {thisDate:d} is {comparison.ToString().ToLower()} than {thisDateLastYear:d}"

    // Compare today to next year
    let comparison = thisDate.CompareTo thisDateNextYear |> enum<DateComparisonResult>
    printfn $"CompareTo method returns {int comparison}: {thisDate:d} is {comparison.ToString().ToLower()} than {thisDateNextYear:d}"
                        
    0

// If run on December 31, 2021, the example produces the following output:
//    CompareTo method returns 1: 12/31/2021 is later than 12/31/2020
//    CompareTo method returns -1: 12/31/2021 is earlier than 12/31/2022

using System;

public class DateTimeComparison
{
   private enum DateComparisonResult
   {
      Earlier = -1,
      Later = 1,
      TheSame = 0
   };

   public static void Main()
   {
      DateTime thisDate = DateTime.Today;

      // Define two DateTime objects for today's date
      // next year and last year		
      DateTime thisDateNextYear, thisDateLastYear;

      // Call AddYears instance method to add/substract 1 year
      thisDateNextYear = thisDate.AddYears(1);
      thisDateLastYear = thisDate.AddYears(-1);

      // Compare dates
      //
      DateComparisonResult comparison;
      // Compare today to last year
      comparison = (DateComparisonResult) thisDate.CompareTo(thisDateLastYear);
      Console.WriteLine("CompareTo method returns {0}: {1:d} is {2} than {3:d}",
                        (int) comparison, thisDate, comparison.ToString().ToLower(),
                        thisDateLastYear);

      // Compare today to next year
      comparison = (DateComparisonResult) thisDate.CompareTo(thisDateNextYear);
      Console.WriteLine("CompareTo method returns {0}: {1:d} is {2} than {3:d}",
                        (int) comparison, thisDate, comparison.ToString().ToLower(),
                        thisDateNextYear);
   }
}
//
// If run on October 20, 2006, the example produces the following output:
//    CompareTo method returns 1: 10/20/2006 is later than 10/20/2005
//    CompareTo method returns -1: 10/20/2006 is earlier than 10/20/2007

Option Strict On

Module DateTimeComparison
   Private Enum DateComparisonResult
      Earlier = -1
      Later = 1
      TheSame = 0
   End Enum
   
   Public Sub Main()

      Dim thisDate As Date = Date.Today

      ' Define two DateTime objects for today's date 
      ' next year and last year		
      Dim thisDateNextYear, thisDateLastYear As Date

      ' Call AddYears instance method to add/substract 1 year
      thisDateNextYear = thisDate.AddYears(1)
      thisDateLastYear = thisDate.AddYears(-1)   

       
      ' Compare dates
      '
      Dim comparison As DateComparisonResult
      ' Compare today to last year
      comparison = CType(thisDate.CompareTo(thisDateLastYear), DateComparisonResult)
      Console.WriteLine("CompareTo method returns {0}: {1:d} is {2} than {3:d}", _ 
                        CInt(comparison), thisDate, comparison.ToString().ToLower(), _ 
                        thisDateLastYear)
      
      ' Compare today to next year
      comparison = CType(thisDate.CompareTo(thisDateNextYear), DateComparisonResult)
      Console.WriteLine("CompareTo method returns {0}: {1:d} is {2} than {3:d}", _
                        CInt(comparison), thisDate, comparison.ToString().ToLower(), _
                        thisDateNextYear)
   End Sub
End Module
'
' If run on October 20, 2006, the example produces the following output:
'    CompareTo method returns 1: 10/20/2006 is later than 10/20/2005
'    CompareTo method returns -1: 10/20/2006 is earlier than 10/20/2007

Megjegyzések

Az aktuális példány és a jelenlegi példány közötti kapcsolat meghatározásához valuea CompareTo metódus összehasonlítja az Ticks aktuális példány tulajdonságát, de value figyelmen kívül hagyja a tulajdonságukat Kind . Az objektumok összehasonlítása DateTime előtt győződjön meg arról, hogy az objektumok ugyanabban az időzónában lévő időpontokat jelölik. Ezt a tulajdonságok értékeinek Kind összehasonlításával teheti meg.

Ez a metódus implementálja az System.IComparable<T> interfészt, és valamivel jobban teljesít, mint a DateTime.CompareTo(Object) metódus túlterhelése, mivel nem kell átalakítania a value paramétert objektummá.

Lásd még

A következőre érvényes:

CompareTo(Object)

Forrás:: DateTime.cs

Forrás:: DateTime.cs

Forrás:: DateTime.cs

Forrás:: DateTime.cs

Forrás:: DateTime.cs

Összehasonlítja a példány értékét egy megadott DateTime értéket tartalmazó objektummal, és egy egész számot ad vissza, amely jelzi, hogy ez a példány a megadott DateTime értéknél korábbi, azonos vagy későbbi-e.

public:
 virtual int CompareTo(System::Object ^ value);

public:
 int CompareTo(System::Object ^ value);

public int CompareTo(object? value);

public int CompareTo(object value);

abstract member CompareTo : obj -> int
override this.CompareTo : obj -> int

member this.CompareTo : obj -> int

Public Function CompareTo (value As Object) As Integer

Paraméterek

value: Object

Egy összehasonlítandó dobozos objektum, vagy null.

Válaszok

Int32

A példány és a példány valuerelatív értékeit jelző aláírt szám.

Érték	Leírás
Nullánál kisebb	Ez a példány korábbi, mint `value`.
Nulla	Ez a példány ugyanaz, mint `value`a .
Nullánál nagyobb	Ez a példány későbbi, mint `value`az .`valuenull`

Megvalósítás

CompareTo(Object)

Kivételek

ArgumentException

value nem egy DateTime.

Példák

Az alábbi példa a metódust CompareTo mutatja be.

open System

let theDay = DateTime(DateTime.Today.Year, 7, 28)

try
    let compareValue = theDay.CompareTo DateTime.Today

    if compareValue < 0 then
        printfn $"{theDay:d} is in the past."
    elif compareValue = 0 then
        printfn $"{theDay:d} is today!"
    else // compareValue > 0
        printfn $"{theDay:d} has not come yet."
        
with :? ArgumentException ->
    Console.WriteLine("Value is not a DateTime");

System.DateTime theDay = new System.DateTime(System.DateTime.Today.Year, 7, 28);
int compareValue;

try
{
    compareValue = theDay.CompareTo(DateTime.Today);
}
catch (ArgumentException)
{
   Console.WriteLine("Value is not a DateTime");
   return;
}

if (compareValue < 0)
   System.Console.WriteLine("{0:d} is in the past.", theDay);
else if (compareValue == 0)
   System.Console.WriteLine("{0:d} is today!", theDay);
else // compareValue > 0
   System.Console.WriteLine("{0:d} has not come yet.", theDay);

Dim thDay As New System.DateTime(System.DateTime.Today.Year, 7, 28)

Dim compareValue As Integer
Try
   compareValue = thDay.CompareTo(System.DateTime.Today)
Catch exp As ArgumentException
   System.Console.WriteLine("Value is not a DateTime")
End Try

If compareValue < 0 Then
   System.Console.WriteLine("{0:d} is in the past.", thDay)
ElseIf compareValue = 0 Then
   System.Console.WriteLine("{0:d} is today!", thDay)
Else   ' compareValue >= 1 
   System.Console.WriteLine("{0:d} has not come yet.", thDay)
End If

Megjegyzések

Az DateTime példány, értékétől függetlenül, nagyobbnak tekinthető, mint null.

Lásd még

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?