Condividi tramite

Come usare le strutture DateOnly e TimeOnly

  • Articolo

Le strutture DateOnly e TimeOnly sono state introdotte con .NET 6 e rappresentano rispettivamente una data o un'ora specifiche. Prima di .NET 6 e sempre in .NET Framework, gli sviluppatori usavano il tipo di DateTime (o un'altra alternativa) per rappresentare una delle opzioni seguenti:

  • Una data e un'ora complete.
  • Una data senza considerare l'ora.
  • Un orario, trascurando la data.

DateOnly e TimeOnly sono tipi che rappresentano le parti specifiche di un tipo di DateTime.

Importante

i tipi DateOnly e TimeOnly non sono disponibili per .NET Framework.

Struttura DateOnly

La struttura DateOnly rappresenta una data specifica, senza ora. Poiché non include alcuna componente temporale, rappresenta una data dall'inizio alla fine del giorno. Questa struttura è ideale per archiviare date specifiche, ad esempio una data di nascita, una data di anniversario o date correlate all'azienda.

Anche se è possibile usare DateTime ignorando il componente temporale, esistono alcuni vantaggi per l'uso di DateOnly in DateTime:

  • La struttura DateTime può essere spostata nel giorno precedente o successivo se è influenzata da un fuso orario. DateOnly non può essere compensato da un fuso orario e rappresenta sempre la data impostata.

  • La serializzazione di una struttura DateTime include il componente temporale, che può nascondere l'intento dei dati. Inoltre, DateOnly serializza meno dati.

  • Quando il codice interagisce con un database, ad esempio SQL Server, le date intere vengono in genere archiviate come tipo di dati date, che non include un'ora. DateOnly si adatta meglio al tipo di database.

DateOnly ha un intervallo compreso tra 0001-01-01 e 9999-12-31, proprio come DateTime. È possibile specificare un calendario specifico nel costruttore DateOnly. Tuttavia, un oggetto DateOnly rappresenta sempre una data nel calendario gregoriano proleptico, indipendentemente dal calendario utilizzato per costruirlo. Ad esempio, è possibile compilare la data da un calendario ebraico, ma la data viene convertita in gregoriano:

var hebrewCalendar = new System.Globalization.HebrewCalendar();
var theDate = new DateOnly(5776, 2, 8, hebrewCalendar); // 8 Cheshvan 5776

Console.WriteLine(theDate);

/* This example produces the following output:
 *
 * 10/21/2015
*/

Dim hebrewCalendar = New System.Globalization.HebrewCalendar()
Dim theDate = New DateOnly(5776, 2, 8, hebrewCalendar) ' 8 Cheshvan 5776

Console.WriteLine(theDate)

' This example produces the following output
'
' 10/21/2015

Esempi di DateOnly

Usa i seguenti esempi per conoscere DateOnly:

Convertire DateTime in DateOnly

Usare il metodo statico DateOnly.FromDateTime per creare un tipo DateOnly da un tipo DateTime, come illustrato nel codice seguente:

var today = DateOnly.FromDateTime(DateTime.Now);
Console.WriteLine($"Today is {today}");

/* This example produces output similar to the following:
 * 
 * Today is 12/28/2022
*/

Dim today = DateOnly.FromDateTime(DateTime.Now)
Console.WriteLine($"Today is {today}")

' This example produces output similar to the following
' 
' Today is 12/28/2022

Aggiungere o sottrarre giorni, mesi, anni

Esistono tre metodi usati per regolare una struttura di DateOnly: AddDays, AddMonthse AddYears. Ogni metodo accetta un parametro integer e aumenta la data in base a tale misurazione. Se viene specificato un numero negativo, la data viene ridotta di tale misura. I metodi restituiscono una nuova istanza di DateOnly, perché la struttura non è modificabile.

var theDate = new DateOnly(2015, 10, 21);

var nextDay = theDate.AddDays(1);
var previousDay = theDate.AddDays(-1);
var decadeLater = theDate.AddYears(10);
var lastMonth = theDate.AddMonths(-1);

Console.WriteLine($"Date: {theDate}");
Console.WriteLine($" Next day: {nextDay}");
Console.WriteLine($" Previous day: {previousDay}");
Console.WriteLine($" Decade later: {decadeLater}");
Console.WriteLine($" Last month: {lastMonth}");

/* This example produces the following output:
 * 
 * Date: 10/21/2015
 *  Next day: 10/22/2015
 *  Previous day: 10/20/2015
 *  Decade later: 10/21/2025
 *  Last month: 9/21/2015
*/

