hour();The current time, in hours (0 to 23)

minute();

The current time, in minutes (0 to 59)

second();

The current time, in seconds (0 to 59)

day();

The current date, in day of the month (1 to 31)

month();

The current date, in month of the year (1 to 12)

year();

The current date, in years (2013, 2014, etc)

setTime(hours, minutes, seconds, days, months, years);

The time and date, using the 6 parameters above.

adjustTime(number);

Adjust the time, adding (positive numbers) or removing (negative numbers) seconds.

Usage with 32-Bit "time_t"

Time uses a special time_t variable type, which is the number of seconds elapsed since 1970. Using time_t lets you store or compare times as a single number, rather that dealing with 6 numbers and details like the number of days in each month and leap years.

now();

Reads the current time, as a time_t number.

setTime(t);

Sets the current time, based on a time_t number.

makeTime(tm);

Convert normal date & time to a time_t number. The time_t number is returned. The tm input is a TimeElements variable type, which has these fields:

tm.Second  Seconds   0 to 59 tm.Minute  Minutes   0 to 59 tm.Hour    Hours     0 to 23 tm.Wday    Week Day  0 to 6  (not needed for mktime) tm.Day     Day       1 to 31 tm.Month   Month     1 to 12 tm.Year    Year      0 to 99 (offset from 1970)

breakTime(t, tm);

Convert a time_t number to normal date & time. The tm input is a TimeElements variable which breakTime fills with the 7 numbers, computed from the "t" input.

hour(t);

minute(t);

second(t);

day(t);

month(t);

year(t);

Convert a time_t number to a single time or data field. These can be simpler to use than breakTime() and a 7-field TimeElements variable.

Synchronization With Other Time Services

Time can synchronize its clock with another source of known time. You can use the setTime functions above, or configure Time to automatically call a function which will report the time.

timeStatus();

Returns the status of time sync. Three type of status are defined, with these names:

timeNotSet     Time's clock has not been set.  The time & date are unknown. timeSet        Time's clock has been set. timeNeedsSync  Time's clock is set, but the sync has failed, so it may not be accurate.

setSyncProvider(getTimeFunction);

Configure Time to automatically called the getTimeFunction() regularly. This function should obtain the time from another service and return a time_t number, or zero if the time is not known.

setSyncInterval(seconds);

Configure how often the getTimeFunction is called.

TimeSerial Example Program

TimeSerial demonstrates how to set the time & date when no other hardware is capable of providing this information.

You can open this example from File > Examples > Time > TimeSerial.

TimeSerial listens for a message from your computer. This message is sent by a Processing-based program, found in Time's examples/Processing folder. You will need Processing to run this program.