Represents a control used for displaying the current date and/or time.

### Remarks

The contents of the clock are determined by the Format property. The default Format is `hh:mm:ss tt`.

Click the links below to learn more about date and time Format:

[Standard date and time format strings](https://docs.microsoft.com/en-us/dotnet/standard/base-types/standard-date-and-time-format-strings)

[Custom date and time format strings](https://docs.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings)

### Properties

| Property          | Type    | Description                                                                 |
|-------------------|---------|-----------------------------------------------------------------------------|
| `Background`      | Color   | The background color of the control.                                       |
| `Foreground`      | Color   | The color of the control's content.                                        |
| `FontSize`        | Float   | The size of the text in dp pixels.                                        |
| `FontStyle`       | Enum    | The style in which the text is rendered. Possible values are `Normal` & `Italic`. |
| `FontWeight`      | Enum    | The thickness of the specified font. Possible values are `Thin`, `Light`, `Normal`, `Medium`, `Bold`, `Black` |
| `TextAlignment`   | Enum    | A value that indicates the horizontal alignment of text content. Possible values are `Left`, `Right`, & `Center`. |
| `TextDecorations` | Enum    | A value that indicates what decorations are applied to the text. Possible values are `None`, `Strikethrough`, & `Underline`. |
| `TextTrimming`    | Enum    | The text trimming behavior to employ when content overflows the content area. Possible values are `None`, `CharacterEllipsis`, & `WordEllipsis`. |
| `TextWrapping` | Enum    | A value that indicates how the Label wraps text. Possible values are `NoWrap` & `Wrap`. |
| `Format`          | String  | The format for the date and time string.                                  |
| `RefreshInterval` | Integer | The rate, in milliseconds, that the clock should refresh its content.     |
| `Height`         | Float   | The suggested height of the control in dp pixels.                        |
| `HorizontalAlignment` | Enum  | The horizontal alignment characteristics that are applied to the control when it is composed in a parent layout panel, such as a Grid. |
| `Margin`         | Thickness | The outer margin that is applied to the control when it is composed in a parent layout panel, such as a Grid. |
| `Padding`        | Thickness | The amount of space between the content of the control and its border.   |
| `Rotation`       | Integer | The rotation about the Z-axis in degrees.                                 |
| `VerticalAlignment` | Enum  | The vertical alignment characteristics that are applied to the control when it is composed in a parent layout panel, such as a Grid. |
| `Width`          | Float   | The suggested width of the control in dp pixels.                          |
| `IsEnabled`      | Boolean | A value that indicates whether the user can interact with the control.    |
| `IsHitTestVisible` | Boolean  | A value that indicates whether the contained area of the control can return true values for hit testing. |
| `IsVisible`      | Boolean | A value that indicates whether the control should be visible.             |
| `Opacity`        | Float   | A value between 0 and 1.0 that declares the opacity factor, with 1.0 meaning full opacity and 0 meaning transparent. |

### Events

| Event    | Description                                                                                |
|----------|--------------------------------------------------------------------------------------------|
| `Loaded` | Occurs when the element is laid out, rendered, and ready for interaction.                  |
| `Unloaded` | Occurs when the element is no longer rendered on the screen.