Dim theDate = New DateOnly(2015, 10, 21)

Dim nextDay = theDate.AddDays(1)
Dim previousDay = theDate.AddDays(-1)
Dim decadeLater = theDate.AddYears(10)
Dim lastMonth = theDate.AddMonths(-1)

Console.WriteLine($"Date: {theDate}")
Console.WriteLine($" Next day: {nextDay}")
Console.WriteLine($" Previous day: {previousDay}")
Console.WriteLine($" Decade later: {decadeLater}")
Console.WriteLine($" Last month: {lastMonth}")

' This example produces the following output
' 
' Date: 10/21/2015
'  Next day: 10/22/2015
'  Previous day: 10/20/2015
'  Decade later: 10/21/2025
'  Last month: 9/21/2015

Analizzare e formattare DateOnly

DateOnly può essere analizzato da una stringa, proprio come la struttura DateTime. Tutti i token di analisi standard basati su data .NET funzionano con DateOnly. Quando si converte un tipo di DateOnly in una stringa, è possibile usare anche modelli di formattazione standard basati su data .NET. Per ulteriori informazioni sulla formattazione delle stringhe, vedere le stringhe di formato standard di data e ora .

var theDate = DateOnly.ParseExact("21 Oct 2015", "dd MMM yyyy", CultureInfo.InvariantCulture);  // Custom format
var theDate2 = DateOnly.Parse("October 21, 2015", CultureInfo.InvariantCulture);

Console.WriteLine(theDate.ToString("m", CultureInfo.InvariantCulture));     // Month day pattern
Console.WriteLine(theDate2.ToString("o", CultureInfo.InvariantCulture));    // ISO 8601 format
Console.WriteLine(theDate2.ToLongDateString());

/* This example produces the following output:
 * 
 * October 21
 * 2015-10-21
 * Wednesday, October 21, 2015
*/

Dim theDate = DateOnly.ParseExact("21 Oct 2015", "dd MMM yyyy", CultureInfo.InvariantCulture) ' Custom format
Dim theDate2 = DateOnly.Parse("October 21, 2015", CultureInfo.InvariantCulture)

Console.WriteLine(theDate.ToString("m", CultureInfo.InvariantCulture))     ' Month day pattern
Console.WriteLine(theDate2.ToString("o", CultureInfo.InvariantCulture))    ' ISO 8601 format
Console.WriteLine(theDate2.ToLongDateString())

' This example produces the following output
' 
' October 21
' 2015-10-21
' Wednesday, October 21, 2015

Confrontare DateOnly

DateOnly può essere confrontato con altre istanze. Ad esempio, è possibile verificare se una data è precedente o successiva o se una data odierna corrisponde a una data specifica.

var theDate = DateOnly.ParseExact("21 Oct 2015", "dd MMM yyyy", CultureInfo.InvariantCulture);  // Custom format
var theDate2 = DateOnly.Parse("October 21, 2015", CultureInfo.InvariantCulture);
var dateLater = theDate.AddMonths(6);
var dateBefore = theDate.AddDays(-10);

Console.WriteLine($"Consider {theDate}...");
Console.WriteLine($" Is '{nameof(theDate2)}' equal? {theDate == theDate2}");
Console.WriteLine($" Is {dateLater} after? {dateLater > theDate} ");
Console.WriteLine($" Is {dateLater} before? {dateLater < theDate} ");
Console.WriteLine($" Is {dateBefore} after? {dateBefore > theDate} ");
Console.WriteLine($" Is {dateBefore} before? {dateBefore < theDate} ");

/* This example produces the following output:
 * 
 * Consider 10/21/2015
 *  Is 'theDate2' equal? True
 *  Is 4/21/2016 after? True
 *  Is 4/21/2016 before? False
 *  Is 10/11/2015 after? False
 *  Is 10/11/2015 before? True
*/

Dim theDate = DateOnly.ParseExact("21 Oct 2015", "dd MMM yyyy", CultureInfo.InvariantCulture) ' Custom format
Dim theDate2 = DateOnly.Parse("October 21, 2015", CultureInfo.InvariantCulture)
Dim dateLater = theDate.AddMonths(6)
Dim dateBefore = theDate.AddDays(-10)

Console.WriteLine($"Consider {theDate}...")
Console.WriteLine($" Is '{NameOf(theDate2)}' equal? {theDate = theDate2}")
Console.WriteLine($" Is {dateLater} after? {dateLater > theDate} ")
Console.WriteLine($" Is {dateLater} before? {dateLater < theDate} ")
Console.WriteLine($" Is {dateBefore} after? {dateBefore > theDate} ")
Console.WriteLine($" Is {dateBefore} before? {dateBefore < theDate} ")

