Skip to content

[Power Toys > PowerToys Run plugins] Time and Date plugin: Add docs for custom formats #5334

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 7 commits into
base: docs
Choose a base branch
from
Open

[Power Toys > PowerToys Run plugins] Time and Date plugin: Add docs for custom formats #5334

Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
746f410
update PT run doc
htcfreek Mar 7, 2025
ff285ad
Update hub/powertoys/run.md
htcfreek Mar 8, 2025
cbc5e8e
Update hub/powertoys/run.md
htcfreek Mar 8, 2025
2bcfa84
changes
htcfreek Mar 8, 2025
aeb81e6
fix typo
htcfreek Mar 8, 2025
abbc629
update link
htcfreek Mar 11, 2025
b81ec43
update docs
htcfreek Mar 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 37 additions & 1 deletion hub/powertoys/run.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: PowerToys Run utility for Windows
description: Run is a quick launcher for power users that contains additional features without sacrificing performance.
ms.date: 12/25/2024
ms.date: 03/07/2025
ms.topic: concept-article
ms.localizationpriority: medium
no-loc: [PowerToys, Windows, File Explorer, PowerToys Run, Window Walker]
Expand Down Expand Up @@ -240,6 +240,42 @@ Examples:
- `) calendar week::3/27/2022` to show the calendar week for a date value.
- `) unix epoch::3/27/2022 10:30:45 AM` to convert the given time and date value into a Unix epoch timestamp.

#### Custom formats

The plugin includes a setting where custom formats can be defined. Custom formats are entered in a multiline text box which accepts one format per line.

**Please use the following syntax:**

- `<Format name>=<Format pattern>` for using the local time.
- `<Format name>=UTC:<Format pattern>` for using the Universal Time Convention (UTC).

> [!NOTE]
> - `Format name`: Every charter except the equal sign is supported.
> - `Format pattern`: You can escape the pattern and the backslash itself as text by using a backslash as prefix.

**Examples:**

- `MyFormat=dd-MMMM-yyyy`
- `MySecondFormat=dddd (Da\y nu\mber: DOW)`
- `MyUtcFormat=UTC:hh:mm:ss`

**Supported format pattern:**

| Format pattern | Description |
| :--- | :--- |
| Standard pattern like `hh:mm:ss`. | Please see this [page](/dotnet/standard/base-types/custom-date-and-time-format-strings) for more information.
| `DOW` | Number of the day in the week. |
| `DIM` | Days in the month. |
| `WOM` | Number of week in the month. |
| `WOY` | Number of the week in the year. |
| `EAB` | Era abbreviation. |
| `WFT` | Windows file time as number. |
| `UXT` | Unix time stamp as number. |
| `UMS` | Unix time stamp in milliseconds as number. |
| `OAD` | OLE Automation date as number. |
| `EXC` | Excel's 1900 based date value as number. |
| `EXF` | Excel's 1904 based date value as number. |

### Unit converter plugin

> [!IMPORTANT]
Expand Down