Struct LocalTime
LocalTime is an immutable struct representing a time of day, with no reference
to a particular calendar, time zone or date.
Since 1.0.x
Availability netstandard2.0
Implements
System.IFormattable
System.IComparable
System.Xml.Serialization.IXmlSerializable
Inherited Members
System.Object.GetType()
Namespace: NodaTime
Assembly: NodaTime.dll
Syntax
[TypeConverter(typeof(LocalTimeTypeConverter))]
public struct LocalTime : IEquatable<LocalTime>, IComparable<LocalTime>, IFormattable, IComparable, IXmlSerializable
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Constructors
LocalTime(Int32, Int32)
Creates a local time at the given hour and minute, with second, millisecondofsecond
and tickofmillisecond values of zero.
Since 1.0.x
Availability netstandard2.0
Declaration
public LocalTime(int hour, int minute)
Parameters
Type  Name  Description 

Int32  hour  The hour of day. 
Int32  minute  The minute of the hour. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Exceptions
Type  Condition 

System.ArgumentOutOfRangeException  The parameters do not form a valid time. 
LocalTime(Int32, Int32, Int32)
Creates a local time at the given hour, minute and second,
with millisecondofsecond and tickofmillisecond values of zero.
Since 1.0.x
Availability netstandard2.0
Declaration
public LocalTime(int hour, int minute, int second)
Parameters
Type  Name  Description 

Int32  hour  The hour of day. 
Int32  minute  The minute of the hour. 
Int32  second  The second of the minute. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Sample snippet
using NodaTime;
using System;
using System.Globalization;
LocalTime time = new LocalTime(16, 20, 0);
Console.WriteLine(time.ToString("HH:mm:ss", CultureInfo.InvariantCulture));
Output:
16:20:00
Exceptions
Type  Condition 

System.ArgumentOutOfRangeException  The parameters do not form a valid time. 
LocalTime(Int32, Int32, Int32, Int32)
Creates a local time at the given hour, minute, second and millisecond,
with a tickofmillisecond value of zero.
Since 1.0.x
Availability netstandard2.0
Declaration
public LocalTime(int hour, int minute, int second, int millisecond)
Parameters
Type  Name  Description 

Int32  hour  The hour of day. 
Int32  minute  The minute of the hour. 
Int32  second  The second of the minute. 
Int32  millisecond  The millisecond of the second. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Exceptions
Type  Condition 

System.ArgumentOutOfRangeException  The parameters do not form a valid time. 
Properties
ClockHourOfHalfDay
Gets the hour of the halfday of this local time, in the range 1 to 12 inclusive.
Since 1.0.x
Availability netstandard2.0
Declaration
public int ClockHourOfHalfDay { get; }
Property Value
Type  Description 

Int32  The hour of the halfday of this local time, in the range 1 to 12 inclusive. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Hour
Gets the hour of day of this local time, in the range 0 to 23 inclusive.
Since 1.0.x
Availability netstandard2.0
Declaration
public int Hour { get; }
Property Value
Type  Description 

Int32  The hour of day of this local time, in the range 0 to 23 inclusive. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
MaxValue
The maximum value of this type, one nanosecond before midnight.
Since 2.0.x
Availability netstandard2.0
Declaration
public static LocalTime MaxValue { get; }
Property Value
Type  Description 

LocalTime 
Remarks
This is useful if you have to use an inclusive upper bound for some reason.
In general, it's better to use an exclusive upper bound, in which case use midnight of
the following day.
Midnight
Local time at midnight, i.e. 0 hours, 0 minutes, 0 seconds.
Since 1.0.x
Availability netstandard2.0
Declaration
public static LocalTime Midnight { get; }
Property Value
Type  Description 

LocalTime 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Millisecond
Gets the millisecond of this local time within the second, in the range 0 to 999 inclusive.
Since 1.0.x
Availability netstandard2.0
Declaration
public int Millisecond { get; }
Property Value
Type  Description 

Int32  The millisecond of this local time within the second, in the range 0 to 999 inclusive. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Minute
Gets the minute of this local time, in the range 0 to 59 inclusive.
Since 1.0.x
Availability netstandard2.0
Declaration
public int Minute { get; }
Property Value
Type  Description 