' This example produces the following output
' 
' Consider 10/21/2015
'  Is 'theDate2' equal? True
'  Is 4/21/2016 after? True
'  Is 4/21/2016 before? False
'  Is 10/11/2015 after? False
'  Is 10/11/2015 before? True

Struttura TimeOnly

La struttura TimeOnly rappresenta un valore di ora del giorno, ad esempio un orario di sveglia giornaliero o l'ora in cui si mangia il pranzo ogni giorno. TimeOnly è limitato all'intervallo di 00:00:00.00000000 - 23:59:59.99999999999, un'ora specifica del giorno.

Prima dell'introduzione del tipo di TimeOnly, i programmatori usano in genere il tipo DateTime o il tipo TimeSpan per rappresentare un orario specifico. Tuttavia, l'uso di queste strutture per simulare un tempo senza una data può introdurre alcuni problemi, che TimeOnly risolve.

  • TimeSpan rappresenta il tempo trascorso, ad esempio il tempo misurato con un cronometro. L'intervallo superiore è superiore a 29.000 anni e il relativo valore può essere negativo per indicare lo spostamento indietro nel tempo. Un TimeSpan negativo non indica un'ora specifica del giorno.

  • Se TimeSpan viene utilizzato come orario del giorno, esiste il rischio che possa essere modificato a un valore al di fuori del ciclo di 24 ore. TimeOnly non ha questo rischio. Ad esempio, se il turno di lavoro di un dipendente inizia alle 18:00 e dura 8 ore, aggiungendo 8 ore alla struttura TimeOnly equivale a 2:00.

  • L'uso di DateTime per un'ora del giorno richiede che una data arbitraria sia associata all'ora e quindi ignorata in seguito. È prassi comune scegliere DateTime.MinValue (0001-01-01-01) come data, tuttavia, se le ore vengono sottratte dal valore DateTime, potrebbe verificarsi un'eccezione OutOfRange. TimeOnly non presenta questo problema perché il tempo scorre avanti e indietro intorno all'intervallo di tempo di 24 ore.

  • La serializzazione di una struttura DateTime include il componente data, che potrebbe nascondere la finalità dei dati. Inoltre, TimeOnly serializza meno dati.

Esempi di TimeOnly

Usa i seguenti esempi per conoscere TimeOnly:

Convertire DateTime in TimeOnly

Usare il metodo statico TimeOnly.FromDateTime per creare un tipo TimeOnly da un tipo DateTime, come illustrato nel codice seguente:

var now = TimeOnly.FromDateTime(DateTime.Now);
Console.WriteLine($"It is {now} right now");

/* This example produces output similar to the following:
 * 
 * It is 2:01 PM right now
*/

Dim now = TimeOnly.FromDateTime(DateTime.Now)
Console.WriteLine($"It is {now} right now")

' This example produces output similar to the following
' 
' It is 2:01 PM right now

Aggiungere o sottrarre il tempo

Esistono tre metodi usati per regolare una struttura di TimeOnly: AddHours, AddMinutese Add. Sia AddHours che AddMinutes accettano un parametro integer e regolano di conseguenza il valore. È possibile usare un valore negativo per sottrarre e un valore positivo da aggiungere. I metodi restituiscono una nuova istanza di TimeOnly, perché la struttura non è modificabile. Il metodo Add accetta un parametro TimeSpan e aggiunge o sottrae il valore dal valore TimeOnly.

Poiché TimeOnly rappresenta solo un periodo di 24 ore, si aggiorna automaticamente in avanti o indietro in modo appropriato quando si aggiungono valori a questi tre metodi. Ad esempio, se si usa un valore di 01:30:00 per rappresentare l'1:30 AM, e si aggiungono -4 ore a quel periodo, torna indietro a 21:30:00, ovvero alle 21:30. Esistono overload del metodo per AddHours, AddMinutese Add che acquisiscono il numero di giorni di cui è stato eseguito il roll over.

var theTime = new TimeOnly(7, 23, 11);

var hourLater = theTime.AddHours(1);
var minutesBefore = theTime.AddMinutes(-12);
var secondsAfter = theTime.Add(TimeSpan.FromSeconds(10));
var daysLater = theTime.Add(new TimeSpan(hours: 21, minutes: 200, seconds: 83), out int wrappedDays);
var daysBehind = theTime.AddHours(-222, out int wrappedDaysFromHours);

