TimeObject
represents the current time.
TimeObject[{h,m,s}]
represents a time object of standard normalized form.
TimeObject[date]
gives the time component of the specified date representation.
TimeObject[rtime,gran]
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[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 Automatic granularity being used TimeZone None time 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
Examples
open allclose allBasic Examples (2)
Options (2)
DateGranularity (1)
By default, dates are generated with "Instant" granularity:
Use DateGranularity"Hour" to generate an hour:
Text
Wolfram Research (2014), TimeObject, Wolfram Language function, https://reference.wolfram.com/language/ref/TimeObject.html (updated 2023).
CMS
Wolfram Language. 2014. "TimeObject." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2023. https://reference.wolfram.com/language/ref/TimeObject.html.
APA
Wolfram Language. (2014). TimeObject. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/TimeObject.html