Skip to content
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

Add UFormat specifiers table #4266

Merged
merged 2 commits into from
May 7, 2019
Merged

Add UFormat specifiers table #4266

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
da8c817
Add UFormat specifiers table
matt9ucci May 7, 2019
f2ad31d
Update Get-Date.md
sdwheeler May 7, 2019
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
150 changes: 41 additions & 109 deletions reference/3.0/Microsoft.PowerShell.Utility/Get-Date.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -485,115 +485,47 @@ Otherwise, it returns a **DateTime** object.

When you pipe a date to cmdlets that expect string input, such as the Add-Content cmdlet, Windows PowerShell converts the **DateTime** object to a string before adding it to the file. The default `ToString()` format is short date and long time. To specify an alternate format, use the `-Format` or `-UFormat` parameters of `Get-Date`.

- Uformat Values:

The following are the values of the `-UFormat` parameter. The format for the command is:

`Get-Date -UFormat %\<value\>`

For example,

`Get-Date -UFormat %d`


- Date-Time:

Date and time - full

(default) : (Friday, June 16, 2006 10:31:27 AM)

`c` : Date and time - abbreviated (Fri Jun 16 10:31:27 2006)

- Date:

`D` : Date in mm/dd/yy format (06/14/06)

`x` : Date in standard format for locale (09/12/07 for English-US)

- Year:

`C` : Century (20 for 2006)

`Y` : Year in 4-digit format (2006)

`y` : Year in 2-digit format (06)

`G` : Same as 'Y'

`g` : Same as 'y'

- Month:

`b` : Month name - abbreviated (Jan)

`B` : Month name - full (January)

`h` : Same as 'b'

`m` : Month number (06)

- Week:

`W` : Week of the year (00-52)

`V` : Week of the year (01-53)

`U` : Same as 'W'

- Day:

`a` : Day of the week - abbreviated name (Mon)

`A` : Day of the week - full name (Monday)

`u` : Day of the week - number (Monday = 1)

`d` : Day of the month - 2 digits (05)

`e` : Day of the month - digit preceded by a space ( 5)

`j` : Day of the year - (1-366)

`w` : Same as 'u'

- Time:

`p` : AM or PM

`r` : Time in 12-hour format (09:15:36 AM)

`R` : Time in 24-hour format - no seconds (17:45)

`T` : Time in 24 hour format (17:45:52)

`X` : Same as 'T'

`Z` : Time zone offset from Universal Time Coordinate (UTC) (-07)

- Hour:

`H` : Hour in 24-hour format (17)

`I` : Hour in 12 hour format (05)

`k` : Same as 'H'

`l` : Same as 'I' (Upper-case I = Lower-case L)

- Minutes & Seconds:

`M` : Minutes (35)

`S` : Seconds (05)

`s` : Seconds elapsed since January 1, 1970 00:00:00 (1150451174.95705)

- Special Characters:

`n` : newline character (\n)

`t` : Tab character (\t)

- Here are the valid **UFormat** specifiers, each of which must be preceded by `%`, for example, `Get-Date -UFormat %Y%m%d`

| Format specifier | Meaning | Example |
| ---------------- | ------- | ------- |
| A | Day of the week - full name | Monday |
| a | Day of the week - abbreviated name | Mon |
| B | Month name - full | January |
| b | Month name - abbreviated | Jan |
| C | Century | 20 for 2006 |
| c | Date and time - abbreviated | Fri Jun 16 10:31:27 2006 |
| D | Date in mm/dd/yy format | 06/14/06 |
| d | Day of the month - 2 digits | 05 |
| e | Day of the month - digit preceded by a space | \<space\>5 |
| G | Same as 'Y' | |
| g | Same as 'y' | |
| H | Hour in 24-hour format | 17 |
| h | Same as 'b' | |
| I | Hour in 12 hour format | 05 |
| j | Day of the year | 1-366 |
| k | Same as 'H' | |
| l | Same as 'I' (Upper-case I) | 05 |
| M | Minutes | 35 |
| m | Month number | 06 |
| n | newline character | |
| p | AM or PM | |
| R | Time in 24-hour format -no seconds | 17:45 |
| r | Time in 12-hour format | 09:15:36 AM |
| S | Seconds | 05 |
| s | Seconds elapsed since January 1, 1970 00:00:00 | 1150451174.95705 |
| t | Horizontal tab character | |
| T | Time in 24 hour format | 17:45:52 |
| U | Same as 'W' | |
| u | Day of the week - number | Monday = 1 |
| V | Week of the year | 01-53 |
| w | Same as 'u' | |
| W | Week of the year | 00-52 |
| X | Same as 'T' |
| x | Date in standard format for locale | 09/12/07 for English-US |
| Y | Year in 4-digit format | 2006 |
| y | Year in 2-digit format | 06 |
| Z | Time zone offset from Universal Time Coordinate (UTC) | -07 |

