Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
xfce:xfce4-panel:clock [2018/04/17 17:08] – [Label and Tooltip Markup] alexxcons | xfce:xfce4-panel:clock [2023/01/12 11:02] – [Label and Tooltip Markup] GDateTime restrictions gael | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Clock ====== | + | ~~NOTOC~~ |
+ | {{ : | ||
+ | ====== | ||
- | The //Clock// panel plugin displays the current time in a variety of styles and formats. | + | The Clock panel plugin displays the current time in a variety of styles and formats, and allows for custom tooltips to appear on hover. It also provides a basic calendar that appears when clicked. |
- | ====== Properties ====== | + | * **[[#Time Settings|Time Settings]]** |
+ | * **[[# | ||
+ | * **[[#Clock Options|Clock Options]]** | ||
+ | * **[[#Label and Tooltip Markup|Label and Tooltip Markup]]** | ||
+ | * **[[#Hidden Settings|Hidden Settings]]** | ||
- | <figure " | + | ---- |
- | {{: | + | |
- | </ | + | |
- | ===== Appearance | + | ===== Preferences |
- | ? Tooltip Format | + | <figure "Clock Preferences"> |
- | ! Changes how the time is displayed when hovering over the clock display. | + | |
- | ? Show Frame | + | ---- |
- | ! Displays | + | |
+ | ===== Time Settings ===== | ||
+ | ? Timezone | ||
+ | ! Allows you to set a custom timezone for the clock by entering the name of a file in the zoneinfo database. If left blank, | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== Calendar ===== | ||
+ | ? Command | ||
+ | ! Allows you to set a custom command for the calendar window instead of the default GTK calendar. A possible choice if you use [[https:// | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== Appearance ===== | ||
? Layout | ? Layout | ||
- | | + | |
- | ! Displays | + | ! Displays a round, analogue |
- | ? Binary | + | ? Binary |
- | ! Displays a binary | + | ! Displays a grid with highlighted tiles depicting the time in binary. |
- | ? Digital | + | ? Digital |
- | ! A simple | + | ! Displays the time digitally. |
- | ? Fuzzy | + | ? Fuzzy |
- | ! Displays | + | ! Displays the time as words rather than using numbers. |
- | ? LCD | + | ? LCD |
- | ! Displays the time in the style of a digital | + | ! Displays the time in the style of an LCD clock. |
+ | |||
+ | ? Tooltip format | ||
+ | ! Changes the format of the time that gets displayed in the tooltip when hovering over the clock plugin. | ||
+ | |||
+ | [[|Back to Top]] | ||
+ | ---- | ||
===== Clock Options ===== | ===== Clock Options ===== | ||
+ | The options available will vary depending on the clock {gui> | ||
- | <note tip>The options available in //Clock Options// will vary depending | + | ^ Analogue ^^ |
+ | | Display seconds | Displays the seconds hand on the clock face | | ||
- | ? 24-hour Clock | + | ^ Binary ^^ |
- | ! Displays time in a 24-hour (military) format. ({gui> | + | | Binary mode | Decimal, Sexagesimal or Binary time, see https://en.wikipedia.org/w/index.php?title=Binary_clock& |
- | ? Display Seconds | + | | Display seconds | Displays seconds on the clock | |
- | ! Displays a seconds indicator in the clock display. ({gui> | + | | Show Inactive Dots | Show empty dots | |
- | ? Flash Time Seperators | + | | Show grid | Adds gridlines to the clock | |
- | ! Flash the seperators between digits. ({gui> | + | |
- | ? Format | + | |
- | ! Changes the time format of the clock with predefined or custom layout. ({gui> | + | |
- | ? Fuzziness | + | |
- | ! Changes the degree of ' | + | |
- | ? Show AM/PM | + | |
- | ! Displays an ' | + | |
- | ? Show Grid | + | |
- | ! Adds gridlines to the clock. ({gui> | + | |
- | ? Show Inactive Dots | + | |
- | ! All dots that are empty are not shown in the clock display. ({gui> | + | |
- | ? True Binary Clock | + | |
- | ! Displays a seconds indicator in the clock display. ({gui> | + | |
- | ===== Label and Tooltip Markup ===== | + | ^ Digital ^^ |
+ | | Layout | Choose the layout you want. To display time and date on the same line, use "Date only" or "Time only" and a custom format: {{: | ||
+ | | Font | The font that applies globally to the format selected below | | ||
+ | | Format | Format in which time and date are displayed with a predefined or custom format. Fonts entered here take precedence over the one selected above since 4.18.1. | | ||
- | The plugin supports markup to change | + | ^ Fuzzy ^^ |
+ | | Fuzziness | Changes | ||
- | %R%n< | + | ^ LCD ^^ |
+ | | Display seconds | Displays a seconds indicator on the clock | | ||
+ | | 24-hour clock | Displays time in a 24-hour (military) format | | ||
+ | | Flash time separators | Flash the separators between digits every second | | ||
+ | | Show AM/PM | Displays an ' | ||
+ | |||
+ | [[|Back to Top]] | ||
+ | ---- | ||
+ | |||
+ | ===== Label and Tooltip Markup ===== | ||
- | Additionally '' | + | The plugin supports markup to change the layout of the tooltip |
- | The following is a list of available label format control sequences copied from a '' | + | The following is a list of available label format control sequences copied from a '' |
^ Symbol | ^ Symbol | ||
Line 69: | Line 94: | ||
| %C | century; like %Y, except omit last two digits (e.g., 21) | | | %C | century; like %Y, except omit last two digits (e.g., 21) | | ||
| %d | day of month (e.g, 01) | | | %d | day of month (e.g, 01) | | ||
- | | %D | date; same as %m/%d/%y | | ||
| %e | day of month, space padded; same as %_d | | | %e | day of month, space padded; same as %_d | | ||
| %F | full date; same as %Y-%m-%d | | | %F | full date; same as %Y-%m-%d | | ||
Line 83: | Line 107: | ||
| %M | minute (00..59) | | | %M | minute (00..59) | | ||
| %n | a newline | | | %n | a newline | | ||
- | | %N | nanoseconds (000000000..999999999) | | ||
| %p | locale' | | %p | locale' | ||
| %P | like %p, but lower case | | | %P | like %p, but lower case | | ||
Line 93: | Line 116: | ||
| %T | time; same as %H:%M:%S | | | %T | time; same as %H:%M:%S | | ||
| %u | day of week (1..7); 1 is Monday | | | %u | day of week (1..7); 1 is Monday | | ||
- | | %U | week number of year, with Sunday as first day of week (00..53) | | ||
| %V | ISO week number, with Monday as first day of week (01..53) | | | %V | ISO week number, with Monday as first day of week (01..53) | | ||
| %w | day of week (0..6); 0 is Sunday | | | %w | day of week (0..6); 0 is Sunday | | ||
- | | %W | week number of year, with Monday as first day of week (00..53) | | ||
| %x | locale' | | %x | locale' | ||
| %X | locale' | | %X | locale' | ||
Line 107: | Line 128: | ||
| %Z | alphabetic time zone abbreviation (e.g., EDT) | | | %Z | alphabetic time zone abbreviation (e.g., EDT) | | ||
- | By default, numeric fields are padded with zeroes. The following optional flags may follow '' | + | By default, numeric fields are padded with 0's. The following optional flags may follow '' |
^ Flag ^ Meaning | ^ Flag ^ Meaning | ||
+ | | O (uppercase " | ||
| - (hyphen) | do not pad the field | | | - (hyphen) | do not pad the field | | ||
| _ (underscore) | pad with spaces | | | _ (underscore) | pad with spaces | | ||
| 0 (zero) | pad with zeros | | | 0 (zero) | pad with zeros | | ||
- | | < | ||
- | | # | use opposite case if possible | | ||
- | After any flags comes an optional field width, as a decimal number; then an optional modifier, which is either '' | ||
+ | [[|Back To Top]] | ||
+ | ---- | ||
+ | |||
+ | ===== Hidden Settings ===== | ||
+ | These hidden settings can be manually created using the xfce4-settings-editor and must be created as children of the " | ||
+ | |||
+ | ? | ||
+ | |||
+ | The default time-config-tool is " | ||
+ | |||
+ | You can use this one-liner to create the property: | ||
+ | < | ||
+ | Change APP_TO_RUN to the name of the custom tool that you want to use. | ||
+ | |||
+ | [[|Back To Top]] | ||
+ | ---- | ||
+ | [[ : |