Int32  The minute of this local time, in the range 0 to 59 inclusive. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
MinValue
The minimum value of this type; equivalent to Midnight.
Since 2.0.x
Availability netstandard2.0
Declaration
public static LocalTime MinValue { get; }
Property Value
Type  Description 

LocalTime 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
NanosecondOfDay
Gets the nanosecond of this local time within the day, in the range 0 to 86,399,999,999,999 inclusive.
Since 2.0.x
Availability netstandard2.0
Declaration
public long NanosecondOfDay { get; }
Property Value
Type  Description 

Int64  The nanosecond of this local time within the day, in the range 0 to 86,399,999,999,999 inclusive. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
NanosecondOfSecond
Gets the nanosecond of this local time within the second, in the range 0 to 999,999,999 inclusive.
Since 2.0.x
Availability netstandard2.0
Declaration
public int NanosecondOfSecond { get; }
Property Value
Type  Description 

Int32  The nanosecond of this local time within the second, in the range 0 to 999,999,999 inclusive. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Noon
Local time at noon, i.e. 12 hours, 0 minutes, 0 seconds.
Since 1.0.x
Availability netstandard2.0
Declaration
public static LocalTime Noon { get; }
Property Value
Type  Description 

LocalTime 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Second
Gets the second of this local time within the minute, in the range 0 to 59 inclusive.
Since 1.0.x
Availability netstandard2.0
Declaration
public int Second { get; }
Property Value
Type  Description 

Int32  The second of this local time within the minute, in the range 0 to 59 inclusive. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
TickOfDay
Gets the tick of this local time within the day, in the range 0 to 863,999,999,999 inclusive.
Since 1.0.x
Availability netstandard2.0
Declaration
public long TickOfDay { get; }
Property Value
Type  Description 

Int64  The tick of this local time within the day, in the range 0 to 863,999,999,999 inclusive. 
Remarks
If the value does not fall on a tick boundary, it will be truncated towards zero.
TickOfSecond
Gets the tick of this local time within the second, in the range 0 to 9,999,999 inclusive.
Since 1.0.x
Availability netstandard2.0
Declaration
public int TickOfSecond { get; }
Property Value
Type  Description 

Int32  The tick of this local time within the second, in the range 0 to 9,999,999 inclusive. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Methods
Add(LocalTime, Period)
Adds the specified period to the time. Friendly alternative to
operator+()
.
Since 1.0.x
Availability netstandard2.0
Declaration
public static LocalTime Add(LocalTime time, Period period)
Parameters
Type  Name  Description 

LocalTime  time  The time to add the period to 
Period  period  The period to add. Must not contain any (nonzero) date units. 
Returns
Type  Description 

LocalTime  The sum of the given time and period 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
AddSchema(XmlSchemaSet)
Adds the XML schema type describing the structure of the LocalTime XML serialization to the given
xmlSchemaSet
.
the xmlSchemaSet
.
Since 3.0.x
Availability netstandard2.0
Declaration
public static XmlQualifiedName AddSchema(XmlSchemaSet xmlSchemaSet)
Parameters
Type  Name  Description 

System.Xml.Schema.XmlSchemaSet  xmlSchemaSet  The XML schema set provided by System.Xml.Serialization.XmlSchemaExporter. 
Returns
Type  Description 

System.Xml.XmlQualifiedName  The qualified name of the schema type that was added to the xmlSchemaSet . 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
CompareTo(LocalTime)
Indicates whether this time is earlier, later or the same as another one.
See the type documentation for a description of ordering semantics.
Since 1.0.x
Availability netstandard2.0
Declaration
public int CompareTo(LocalTime other)
Parameters
Type  Name  Description 

LocalTime  other  The other date/time to compare this one with 
Returns
Type  Description 

Int32  A value less than zero if this time is earlier than other ;
zero if this time is the same as other ; a value greater than zero if this time is
later than other . 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Deconstruct(out Int32, out Int32, out Int32)
Deconstruct this time into its components.
Since 2.3.x
Availability netstandard2.0
Declaration
public void Deconstruct(out int hour, out int minute, out int second)
Parameters
Type  Name  Description 