## Related Links

Expand Down
150 changes: 41 additions & 109 deletions reference/4.0/Microsoft.PowerShell.Utility/Get-Date.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -461,115 +461,47 @@ Otherwise, it returns a **DateTime** object.

When you pipe a date to cmdlets that expect string input, such as the Add-Content cmdlet, Windows PowerShell converts the **DateTime** object to a string before adding it to the file. The default `ToString()` format is short date and long time. To specify an alternate format, use the `-Format` or `-UFormat` parameters of `Get-Date`.

* Uformat Values:

The following are the values of the `-UFormat` parameter. The format for the command is:

`Get-Date -UFormat %\<value\>`

For example,

`Get-Date -UFormat %d`


* Date-Time:

Date and time - full

(default) : (Friday, June 16, 2006 10:31:27 AM)

`c` : Date and time - abbreviated (Fri Jun 16 10:31:27 2006)

* Date:

`D` : Date in mm/dd/yy format (06/14/06)

`x` : Date in standard format for locale (09/12/07 for English-US)

* Year:

`C` : Century (20 for 2006)

`Y` : Year in 4-digit format (2006)

`y` : Year in 2-digit format (06)

`G` : Same as 'Y'

`g` : Same as 'y'

* Month:

`b` : Month name - abbreviated (Jan)

`B` : Month name - full (January)

`h` : Same as 'b'

`m` : Month number (06)

* Week:

`W` : Week of the year (00-52)

`V` : Week of the year (01-53)

`U` : Same as 'W'

* Day:

`a` : Day of the week - abbreviated name (Mon)

`A` : Day of the week - full name (Monday)

`u` : Day of the week - number (Monday = 1)

`d` : Day of the month - 2 digits (05)

`e` : Day of the month - digit preceded by a space ( 5)

`j` : Day of the year - (1-366)

`w` : Same as 'u'

* Time:

`p` : AM or PM

`r` : Time in 12-hour format (09:15:36 AM)

`R` : Time in 24-hour format - no seconds (17:45)

`T` : Time in 24 hour format (17:45:52)

`X` : Same as 'T'

`Z` : Time zone offset from Universal Time Coordinate (UTC) (-07)

* Hour:

`H` : Hour in 24-hour format (17)

`I` : Hour in 12 hour format (05)

`k` : Same as 'H'

`l` : Same as 'I' (Upper-case I = Lower-case L)

* Minutes & Seconds:

`M` : Minutes (35)

`S` : Seconds (05)

`s` : Seconds elapsed since January 1, 1970 00:00:00 (1150451174.95705)

* Special Characters:

`n` : newline character (\n)

`t` : Tab character (\t)

* Here are the valid **UFormat** specifiers, each of which must be preceded by `%`, for example, `Get-Date -UFormat %Y%m%d`

| Format specifier | Meaning | Example |
| ---------------- | ------- | ------- |
| A | Day of the week - full name | Monday |
| a | Day of the week - abbreviated name | Mon |
| B | Month name - full | January |
| b | Month name - abbreviated | Jan |
| C | Century | 20 for 2006 |
| c | Date and time - abbreviated | Fri Jun 16 10:31:27 2006 |
| D | Date in mm/dd/yy format | 06/14/06 |
| d | Day of the month - 2 digits | 05 |
| e | Day of the month - digit preceded by a space | \<space\>5 |
| G | Same as 'Y' | |
| g | Same as 'y' | |
| H | Hour in 24-hour format | 17 |
| h | Same as 'b' | |
| I | Hour in 12 hour format | 05 |
| j | Day of the year | 1-366 |
| k | Same as 'H' | |
| l | Same as 'I' (Upper-case I) | 05 |
| M | Minutes | 35 |
| m | Month number | 06 |
| n | newline character | |
| p | AM or PM | |
| R | Time in 24-hour format -no seconds | 17:45 |
| r | Time in 12-hour format | 09:15:36 AM |
| S | Seconds | 05 |
| s | Seconds elapsed since January 1, 1970 00:00:00 | 1150451174.95705 |
| t | Horizontal tab character | |
| T | Time in 24 hour format | 17:45:52 |
| U | Same as 'W' | |
| u | Day of the week - number | Monday = 1 |
| V | Week of the year | 01-53 |
| w | Same as 'u' | |
| W | Week of the year | 00-52 |
| X | Same as 'T' |
| x | Date in standard format for locale | 09/12/07 for English-US |
| Y | Year in 4-digit format | 2006 |
| y | Year in 2-digit format | 06 |
| Z | Time zone offset from Universal Time Coordinate (UTC) | -07 |

## Related Links

Expand Down
Loading