Console.WriteLine($"Time: {theTime}");
Console.WriteLine($" Hours later: {hourLater}");
Console.WriteLine($" Minutes before: {minutesBefore}");
Console.WriteLine($" Seconds after: {secondsAfter}");
Console.WriteLine($" {daysLater} is the time, which is {wrappedDays} days later");
Console.WriteLine($" {daysBehind} is the time, which is {wrappedDaysFromHours} days prior");

/* This example produces the following output:
 * 
 * Time: 7:23 AM
 *  Hours later: 8:23 AM
 *  Minutes before: 7:11 AM
 *  Seconds after: 7:23 AM
 *  7:44 AM is the time, which is 1 days later 
 *  1:23 AM is the time, which is -9 days prior
*/

Dim wrappedDays As Integer
Dim wrappedDaysFromHours As Integer

Dim theTime = New TimeOnly(7, 23, 11)

Dim hourLater = theTime.AddHours(1)
Dim minutesBefore = theTime.AddMinutes(-12)
Dim secondsAfter = theTime.Add(TimeSpan.FromSeconds(10))
Dim daysLater = theTime.Add(New TimeSpan(hours:=21, minutes:=200, seconds:=83), wrappedDays)
Dim daysBehind = theTime.AddHours(-222, wrappedDaysFromHours)

Console.WriteLine($"Time: {theTime}")
Console.WriteLine($" Hours later: {hourLater}")
Console.WriteLine($" Minutes before: {minutesBefore}")
Console.WriteLine($" Seconds after: {secondsAfter}")
Console.WriteLine($" {daysLater} is the time, which is {wrappedDays} days later")
Console.WriteLine($" {daysBehind} is the time, which is {wrappedDaysFromHours} days prior")

' This example produces the following output
' 
' Time: 7:23 AM
'  Hours later: 8:23 AM
'  Minutes before: 7:11 AM
'  Seconds after: 7:23 AM
'  7:44 AM is the time, which is 1 days later 
'  1:23 AM is the time, which is -9 days prior

Analizzare e formattare TimeOnly

TimeOnly può essere analizzato da una stringa, proprio come la struttura DateTime. Tutti i token di analisi temporale standard di .NET funzionano con TimeOnly. Quando si converte un tipo di TimeOnly in una stringa, è possibile usare anche modelli di formattazione standard basati su data .NET. Per ulteriori informazioni sulla formattazione delle stringhe, vedere le stringhe di formato standard di data e ora .

var theTime = TimeOnly.ParseExact("5:00 pm", "h:mm tt", CultureInfo.InvariantCulture);  // Custom format
var theTime2 = TimeOnly.Parse("17:30:25", CultureInfo.InvariantCulture);

Console.WriteLine(theTime.ToString("o", CultureInfo.InvariantCulture));     // Round-trip pattern.
Console.WriteLine(theTime2.ToString("t", CultureInfo.InvariantCulture));    // Long time format
Console.WriteLine(theTime2.ToLongTimeString());

/* This example produces the following output:
 * 
 * 17:00:00.0000000
 * 17:30
 * 5:30:25 PM
*/

Dim theTime = TimeOnly.ParseExact("5:00 pm", "h:mm tt", CultureInfo.InvariantCulture) ' Custom format
Dim theTime2 = TimeOnly.Parse("17:30:25", CultureInfo.InvariantCulture)

Console.WriteLine(theTime.ToString("o", CultureInfo.InvariantCulture))     ' Round-trip pattern.
Console.WriteLine(theTime2.ToString("t", CultureInfo.InvariantCulture))    ' Long time format
Console.WriteLine(theTime2.ToLongTimeString())

' This example produces the following output
' 
' 17:00:00.0000000
' 17:30
' 5:30:25 PM

Serializzare i tipi DateOnly e TimeOnly

Con .NET 7+, System.Text.Json supporta la serializzazione e la deserializzazione dei tipi di DateOnly e TimeOnly. Si consideri l'oggetto seguente:

sealed file record Appointment(
    Guid Id,
    string Description,
    DateOnly Date,
    TimeOnly StartTime,
    TimeOnly EndTime);

Public NotInheritable Class Appointment
    Public Property Id As Guid
    Public Property Description As String
    Public Property DateValue As DateOnly?
    Public Property StartTime As TimeOnly?
    Public Property EndTime As TimeOnly?
End Class

