mirror of
https://github.com/MichMich/MagicMirror.git
synced 2025-10-29 22:47:25 +00:00
71 lines
1.9 KiB
Markdown
71 lines
1.9 KiB
Markdown
# Module: Clock
|
|
The `clock` module is one of the default modules of the MagicMirror.
|
|
This module displays the current date and time. The information will be updated realtime.
|
|
|
|
## Using the module
|
|
|
|
To use this module, add it to the modules array in the `config/config.js` file:
|
|
````javascript
|
|
modules: [
|
|
{
|
|
module: 'clock',
|
|
position: 'top_left', // This can be any of the regions.
|
|
config: {
|
|
// The config property is optional.
|
|
// See 'Configuration options' for more information.
|
|
}
|
|
}
|
|
]
|
|
````
|
|
|
|
## Configuration options
|
|
|
|
The following properties can be configured:
|
|
|
|
<table width="100%">
|
|
<!-- why, markdown... -->
|
|
<thead>
|
|
<tr>
|
|
<th>Option</th>
|
|
<th width="100%">Description</th>
|
|
</tr>
|
|
<thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><code>timeFormat</code></td>
|
|
<td>Use 12 or 24 hour format.<br>
|
|
<br><b>Possible values:</b> <code>12</code> or <code>24</code>
|
|
<br><b>Default value:</b> uses value of <i>config.timeFormat</i>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>displaySeconds</code></td>
|
|
<td>Display seconds.<br>
|
|
<br><b>Possible values:</b> <code>true</code> or <code>false</code>
|
|
<br><b>Default value:</b> <code>true</code>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>showPeriod</code></td>
|
|
<td>Show the period (am/pm) with 12 hour format.<br>
|
|
<br><b>Possible values:</b> <code>true</code> or <code>false</code>
|
|
<br><b>Default value:</b> <code>true</code>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>showPeriodUpper</code></td>
|
|
<td>Show the period (AM/PM) with 12 hour format as uppercase.<br>
|
|
<br><b>Possible values:</b> <code>true</code> or <code>false</code>
|
|
<br><b>Default value:</b> <code>false</code>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>clockBold</code></td>
|
|
<td>Remove the colon and bold the minutes to make a more modern look.<br>
|
|
<br><b>Possible values:</b> <code>true</code> or <code>false</code>
|
|
<br><b>Default value:</b> <code>false</code>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|