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:57] – [Clock Options] 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 |
- | ^ Control Element ^^ Usage ^ | + | <figure "Clock Preferences"> |
- | | Tooltip Format | | Changes how the time is displayed when hovering over the clock display | | + | |
- | | Show Frame | | Displays a frame around the clock display | | + | |
- | | Layout | Analog | Displays time as a clock face with hands representing the current hour, minute, and seconds | | + | |
- | | | Binary | Displays a binary clock | | + | |
- | | | Digital | A simple time display with multiple formats | | + | |
- | | | Fuzzy | Displays an approximation of the current time | | + | |
- | | | LCD | Displays the time in the style of a digital LCD click | | + | |
- | ===== Clock Options ===== | + | ---- |
- | The options available | + | ===== 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, | ||
- | ^ LCD ^^ | + | ---- |
- | | 24-hour Clock | Displays time in a 24-hour (military) format | | + | |
- | | Display Seconds | Displays a seconds indicator in the clock display | | + | |
- | | Flash Time Seperators | Flash the seperators between digits | | + | |
- | | Show AM/PM | Displays an ' | + | |
- | ^ Analog | + | ===== Calendar ===== |
- | | Display | + | ? 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 | ||
+ | ? Analogue | ||
+ | ! Displays a round, analogue clock with an hour, minute and optionally second hand in the panel. | ||
+ | ? Binary | ||
+ | ! Displays a grid with highlighted tiles depicting the time in binary. | ||
+ | ? Digital | ||
+ | ! Displays the time digitally. | ||
+ | ? Fuzzy | ||
+ | ! Displays the time as words rather than using numbers. | ||
+ | ? LCD | ||
+ | ! 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 ===== | ||
+ | The options available will vary depending on the clock {gui> | ||
+ | |||
+ | ^ Analogue | ||
+ | | Display | ||
^ Binary ^^ | ^ Binary ^^ | ||
- | | Display Seconds | + | | Binary mode | Decimal, Sexagesimal or Binary time, see https:// |
- | | Show Grid | Adds gridlines to the clock | | + | | Display seconds |
- | | Show Inactive Dots | All dots that are empty are not shown in the clock display | + | | Show Inactive Dots | Show empty dots | |
- | | True Binary Clock | Displays a seconds indicator in the clock display | + | | Show grid | Adds gridlines to the clock | |
^ Digital ^^ | ^ Digital ^^ | ||
- | | Format | + | | Layout |
+ | | Font | The font that applies globally to the format selected below | | ||
+ | | Format | Format in which time and date are displayed | ||
^ Fuzzy ^^ | ^ Fuzzy ^^ | ||
- | | Fuzziness | Changes the degree of ' | + | | Fuzziness | Changes the degree of ' |
- | ===== Label and Tooltip Markup ===== | + | ^ 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 ' | ||
- | The plugin supports markup to change the layout of the tooltip and the label on the panel. Consult the [[http:// | + | [[|Back to Top]] |
+ | ---- | ||
- | %R%n< | + | ===== 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 64: | 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 78: | 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 88: | 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 102: | 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]] | ||
+ | ---- | ||
+ | [[ : |