> For the complete documentation index, see [llms.txt](https://help.appybuilder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.appybuilder.com/components/reference/sensors/clock.md). # Clock Non-visible component that provides the instant in time using the internal clock on the phone.It can fire a timer at regularly set intervals and perform time calculations, manipulations, and conversions. Methods to convert an instant to text are also available. Acceptable patterns are empty string, MM/DD/YYYY HH:mm:ss a, or MMM d, yyyy HH:mm. The empty string will provide the default format, which is "MMM d, yyyy HH:mm:ss a" for FormatDateTime, "MMM d, yyyy" for FormatDate. To see all possible format, please see here. Date and Time are formatted with InstantInTime and Duration. Instant : consists of Year, Month, DayOfMonth, Hour, Minute, and Second. An instant can be created by using MakeInstant method. Duration : time in milliseconds elapsed between instants. Duration can be obtained by Duration method. ## Properties ### TimerAlwaysFires Will fire even when application is not showing on the screen if true ### TimerEnabled Fires timer if true ### TimerInterval Interval between timer events in ms ## Events ### Timer() Timer has gone off. ## Methods ### InstantInTime AddDays(InstantInTime instant, number days) Returns an instant in time some days after the argument ### InstantInTime AddDuration(InstantInTime instant, Duration duration) Returns an instant in time some time after the argument. Duration can be obtained from Clock.Duration() ### InstantInTime AddHours(InstantInTime instant, number hours) Returns an instant in time some hours after the argument ### InstantInTime AddMinutes(InstantInTime instant, number minutes) Returns an instant in time some minutes after the argument ### InstantInTime AddMonths(InstantInTime instant, number months) Returns an instant in time some months after the argument ### InstantInTime AddSeconds(InstantInTime instant, number seconds) Returns an instant in time some seconds after the argument ### InstantInTime AddWeeks(InstantInTime instant, number weeks) Returns an instant in time some weeks after the argument ### InstantInTime AddYears(InstantInTime instant, number years) Returns an instant in time some years after the argument ### DayOfMonth(InstantInTime instant) Returns the day of the month(1-31) from the instant ### Duration(InstantInTime start, InstantInTime end) Returns duration, which is milliseconds elapsed between instants ### DurationToSeconds(Duration duration) Converts the duration to the number of seconds. ### DurationToMinutes(Duration duration) Converts the duration to the number of minutes. ### DurationToHours(Duration duration) Converts the duration to the number of hours. ### DurationToDays(Duration duration) Converts the duration to the number of days. number DurationToWeeks(Duration duration) Converts the duration to the number of weeks. ### FormatDate(InstantInTime instant, text pattern) Returns text representing the date of an instant in the specified pattern ### FormatDateTime(InstantInTime instant, text pattern) Returns text representing the date and time of an instant in the specified pattern ### FormatTime(InstantInTime instant) Return text representing the time of an instant ### GetMillis(InstantInTime instant) Returns the instant in time measured as milliseconds since 1970. ### Hour(InstantInTime instant) Returns the hour of the day(0-23) from the instant ### InstantInTime MakeInstant(text from) Returns an instant specified by MM/DD/YYYY hh:mm:ss or MM/DD/YYYY or hh:mm. An example text input is "06/22/2015 12:18" ### InstantInTime MakeInstantFromMillis(number millis) Returns an instant in time specified by the milliseconds since 1970. ### Minute(InstantInTime instant) Returns the minute of the hour (0-59) from the instant ### Month(InstantInTime instant) Returns the month of the year (1-12) from the instant ### MonthName(InstantInTime instant) Returns the name of the month from the instant E.g. January, February, March... ### InstantInTime Now() Returns an instant of the current time read from phone's clock ### Second(InstantInTime instant) Returns the second of the minute (0-59) from the instant ### SystemTime() Returns the phone's internal time ### Weekday(InstantInTime instant) Returns the day of the week represented as a number from 1 (Sunday) to 7 (Saturday) ### WeekdayName(InstantInTime instant) Returns the name of the day of the week from the instant ### Year(InstantInTime instant) Returns the year from the instant