From 746f4106b377d450bef998f42b067d92960d00ea Mon Sep 17 00:00:00 2001 From: htcfreek <61519853+htcfreek@users.noreply.github.com> Date: Fri, 7 Mar 2025 12:47:46 +0100 Subject: [PATCH 1/7] update PT run doc --- hub/powertoys/run.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/hub/powertoys/run.md b/hub/powertoys/run.md index 3a4ccb5f02..df96cc7c5d 100644 --- a/hub/powertoys/run.md +++ b/hub/powertoys/run.md @@ -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] @@ -240,6 +240,21 @@ 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 has a setting were you can define custom formats. The setting is a multiline text box were you have ta add one format per line. +The syntax is `=` for using the local time and `=UTC:` for using the Universal Time Convention (UTC). +Supported are all [standard patterns](https://learn.microsoft.com/dotnet/standard/base-types/custom-date-and-time-format-strings) and the following ones: +- `DOW`: Number of the day in the week. +- `WOM`: Number of week in the month. +- `WOY`: Number of the week in the year. +- `EAB`: Era abbreviation. +- `WFT`: Windows file time. +- `UXT`: Unix time stamp. +- `UMS`: Unix time stamp in milliseconds. +- `OAD`: OLE Automation date. +- `EXC`: Excel's 1900 based date value. +- `EXF`: Excel's 1904 based date value. + ### Unit converter plugin > [!IMPORTANT] From ff285ad26f8f46bd6e223a2b172ee7bd8298e9c2 Mon Sep 17 00:00:00 2001 From: Heiko <61519853+htcfreek@users.noreply.github.com> Date: Sat, 8 Mar 2025 13:17:09 +0100 Subject: [PATCH 2/7] Update hub/powertoys/run.md Co-authored-by: Alvin Ashcraft <73072+alvinashcraft@users.noreply.github.com> --- hub/powertoys/run.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hub/powertoys/run.md b/hub/powertoys/run.md index df96cc7c5d..d4b37898d2 100644 --- a/hub/powertoys/run.md +++ b/hub/powertoys/run.md @@ -241,7 +241,7 @@ Examples: - `) 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 has a setting were you can define custom formats. The setting is a multiline text box were you have ta add one format per line. +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. The syntax is `=` for using the local time and `=UTC:` for using the Universal Time Convention (UTC). Supported are all [standard patterns](https://learn.microsoft.com/dotnet/standard/base-types/custom-date-and-time-format-strings) and the following ones: - `DOW`: Number of the day in the week. From cbc5e8eb21be6329b16d75c6abb59193686975a8 Mon Sep 17 00:00:00 2001 From: Heiko <61519853+htcfreek@users.noreply.github.com> Date: Sat, 8 Mar 2025 13:17:36 +0100 Subject: [PATCH 3/7] Update hub/powertoys/run.md Co-authored-by: Alvin Ashcraft <73072+alvinashcraft@users.noreply.github.com> --- hub/powertoys/run.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/hub/powertoys/run.md b/hub/powertoys/run.md index d4b37898d2..2f2a1e3d2c 100644 --- a/hub/powertoys/run.md +++ b/hub/powertoys/run.md @@ -243,7 +243,8 @@ Examples: #### 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. The syntax is `=` for using the local time and `=UTC:` for using the Universal Time Convention (UTC). -Supported are all [standard patterns](https://learn.microsoft.com/dotnet/standard/base-types/custom-date-and-time-format-strings) and the following ones: +The supported formats include all [standard patterns](https://learn.microsoft.com/dotnet/standard/base-types/custom-date-and-time-format-strings) and the following: + - `DOW`: Number of the day in the week. - `WOM`: Number of week in the month. - `WOY`: Number of the week in the year. From 2bcfa8433731252d3b4292d753ab0747b8a3e6ca Mon Sep 17 00:00:00 2001 From: htcfreek <61519853+htcfreek@users.noreply.github.com> Date: Sat, 8 Mar 2025 14:01:35 +0100 Subject: [PATCH 4/7] changes --- hub/powertoys/run.md | 46 +++++++++++++++++++++++++++++++------------- 1 file changed, 33 insertions(+), 13 deletions(-) diff --git a/hub/powertoys/run.md b/hub/powertoys/run.md index 2f2a1e3d2c..d56bb13357 100644 --- a/hub/powertoys/run.md +++ b/hub/powertoys/run.md @@ -242,19 +242,39 @@ Examples: #### 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. -The syntax is `=` for using the local time and `=UTC:` for using the Universal Time Convention (UTC). -The supported formats include all [standard patterns](https://learn.microsoft.com/dotnet/standard/base-types/custom-date-and-time-format-strings) and the following: - -- `DOW`: Number of the day in the week. -- `WOM`: Number of week in the month. -- `WOY`: Number of the week in the year. -- `EAB`: Era abbreviation. -- `WFT`: Windows file time. -- `UXT`: Unix time stamp. -- `UMS`: Unix time stamp in milliseconds. -- `OAD`: OLE Automation date. -- `EXC`: Excel's 1900 based date value. -- `EXF`: Excel's 1904 based date value. + +**Please use the following syntax:** + +- `=` for using the local time. +- `=UTC:` 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](https://learn.microsoft.com/dotnet/standard/base-types/custom-date-and-time-format-strings) for more information. +| `DOW`| Number of the day in the week. | +| `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 number. | +| `EXC`| Excel's 1900 based date value as number. | +| `EXF`| Excel's 1904 based date value as number. | + ### Unit converter plugin From aeb81e6eaa461e5deb57bbc2ac894481ba1c7c21 Mon Sep 17 00:00:00 2001 From: htcfreek <61519853+htcfreek@users.noreply.github.com> Date: Sat, 8 Mar 2025 14:06:57 +0100 Subject: [PATCH 5/7] fix typo --- hub/powertoys/run.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hub/powertoys/run.md b/hub/powertoys/run.md index d56bb13357..8afe601d74 100644 --- a/hub/powertoys/run.md +++ b/hub/powertoys/run.md @@ -271,7 +271,7 @@ The plugin includes a setting where custom formats can be defined. Custom format | `WFT`| Windows file time as number. | | `UXT`| Unix time stamp as number. | | `UMS`| Unix time stamp in milliseconds as number. | -| `OAD`| OLE Automation date 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. | From abbc6292cdb274ffc73b76193c75cc688e5ebd93 Mon Sep 17 00:00:00 2001 From: htcfreek <61519853+htcfreek@users.noreply.github.com> Date: Tue, 11 Mar 2025 14:01:44 +0100 Subject: [PATCH 6/7] update link --- hub/powertoys/run.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/hub/powertoys/run.md b/hub/powertoys/run.md index 8afe601d74..a896ab5952 100644 --- a/hub/powertoys/run.md +++ b/hub/powertoys/run.md @@ -241,6 +241,7 @@ Examples: - `) 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:** @@ -258,12 +259,11 @@ The plugin includes a setting where custom formats can be defined. Custom format - `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](https://learn.microsoft.com/dotnet/standard/base-types/custom-date-and-time-format-strings) for more information. +| 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. | | `WOM`| Number of week in the month. | | `WOY`| Number of the week in the year. | @@ -275,7 +275,6 @@ The plugin includes a setting where custom formats can be defined. Custom format | `EXC`| Excel's 1900 based date value as number. | | `EXF`| Excel's 1904 based date value as number. | - ### Unit converter plugin > [!IMPORTANT] From b81ec43197f088305515c400afb174b7803e89f0 Mon Sep 17 00:00:00 2001 From: htcfreek <61519853+htcfreek@users.noreply.github.com> Date: Thu, 27 Mar 2025 18:36:46 +0100 Subject: [PATCH 7/7] update docs --- hub/powertoys/run.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/hub/powertoys/run.md b/hub/powertoys/run.md index a896ab5952..15198d6ffb 100644 --- a/hub/powertoys/run.md +++ b/hub/powertoys/run.md @@ -264,16 +264,17 @@ The plugin includes a setting where custom formats can be defined. Custom format | 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. | -| `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. | +| `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