time

Returns the current time, a specific time, converts a timestamp to a time structure, or extracts the time of a datetime

Syntax

• time()

• time(X)

  • X is any object

• time(h, m, s[, z])

  • h, m, s, and z are integers

Description

• time() returns the current time as a Time structure.

• time(X), where X is a timestamp, a Time structure, or a DateTime structure, returns this time, or the time part of X, as a Time structure.

• time(h, m, s, z) encodes the time with hour h, minute m, second s, and millisecond z (defaults to 0) as a Time structure.

Examples

time()

hour: 21
minute: 1
second: 23
millisecond: 807

time(0.5)

hour: 12
minute: 0
second: 0
millisecond: 0

time(14, 30, 00)

hour: 14
minute: 30
second: 0
millisecond: 0

time(now())

hour: 21
minute: 1
second: 23
millisecond: 807

See also

• date

• now