# 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 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.appybuilder.com/components/reference/sensors/clock.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.