Free, customisable clock widget for your own web site
Want an exact clock on your own web site? Or today's date, sunrise time, sunset time or day length? Just choose from the options below and copy the code! It's free!
Options
Terms of use
- A link back to Time.is must be clearly visible on your web page. You can rephrase or translate the link text, but it must contain Time.is, time, the name of the location (Miami), or the name of the time zone (EST). Acceptable link texts: "Time in Miami", "Miami", "Time now". Unacceptable link texts: "Click here"
- Your web page must not refresh automatically.
- Usage in apps and scripts is not allowed.
- The widget comes with no warranty.
- The widget is free, unless the main focus of your website is this widget.
- Time.is will block your widget if these conditions are not met.
Advanced usage
There are two widget scripts: A simplified version, t.js, which displays only time, and the main widget script, en_gb.js, which can display time, date, sunrise time, sunset time and day length. The main widget script is available in several languages. For other languages, replace en_gb in the script name with the code for the desired language. (For instance pl.js for Polish, or tr.js for Turkish.)
Parameters for the init function:
| Parameter | Valid keywords | Default value |
| template | TIME, DATE, SUN | TIME |
| time_format | hours, minutes, seconds, 12hours, AMPM | hours:minutes:seconds |
| date_format | dayname, dname, daynum, dnum, day_in_y, week, monthname, monthnum, mnum, yy, year | year-monthnum-daynum |
| sun_format | srhour, srminute, sr12hour, srAMPM, sshour, ssminute, ss12hour, ssAMPM, dlhours, dlminutes | srhour:srminute-sshour:ssminute |
| coords | The location's latitude and longitude. Required for displaying sun times and day length. | |
| id | For identifying the location and the time zone on the server side. Required if the location name contains non-ascii letters, and if you change the HTML element id. | |
| callback | The name of a function that will be called every second, with rendered template as parameter. (Optional) |
Parameter names and keywords are case sensitive. You can use HTML and other content in the template, time_format, date_format and sun_format parameters.
Multiple clocks can be created like this:
UTC time: <span id="UTC_za00"></span><br/>
New York sunrise time: <span id="New_York_z161"></span><br/>
Tokyo sunrise time: <span id="Tokyo_z444"></span><br/>
Find the <a href="https://time.is/" id="time_is_link" rel="nofollow">current time for any location or time zone on Time.is!</a>
<script src="//widget.time.is/en_gb.js"></script>
<script>
time_is_widget.init({
UTC_za00 : {},
New_York_z161 : {
template: "SUN",
sun_format: "srhour:srminute",
coords: "40.71427,-74.00597"
},
Tokyo_z444 : {
coords: "59.33258,18.06490"
}
});
</script>
Result:
The values of the time_format, date_format, sun_format and template parameters are inherited, so you don't need to repeat them if the value is the same as for the previously defined widget.
