represents the current time.


represents a time object of standard normalized form.


gives the time component of the specified date representation.


gives the time object of granularity gran that includes the reference time rtime.

Details and Options

  • TimeObject[] uses whatever time has been set on your computer system by default.
  • Shorter lists can be used in TimeObject[{h,m,s}], which represents the time to whatever accuracy is specified: {h} is not treated as being equivalent to {h,0,0}.
  • TimeObject[n] gives an object representing n hours from midnight and is equivalent to TimeObject[{n}].
  • TimeObject[rtime,gran] represents a granular element of time gran for the reference time rtime. For example, TimeObject[{10,4},"Minute"] represents the minute corresponding to 10:04 am.
  • In TimeObject[rtime,gran], the granularity gran can be any of the following:
  • "Hour"hour of the reference time
    "Minute"minute of the reference time
    "Second"second of the reference time
    "Instant"the exact specified time
  • TimeObject allows addition and subtraction of time quantities.
  • Subtracting two TimeObject constructs yields a time quantity.
  • The following options can be given:
  • DateGranularity Automaticgranularity being used
    TimeZone Nonetime zone being used
  • TimeZone specifications should be a numerical offset from GMT, a time zone string or None.
  • Information of a TimeObject may include the following properties:
  • "Time"string form of the specified time
    "Granularity"time granularity
    "TimeZone"time zone


open allclose all

Basic Examples  (2)

Represent the current time:

Represent 11:30am:

Represent 15 seconds past 8:04pm:

Add 13 hours to a time object:

Subtracting time objects gives a time quantity:

Scope  (1)

Time objects are interpreted using their standard normalized form:

Options  (2)

DateGranularity  (1)

By default, dates are generated with "Instant" granularity:

Use DateGranularity"Hour" to generate an hour:

TimeZone  (1)

Represent a specific time in Greenwich, United Kingdom:

Represent 11am Central Time:

Properties & Relations  (1)

Compare time objects to determine their sequence of occurrence:

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

Wolfram Research (2014), TimeObject, Wolfram Language function, https://reference.wolfram.com/language/ref/TimeObject.html (updated 2023).


Wolfram Research (2014), TimeObject, Wolfram Language function, https://reference.wolfram.com/language/ref/TimeObject.html (updated 2023).


Wolfram Language. 2014. "TimeObject." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2023. https://reference.wolfram.com/language/ref/TimeObject.html.


Wolfram Language. (2014). TimeObject. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/TimeObject.html


@misc{reference.wolfram_2024_timeobject, author="Wolfram Research", title="{TimeObject}", year="2023", howpublished="\url{https://reference.wolfram.com/language/ref/TimeObject.html}", note=[Accessed: 18-July-2024 ]}


@online{reference.wolfram_2024_timeobject, organization={Wolfram Research}, title={TimeObject}, year={2023}, url={https://reference.wolfram.com/language/ref/TimeObject.html}, note=[Accessed: 18-July-2024 ]}