Int32  hour  The hour of the time. 
Int32  minute  The minute of the hour. 
Int32  second  The second within the minute. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Equals(LocalTime)
Compares this local time with the specified one for equality.
See the type documentation for a description of equality semantics.
Since 1.0.x
Availability netstandard2.0
Declaration
public bool Equals(LocalTime other)
Parameters
Type  Name  Description 

LocalTime  other  The other local time to compare this one with 
Returns
Type  Description 

System.Boolean  True if the specified time is equal to this one; false otherwise 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Equals(Object)
Compares this local time with the specified reference.
See the type documentation for a description of equality semantics.
Since 1.0.x
Availability netstandard2.0
Declaration
public override bool Equals(object obj)
Parameters
Type  Name  Description 

System.Object  obj  The object to compare this one with 
Returns
Type  Description 

System.Boolean  True if the specified value is a local time which is equal to this one; false otherwise 
Overrides
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
FromHourMinuteSecondMillisecondTick(Int32, Int32, Int32, Int32, Int32)
Factory method to create a local time at the given hour, minute, second, millisecond and tick within millisecond.
Since 1.4.x
Availability netstandard2.0
Declaration
public static LocalTime FromHourMinuteSecondMillisecondTick(int hour, int minute, int second, int millisecond, int tickWithinMillisecond)
Parameters
Type  Name  Description 

Int32  hour  The hour of day. 
Int32  minute  The minute of the hour. 
Int32  second  The second of the minute. 
Int32  millisecond  The millisecond of the second. 
Int32  tickWithinMillisecond  The tick within the millisecond. 
Returns
Type  Description 

LocalTime  The resulting time. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Exceptions
Type  Condition 

System.ArgumentOutOfRangeException  The parameters do not form a valid time. 
FromHourMinuteSecondNanosecond(Int32, Int32, Int32, Int64)
Factory method for creating a local time from the hour of day, minute of hour, second of minute, and nanosecond of second.
Since 2.0.x
Availability netstandard2.0
Declaration
public static LocalTime FromHourMinuteSecondNanosecond(int hour, int minute, int second, long nanosecondWithinSecond)
Parameters
Type  Name  Description 

Int32  hour  The hour of day in the desired time, in the range [0, 23]. 
Int32  minute  The minute of hour in the desired time, in the range [0, 59]. 
Int32  second  The second of minute in the desired time, in the range [0, 59]. 
Int64  nanosecondWithinSecond  The nanosecond within the second in the desired time, in the range [0, 999999999]. 
Returns
Type  Description 

LocalTime  The resulting time. 
Remarks
This is not a constructor overload as it would have the same signature as the one taking millisecond of second.
Exceptions
Type  Condition 

System.ArgumentOutOfRangeException  The parameters do not form a valid time. 
FromHourMinuteSecondTick(Int32, Int32, Int32, Int32)
Factory method for creating a local time from the hour of day, minute of hour, second of minute, and tick of second.
Since 1.0.x
Availability netstandard2.0
Declaration
public static LocalTime FromHourMinuteSecondTick(int hour, int minute, int second, int tickWithinSecond)
Parameters
Type  Name  Description 

Int32  hour  The hour of day in the desired time, in the range [0, 23]. 
Int32  minute  The minute of hour in the desired time, in the range [0, 59]. 
Int32  second  The second of minute in the desired time, in the range [0, 59]. 
Int32  tickWithinSecond  The tick within the second in the desired time, in the range [0, 9999999]. 
Returns
Type  Description 

LocalTime  The resulting time. 
Remarks
This is not a constructor overload as it would have the same signature as the one taking millisecond of second.
Exceptions
Type  Condition 

System.ArgumentOutOfRangeException  The parameters do not form a valid time. 
FromHoursSinceMidnight(Int32)
Factory method for creating a local time from the number of hours which have elapsed since midnight.
Since 3.0.x
Availability netstandard2.0
Declaration
public static LocalTime FromHoursSinceMidnight(int hours)
Parameters
Type  Name  Description 

Int32  hours  The number of hours, in the range [0, 23] 
Returns
Type  Description 

