({{, (RefLink[TimeObject, paclet:ref/TimeObject])[] 
represents the current time.}, {, (RefLink[TimeObject, paclet:ref/TimeObject])[{h,m,s}]
represents a time object of standard normalized form.}, {, (RefLink[TimeObject, paclet:ref/TimeObject])[date]
gives the time component of the specified date representation.}, {, (RefLink[TimeObject, paclet:ref/TimeObject])[rtime,gran]
gives the time object of granularity gran that includes the reference time rtime.}})

OpenersNotesSection(Spacer1)Details and Options

(RefLink[TimeObject, paclet:ref/TimeObject])[] uses whatever time has been set on your computer system by default.

Shorter lists can be used in (RefLink[TimeObject, paclet:ref/TimeObject])[{h,m,s}], which represents the time to whatever accuracy is specified: {h} is not treated as being equivalent to {h,0,0}.

(RefLink[TimeObject, paclet:ref/TimeObject])[rtime,gran] represents a granular element of time gran for the reference time rtime. For example, (RefLink[TimeObject, paclet:ref/TimeObject])[{10,4},"Minute"] represents the minute corresponding to 10:04 am.

In (RefLink[TimeObject, paclet:ref/TimeObject])[rtime,gran], the granularity gran can be any of the following:

(RefLink[TimeObject, paclet:ref/TimeObject]) allows addition and subtraction of time quantities.

Subtracting two (RefLink[TimeObject, paclet:ref/TimeObject]) constructs yields a time quantity.

The following options can be given:

(RefLink[TimeZone, paclet:ref/TimeZone]) specifications should be a numerical offset from GMT, a time zone string or (RefLink[None, paclet:ref/None]).

(RefLink[Information, paclet:ref/Information]) of a (RefLink[TimeObject, paclet:ref/TimeObject]) may include the following properties:

OpenersPrimaryExamplesSection(Spacer1)Examples  (5)

OpenersExampleSection0(Spacer1)Basic Examples  (2)

Represent the current time:

TimeObject[]

Represent 11:30am:

TimeObject[{11,30}]

Represent 15 seconds past 8:04pm:

TimeObject[{20,4,15}]

Add 13 hours to a time object:

TimeObject[{10,30}]+(Quantity[13, "h", hours, "Hours"])

Subtracting time objects gives a time quantity:

TimeObject[{16,17,21}]-TimeObject[{10,12,34}]

OpenersExampleSection1(Spacer1)Scope  (1)

Time objects are interpreted using their standard normalized form:

TimeObject[{26,2,12}]

OpenersExampleSection2(Spacer1)Options  (1)

OpenersExampleSubsection0(Spacer1)TimeZone  (1)

Represent a specific time in Greenwich, United Kingdom:

TimeObject[{20,10},TimeZone->0]

Represent 11am Central Time:

TimeObject[{11},TimeZone->"America/Chicago"]

OpenersExampleSection3(Spacer1)Properties & Relations  (1)

Compare time objects to determine their sequence of occurrence:

TimeObject[{11,0}]>TimeObject[{10,30}]

Sort[{TimeObject[{8,45}],TimeObject[{11,15}],TimeObject[{9,30}]}]

Comparisons of time objects with unequal precision and overlapping time periods will return unevaluated:

TimeObject[{10}]<TimeObject[{10,30}]

TimeObject[{10,0}]<TimeObject[{10,30}]

TimeObject[{9}]<TimeObject[{10,30}]

({{DocumentationFooterIconsRelatedFunction.png, ({{See Also}, {(RefLink[DateObject, paclet:ref/DateObject])  ▪  (RefLink[Now, paclet:ref/Now])  ▪  (RefLink[TimeZoneConvert, paclet:ref/TimeZoneConvert])  ▪  (RefLink[DateValue, paclet:ref/DateValue])  ▪  (RefLink[DateString, paclet:ref/DateString])  ▪  (RefLink[DateList, paclet:ref/DateList])  ▪  (RefLink[TimeSeries, paclet:ref/TimeSeries])  ▪  (RefLink[EventSeries, paclet:ref/EventSeries])  ▪  (RefLink[SiderealTime, paclet:ref/SiderealTime])}})}})

({{DocumentationFooterIconsRelatedGuide.png, ({{Related Guides}, {▪(RefLinkPlain[Date & Time, paclet:guide/DateAndTime])}, {▪(RefLinkPlain[Time Series Processing, paclet:guide/TimeSeries])}, {▪(RefLinkPlain[Free-Form & External Input, paclet:guide/FreeFormAndExternalInput])}, {▪(RefLinkPlain[Scientific Data Analysis, paclet:guide/ScientificDataAnalysis])}, {▪(RefLinkPlain[WDF (Wolfram Data Framework), paclet:guide/WDFWolframDataFramework])}})}})