TimeObject

✖
`TimeObject`

Updated in 14.1

✖

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[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
	"Decisecond"	moment accurate to 0.1 seconds
	"Centisecond"	moment accurate to 0.01 seconds
	"Millisecond"	moment accurate to 0.001 seconds
	"Microsecond"	moment accurate to 10^-6 seconds
	"Nanosecond"	moment accurate to 10^-9 seconds
	"Instant"	the exact specified time

TimeObject[rdate,n] where n is a non-negative Integer represents a date accurate to 10^-n seconds (e.g. TimeObject[rdate, 6] corresponds to 10^-6 seconds accuracy, the same as TimeObject[rdate,"Microsecond"]).
The maximum available value for n in TimeObject[rdate,n] is 9.
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 all

Basic Examples (2)Summary of the most common use cases

Represent the current time:

In[1]:=1

✖

https://wolfram.com/xid/0e7n20j2-jm76uc

Out[1]=1

Represent 11:30am:

In[1]:=1

✖

https://wolfram.com/xid/0e7n20j2-wuti3j

Out[1]=1

Represent 15 seconds past 8:04pm:

In[3]:=3

✖

https://wolfram.com/xid/0e7n20j2-egbmqb

Out[3]=3

Add 13 hours to a time object:

In[1]:=1

✖

https://wolfram.com/xid/0e7n20j2-uc62ks

Out[1]=1

Subtracting time objects gives a time quantity:

In[2]:=2

✖

https://wolfram.com/xid/0e7n20j2-w3jppf

Out[2]=2

Scope (1)Survey of the scope of standard use cases

Time objects are interpreted using their standard normalized form:

In[1]:=1

✖

https://wolfram.com/xid/0e7n20j2-beccom

Out[1]=1

Options (2)Common values & functionality for each option

DateGranularity (1)

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

In[1]:=1

✖

https://wolfram.com/xid/0e7n20j2-6z61y0

Out[1]=1

Use DateGranularity"Hour" to generate an hour:

In[4]:=4

✖

https://wolfram.com/xid/0e7n20j2-zi2tqw

Out[5]=5

TimeZone (1)

Represent a specific time in Greenwich, United Kingdom:

In[1]:=1

✖

https://wolfram.com/xid/0e7n20j2-bkzkzv

Out[1]=1

Represent 11am Central Time:

In[2]:=2

✖

https://wolfram.com/xid/0e7n20j2-wm98d

Out[2]=2

Properties & Relations (1)Properties of the function, and connections to other functions

Compare time objects to determine their sequence of occurrence:

In[1]:=1

✖

https://wolfram.com/xid/0e7n20j2-c4rrtz

Out[1]=1

In[1]:=1

✖

https://wolfram.com/xid/0e7n20j2-s1zzl9

Out[1]=1

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

In[3]:=3

✖

https://wolfram.com/xid/0e7n20j2-c61n4d

Out[3]=3

In[4]:=4

✖

https://wolfram.com/xid/0e7n20j2-7l48wx

Out[4]=4

In[5]:=5

✖

https://wolfram.com/xid/0e7n20j2-opcpg6

Out[5]=5

Top