LocalTime  The resulting time. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
FromMillisecondsSinceMidnight(Int32)
Factory method for creating a local time from the number of milliseconds which have elapsed since midnight.
Since 1.1.x
Availability netstandard2.0
Declaration
public static LocalTime FromMillisecondsSinceMidnight(int milliseconds)
Parameters
Type  Name  Description 

Int32  milliseconds  The number of milliseconds, in the range [0, 86,399,999] 
Returns
Type  Description 

LocalTime  The resulting time. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
FromMinutesSinceMidnight(Int32)
Factory method for creating a local time from the number of minutes which have elapsed since midnight.
Since 3.0.x
Availability netstandard2.0
Declaration
public static LocalTime FromMinutesSinceMidnight(int minutes)
Parameters
Type  Name  Description 

Int32  minutes  The number of minutes, in the range [0, 1439] 
Returns
Type  Description 

LocalTime  The resulting time. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
FromNanosecondsSinceMidnight(Int64)
Factory method for creating a local time from the number of nanoseconds which have elapsed since midnight.
Since 3.0.x
Availability netstandard2.0
Declaration
public static LocalTime FromNanosecondsSinceMidnight(long nanoseconds)
Parameters
Type  Name  Description 

Int64  nanoseconds  The number of nanoseconds, in the range [0, 86,399,999,999,999] 
Returns
Type  Description 

LocalTime  The resulting time. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
FromSecondsSinceMidnight(Int32)
Factory method for creating a local time from the number of seconds which have elapsed since midnight.
Since 1.1.x
Availability netstandard2.0
Declaration
public static LocalTime FromSecondsSinceMidnight(int seconds)
Parameters
Type  Name  Description 

Int32  seconds  The number of seconds, in the range [0, 86,399] 
Returns
Type  Description 

LocalTime  The resulting time. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
FromTicksSinceMidnight(Int64)
Factory method for creating a local time from the number of ticks which have elapsed since midnight.
Since 1.1.x
Availability netstandard2.0
Declaration
public static LocalTime FromTicksSinceMidnight(long ticks)
Parameters
Type  Name  Description 

Int64  ticks  The number of ticks, in the range [0, 863,999,999,999] 
Returns
Type  Description 

LocalTime  The resulting time. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
GetHashCode()
Returns a hash code for this local time.
See the type documentation for a description of equality semantics.
Since 1.0.x
Availability netstandard2.0
Declaration
public override int GetHashCode()
Returns
Type  Description 

Int32  A hash code for this local time. 
Overrides
System.ValueType.GetHashCode()
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Max(LocalTime, LocalTime)
Returns the later time of the given two.
Since 2.3.x
Availability netstandard2.0
Declaration
public static LocalTime Max(LocalTime x, LocalTime y)
Parameters
Type  Name  Description 

LocalTime  x  The first time to compare. 
LocalTime  y  The second time to compare. 
Returns
Type  Description 

LocalTime  The later instant of x or y . 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Min(LocalTime, LocalTime)
Returns the earlier time of the given two.
Since 2.3.x
Availability netstandard2.0
Declaration
public static LocalTime Min(LocalTime x, LocalTime y)
Parameters
Type  Name  Description 

LocalTime  x  The first time to compare. 
LocalTime  y  The second time to compare. 
Returns
Type  Description 

LocalTime  The earlier time of x or y . 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Minus(LocalTime)
Subtracts the specified time from this time, returning the result as a Period.
Fluent alternative to
operator()
.
Since 2.0.x
Availability netstandard2.0
Declaration
public Period Minus(LocalTime time)
Parameters
Type  Name  Description 

LocalTime  time  The time to subtract from this 
Returns
Type  Description 

Period  The difference between the specified time and this one 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Minus(Period)
Subtracts the specified period from this time. Fluent alternative to
operator()
.
Since 1.0.x
Availability netstandard2.0
Declaration
public LocalTime Minus(Period period)
Parameters
Type  Name  Description 

Period  period  The period to subtract. Must not contain any (nonzero) date units. 
Returns
Type  Description 

LocalTime  The result of subtracting the given period from this time. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
On(LocalDate)
Combines this LocalTime with the given LocalDate
into a single LocalDateTime.
Fluent alternative to
operator+()
.
Since 1.3.x
Availability netstandard2.0
Declaration
public LocalDateTime On(LocalDate date)
Parameters
Type  Name  Description 