L'esempio seguente serializza un oggetto Appointment, visualizza il codice JSON risultante e quindi lo deserializza nuovamente in una nuova istanza del tipo di Appointment. Infine, le istanze originali e appena deserializzate vengono confrontate per verificarne l'uguaglianza e i risultati vengono scritti nella console:

Appointment originalAppointment = new(
    Id: Guid.NewGuid(),
    Description: "Take dog to veterinarian.",
    Date: new DateOnly(2002, 1, 13),
    StartTime: new TimeOnly(5,15),
    EndTime: new TimeOnly(5, 45));
string serialized = JsonSerializer.Serialize(originalAppointment);

Console.WriteLine($"Resulting JSON: {serialized}");

Appointment deserializedAppointment =
    JsonSerializer.Deserialize<Appointment>(serialized)!;

bool valuesAreTheSame = originalAppointment == deserializedAppointment;
Console.WriteLine($"""
    Original record has the same values as the deserialized record: {valuesAreTheSame}
    """);

        Dim originalAppointment As New Appointment With {
            .Id = Guid.NewGuid(),
            .Description = "Take dog to veterinarian.",
            .DateValue = New DateOnly(2002, 1, 13),
            .StartTime = New TimeOnly(5, 3, 1),
            .EndTime = New TimeOnly(5, 3, 1)
}
        Dim serialized As String = JsonSerializer.Serialize(originalAppointment)

        Console.WriteLine($"Resulting JSON: {serialized}")

        Dim deserializedAppointment As Appointment =
            JsonSerializer.Deserialize(Of Appointment)(serialized)

        Dim valuesAreTheSame As Boolean =
            (originalAppointment.DateValue = deserializedAppointment.DateValue AndAlso
            originalAppointment.StartTime = deserializedAppointment.StartTime AndAlso
            originalAppointment.EndTime = deserializedAppointment.EndTime AndAlso
            originalAppointment.Id = deserializedAppointment.Id AndAlso
            originalAppointment.Description = deserializedAppointment.Description)

        Console.WriteLine(
            $"Original object has the same values as the deserialized object: {valuesAreTheSame}")

Nel codice precedente:

  • Viene creata un'istanza di un oggetto Appointment e assegnata alla variabile appointment.
  • L'istanza di appointment viene serializzata in JSON usando JsonSerializer.Serialize.
  • Il codice JSON risultante viene scritto nella console.
  • Il codice JSON viene deserializzato in una nuova istanza del tipo Appointment usando JsonSerializer.Deserialize.
  • Le istanze originali e appena deserializzate vengono confrontate per verificarne l'uguaglianza.
  • Il risultato del confronto viene scritto nella console.

Per altre informazioni, vedere Come serializzare e deserializzare JSON in .NET.

Usare TimeSpan e DateTime

TimeOnly può essere creato da e convertito in un TimeSpan. Inoltre, TimeOnly può essere usato con un DateTime, per creare l'istanza di TimeOnly oppure per creare un'istanza di DateTime purché venga specificata una data.

L'esempio seguente crea un oggetto TimeOnly da un TimeSpane quindi lo converte di nuovo:

// TimeSpan must in the range of 00:00:00.0000000 to 23:59:59.9999999
var theTime = TimeOnly.FromTimeSpan(new TimeSpan(23, 59, 59));
var theTimeSpan = theTime.ToTimeSpan();

Console.WriteLine($"Variable '{nameof(theTime)}' is {theTime}");
Console.WriteLine($"Variable '{nameof(theTimeSpan)}' is {theTimeSpan}");

/* This example produces the following output:
 * 
 * Variable 'theTime' is 11:59 PM
 * Variable 'theTimeSpan' is 23:59:59
*/

' TimeSpan must in the range of 00:00:00.0000000 to 23:59:59.9999999
Dim theTime = TimeOnly.FromTimeSpan(New TimeSpan(23, 59, 59))
Dim theTimeSpan = theTime.ToTimeSpan()

Console.WriteLine($"Variable '{NameOf(theTime)}' is {theTime}")
Console.WriteLine($"Variable '{NameOf(theTimeSpan)}' is {theTimeSpan}")

' This example produces the following output
' 
' Variable 'theTime' is 11:59 PM
' Variable 'theTimeSpan' is 23:59:59

Nell'esempio seguente viene creato un DateTime da un oggetto TimeOnly, con una data arbitraria scelta:

var theTime = new TimeOnly(11, 25, 46);   // 11:25 AM and 46 seconds
var theDate = new DateOnly(2015, 10, 21); // October 21, 2015
var theDateTime = theDate.ToDateTime(theTime);
var reverseTime = TimeOnly.FromDateTime(theDateTime);