LocalDate  date  The date to combine with this time 
Returns
Type  Description 

LocalDateTime  The LocalDateTime representation of the given time on this date 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Plus(Period)
Adds the specified period to this time. Fluent alternative to
operator+()
.
Since 1.0.x
Availability netstandard2.0
Declaration
public LocalTime Plus(Period period)
Parameters
Type  Name  Description 

Period  period  The period to add. Must not contain any (nonzero) date units. 
Returns
Type  Description 

LocalTime  The sum of this time and the given period 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
PlusHours(Int64)
Returns a new LocalTime representing the current value with the given number of hours added.
Since 1.0.x
Availability netstandard2.0
Declaration
public LocalTime PlusHours(long hours)
Parameters
Type  Name  Description 

Int64  hours  The number of hours to add 
Returns
Type  Description 

LocalTime  The current value plus the given number of hours. 
Remarks
If the value goes past the start or end of the day, it wraps  so 11pm plus two hours is 1am, for example.
PlusMilliseconds(Int64)
Returns a new LocalTime representing the current value with the given number of milliseconds added.
Since 1.0.x
Availability netstandard2.0
Declaration
public LocalTime PlusMilliseconds(long milliseconds)
Parameters
Type  Name  Description 

Int64  milliseconds  The number of milliseconds to add 
Returns
Type  Description 

LocalTime  The current value plus the given number of milliseconds. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
PlusMinutes(Int64)
Returns a new LocalTime representing the current value with the given number of minutes added.
Since 1.0.x
Availability netstandard2.0
Declaration
public LocalTime PlusMinutes(long minutes)
Parameters
Type  Name  Description 

Int64  minutes  The number of minutes to add 
Returns
Type  Description 

LocalTime  The current value plus the given number of minutes. 
Remarks
If the value goes past the start or end of the day, it wraps  so 11pm plus 120 minutes is 1am, for example.
PlusNanoseconds(Int64)
Returns a new LocalTime representing the current value with the given number of nanoseconds added.
Since 2.0.x
Availability netstandard2.0
Declaration
public LocalTime PlusNanoseconds(long nanoseconds)
Parameters
Type  Name  Description 

Int64  nanoseconds  The number of nanoseconds to add 
Returns
Type  Description 

LocalTime  The current value plus the given number of ticks. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
PlusSeconds(Int64)
Returns a new LocalTime representing the current value with the given number of seconds added.
Since 1.0.x
Availability netstandard2.0
Declaration
public LocalTime PlusSeconds(long seconds)
Parameters
Type  Name  Description 

Int64  seconds  The number of seconds to add 
Returns
Type  Description 

LocalTime  The current value plus the given number of seconds. 
Remarks
If the value goes past the start or end of the day, it wraps  so 11:59pm plus 120 seconds is 12:01am, for example.
PlusTicks(Int64)
Returns a new LocalTime representing the current value with the given number of ticks added.
Since 1.0.x
Availability netstandard2.0
Declaration
public LocalTime PlusTicks(long ticks)
Parameters
Type  Name  Description 

Int64  ticks  The number of ticks to add 
Returns
Type  Description 

LocalTime  The current value plus the given number of ticks. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Subtract(LocalTime, LocalTime)
Subtracts one time from another, returning the result as a Period with units of years, months and days.
Since 2.0.x
Availability netstandard2.0
Declaration
public static Period Subtract(LocalTime lhs, LocalTime rhs)
Parameters
Type  Name  Description 

LocalTime  lhs  The time to subtract from 
LocalTime  rhs  The time to subtract 
Returns
Type  Description 

Period  The result of subtracting one time from another. 
Remarks
This is simply a convenience method for calling Between(LocalTime, LocalTime).
Subtract(LocalTime, Period)
Subtracts the specified period from the time. Friendly alternative to
operator()
.
Since 1.0.x
Availability netstandard2.0
Declaration
public static LocalTime Subtract(LocalTime time, Period period)
Parameters
Type  Name  Description 

LocalTime  time  The time to subtract the period from 
Period  period  The period to subtract. Must not contain any (nonzero) date units. 
Returns
Type  Description 

LocalTime  The result of subtracting the given period from the time. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
ToString()
Returns a String that represents this instance.
Since 1.0.x
Availability netstandard2.0
Declaration
public override string ToString()
Returns
Type  Description 

String  The value of the current instance in the default format pattern ("T"), using the current thread's culture to obtain a format provider. 
Overrides
System.ValueType.ToString()
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
ToString(String, IFormatProvider)
Formats the value of the current instance using the specified pattern.
Since 1.0.x
Availability netstandard2.0
Declaration
public string ToString(string patternText, IFormatProvider formatProvider)
Parameters
Type  Name  Description 

String  patternText  The String specifying the pattern to use, or null to use the default format pattern ("T"). 
IFormatProvider  formatProvider  The IFormatProvider to use when formatting the value, or null to use the current thread's culture to obtain a format provider. 
Returns
Type  Description 

String  A String containing the value of the current instance in the specified format. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
With(Func<LocalTime, LocalTime>)
Returns this time, with the given adjuster applied to it.
Since 2.0.x
Availability netstandard2.0
Declaration
public LocalTime With(Func<LocalTime, LocalTime> adjuster)
Parameters
Type  Name  Description 

Func<LocalTime, LocalTime>  adjuster  The adjuster to apply. 
Returns
Type  Description 

LocalTime  The adjusted time. 
Remarks
If the adjuster attempts to construct an invalid time, any exception thrown by
that construction attempt will be propagated through this method.
WithOffset(Offset)
Returns an OffsetTime for this timeofday with the given offset.
Since 2.3.x
Availability netstandard2.0
Declaration
public OffsetTime WithOffset(Offset offset)
Parameters
Type  Name  Description 

Offset  offset  The offset to apply. 
Returns
Type  Description 

OffsetTime  The result of this timeofday offset by the given amount. 
Remarks
This method is purely a convenient alternative to calling the OffsetTime constructor directly.
Operators
Addition(LocalTime, Period)
Creates a new local time by adding a period to an existing time. The period must not contain
any daterelated units (days etc) with nonzero values.
Since 1.0.x
Availability netstandard2.0
Declaration
public static LocalTime operator +(LocalTime time, Period period)
Parameters
Type  Name  Description 

LocalTime  time  The time to add the period to 
Period  period  The period to add 
Returns
Type  Description 

LocalTime  The result of adding the period to the time, wrapping via midnight if necessary 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Equality(LocalTime, LocalTime)
Compares two local times for equality.
See the type documentation for a description of equality semantics.
Since 1.0.x
Availability netstandard2.0
Declaration
public static bool operator ==(LocalTime lhs, LocalTime rhs)
Parameters
Type  Name  Description 

LocalTime  lhs  The first value to compare 
LocalTime  rhs  The second value to compare 
Returns
Type  Description 

System.Boolean  True if the two times are the same; false otherwise 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
GreaterThan(LocalTime, LocalTime)
Compares two LocalTime values to see if the left one is strictly later than the right one.
See the type documentation for a description of ordering semantics.
Since 1.0.x
Availability netstandard2.0
Declaration
public static bool operator>(LocalTime lhs, LocalTime rhs)
Parameters
Type  Name  Description 

LocalTime  lhs  First operand of the comparison 
LocalTime  rhs  Second operand of the comparison 
Returns
Type  Description 

System.Boolean  true if the lhs is strictly later than rhs , false otherwise. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
GreaterThanOrEqual(LocalTime, LocalTime)
Compares two LocalTime values to see if the left one is later than or equal to the right one.
See the type documentation for a description of ordering semantics.
Since 1.0.x
Availability netstandard2.0
Declaration
public static bool operator >=(LocalTime lhs, LocalTime rhs)
Parameters
Type  Name  Description 

LocalTime  lhs  First operand of the comparison 
LocalTime  rhs  Second operand of the comparison 
Returns
Type  Description 

System.Boolean  true if the lhs is later than or equal to rhs , false otherwise. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Inequality(LocalTime, LocalTime)
Compares two local times for inequality.
See the type documentation for a description of equality semantics.
Since 1.0.x
Availability netstandard2.0
Declaration
public static bool operator !=(LocalTime lhs, LocalTime rhs)
Parameters
Type  Name  Description 