Console.WriteLine($"Date only is {theDate}");
Console.WriteLine($"Time only is {theTime}");
Console.WriteLine();
Console.WriteLine($"Combined to a DateTime type, the value is {theDateTime}");
Console.WriteLine($"Converted back from DateTime, the time is {reverseTime}");

/* This example produces the following output:
 * 
 * Date only is 10/21/2015
 * Time only is 11:25 AM
 * 
 * Combined to a DateTime type, the value is 10/21/2015 11:25:46 AM
 * Converted back from DateTime, the time is 11:25 AM
*/

Dim theTime = New TimeOnly(11, 25, 46) ' 11:   25 PM And 46 seconds
Dim theDate = New DateOnly(2015, 10, 21) ' October 21, 2015
Dim theDateTime = theDate.ToDateTime(theTime)
Dim reverseTime = TimeOnly.FromDateTime(theDateTime)

Console.WriteLine($"Date only is {theDate}")
Console.WriteLine($"Time only is {theTime}")
Console.WriteLine()
Console.WriteLine($"Combined to a DateTime type, the value is {theDateTime}")
Console.WriteLine($"Converted back from DateTime, the time is {reverseTime}")

' This example produces the following output
' 
' Date only is 10/21/2015
' Time only is 11:25 AM
' 
' Combined to a DateTime type, the value is 10/21/2015 11:25:46 AM
' Converted back from DateTime, the time is 11:25 AM

Operatori aritmetici e confronto di TimeOnly

Due istanze di TimeOnly possono essere confrontate tra loro ed è possibile usare il metodo IsBetween per verificare se un intervallo di tempo è tra due altre volte. Quando un operatore di addizione o sottrazione viene utilizzato in un TimeOnly, viene restituito un TimeSpan, che rappresenta una durata di tempo.

var start = new TimeOnly(10, 12, 01); // 10:12:01 AM
var end = new TimeOnly(14, 00, 53); // 02:00:53 PM

var outside = start.AddMinutes(-3);
var inside = start.AddMinutes(120);

Console.WriteLine($"Time starts at {start} and ends at {end}");
Console.WriteLine($" Is {outside} between the start and end? {outside.IsBetween(start, end)}");
Console.WriteLine($" Is {inside} between the start and end? {inside.IsBetween(start, end)}");
Console.WriteLine($" Is {start} less than {end}? {start < end}");
Console.WriteLine($" Is {start} greater than {end}? {start > end}");
Console.WriteLine($" Does {start} equal {end}? {start == end}");
Console.WriteLine($" The time between {start} and {end} is {end - start}");

/* This example produces the following output:
 * 
 * Time starts at 10:12 AM and ends at 2:00 PM
 *  Is 10:09 AM between the start and end? False
 *  Is 12:12 PM between the start and end? True
 *  Is 10:12 AM less than 2:00 PM? True
 *  Is 10:12 AM greater than 2:00 PM? False
 *  Does 10:12 AM equal 2:00 PM? False
 *  The time between 10:12 AM and 2:00 PM is 03:48:52
*/

Dim startDate = New TimeOnly(10, 12, 1) ' 10:12:01 AM
Dim endDate = New TimeOnly(14, 0, 53) ' 02:00:53 PM

Dim outside = startDate.AddMinutes(-3)
Dim inside = startDate.AddMinutes(120)

Console.WriteLine($"Time starts at {startDate} and ends at {endDate}")
Console.WriteLine($" Is {outside} between the start and end? {outside.IsBetween(startDate, endDate)}")
Console.WriteLine($" Is {inside} between the start and end? {inside.IsBetween(startDate, endDate)}")
Console.WriteLine($" Is {startDate} less than {endDate}? {startDate < endDate}")
Console.WriteLine($" Is {startDate} greater than {endDate}? {startDate > endDate}")
Console.WriteLine($" Does {startDate} equal {endDate}? {startDate = endDate}")
Console.WriteLine($" The time between {startDate} and {endDate} is {endDate - startDate}")

' This example produces the following output
' 
' Time starts at 10:12 AM And ends at 2:00 PM
'  Is 10:09 AM between the start And end? False
'  Is 12:12 PM between the start And end? True
'  Is 10:12 AM less than 2:00 PM? True
'  Is 10:12 AM greater than 2:00 PM? False
'  Does 10:12 AM equal 2:00 PM? False
'  The time between 10:12 AM and 2:00 PM is 03:48:52