LocalTime  lhs  The first value to compare 
LocalTime  rhs  The second value to compare 
Returns
Type  Description 

System.Boolean  False if the two times are the same; true otherwise 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
LessThan(LocalTime, LocalTime)
Compares two LocalTime values to see if the left one is strictly earlier than the right one.
See the type documentation for a description of ordering semantics.
Since 1.0.x
Availability netstandard2.0
Declaration
public static bool operator <(LocalTime lhs, LocalTime rhs)
Parameters
Type  Name  Description 

LocalTime  lhs  First operand of the comparison 
LocalTime  rhs  Second operand of the comparison 
Returns
Type  Description 

System.Boolean  true if the lhs is strictly earlier than rhs , false otherwise. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
LessThanOrEqual(LocalTime, LocalTime)
Compares two LocalTime values to see if the left one is earlier than or equal to the right one.
See the type documentation for a description of ordering semantics.
Since 1.0.x
Availability netstandard2.0
Declaration
public static bool operator <=(LocalTime lhs, LocalTime rhs)
Parameters
Type  Name  Description 

LocalTime  lhs  First operand of the comparison 
LocalTime  rhs  Second operand of the comparison 
Returns
Type  Description 

System.Boolean  true if the lhs is earlier than or equal to rhs , false otherwise. 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Subtraction(LocalTime, LocalTime)
Subtracts one time from another, returning the result as a Period.
Since 2.0.x
Availability netstandard2.0
Declaration
public static Period operator (LocalTime lhs, LocalTime rhs)
Parameters
Type  Name  Description 

LocalTime  lhs  The time to subtract from 
LocalTime  rhs  The time to subtract 
Returns
Type  Description 

Period  The result of subtracting one time from another. 
Remarks
This is simply a convenience operator for calling Between(LocalTime, LocalTime).
Subtraction(LocalTime, Period)
Creates a new local time by subtracting a period from an existing time. The period must not contain
any daterelated units (days etc) with nonzero values.
This is a convenience operator over the Minus(Period) method.
Since 1.0.x
Availability netstandard2.0
Declaration
public static LocalTime operator (LocalTime time, Period period)
Parameters
Type  Name  Description 

LocalTime  time  The time to subtract the period from 
Period  period  The period to subtract 
Returns
Type  Description 

LocalTime  The result of subtract the period from the time, wrapping via midnight if necessary 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Explicit Interface Implementations
IComparable.CompareTo(Object)
Implementation of System.IComparable.CompareTo(System.Object) to compare two LocalTimes.
See the type documentation for a description of ordering semantics.
Since 1.1.x
Availability netstandard2.0
Declaration
int IComparable.CompareTo(object obj)
Parameters
Type  Name  Description 

System.Object  obj  The object to compare this value with. 
Returns
Type  Description 

Int32  The result of comparing this LocalTime with another one; see CompareTo(LocalTime) for general details.
If obj is null, this method returns a value greater than 0.

Remarks
This uses explicit interface implementation to avoid it being called accidentally. The generic implementation should usually be preferred.
Exceptions
Type  Condition 

ArgumentException  obj is nonnull but does not refer to an instance of LocalTime. 
IXmlSerializable.GetSchema()
Since 1.2.x
Availability netstandard2.0
Declaration
XmlSchema IXmlSerializable.GetSchema()
Returns
Type  Description 

XmlSchema 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
IXmlSerializable.ReadXml(XmlReader)
Since 1.2.x
Availability netstandard2.0
Declaration
void IXmlSerializable.ReadXml(XmlReader reader)
Parameters
Type  Name  Description 

XmlReader  reader 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
IXmlSerializable.WriteXml(XmlWriter)
Since 1.2.x
Availability netstandard2.0
Declaration
void IXmlSerializable.WriteXml(XmlWriter writer)
Parameters
Type  Name  Description 

XmlWriter  writer 
Remarks
Ordering and equality are defined in the natural way, simply comparing the number of "nanoseconds since midnight".
Implements
System.IFormattable
System.IComparable
System.Xml.Serialization.IXmlSerializable