René's URL Explorer Experiment


Title: Add timezone/offset related parameters to the Get-Date command · Issue #13312 · PowerShell/PowerShell · GitHub

Open Graph Title: Add timezone/offset related parameters to the Get-Date command · Issue #13312 · PowerShell/PowerShell

X Title: Add timezone/offset related parameters to the Get-Date command · Issue #13312 · PowerShell/PowerShell

Description: Summary of the new feature/enhancement I propose to add parameters to the Get-Date command that allows specifying the time difference of the value to be output. For example: Get-Date [-Date ] [-TimeZone

Open Graph Description: Summary of the new feature/enhancement I propose to add parameters to the Get-Date command that allows specifying the time difference of the value to be output. For example: Get-Date [-Date

X Description: Summary of the new feature/enhancement I propose to add parameters to the Get-Date command that allows specifying the time difference of the value to be output. For example: Get-Date [-Date <Dat...

Opengraph URL: https://github.com/PowerShell/PowerShell/issues/13312

X: @github

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Add timezone/offset related parameters to the Get-Date command","articleBody":"## Summary of the new feature/enhancement\r\n\r\nI propose to add parameters to the `Get-Date` command that allows specifying the time difference of the value to be output.\r\n\r\nFor example:\r\n\r\n```powershell\r\nGet-Date [-Date \u003cDateTime | DateTimeOffset>] [-TimeZone \u003cTimeZoneInfo>] ...\r\n```\r\n\r\n```powershell\r\nGet-Date [-Date \u003cDateTime | DateTimeOffset>] [-Offset \u003cTimeSpan>] ...\r\n```\r\n\r\nIf these parameters are specified, the value to be output will be [DateTimeOffset](https://docs.microsoft.com/en-us/dotnet/api/system.datetimeoffset).\r\n\r\n### Date\r\nExtend this parameter to accept `DateTimeOffset`.\r\n\r\n### TimeZone\r\nSpecify the time zone of the output.\r\nThis parameter can take the [TimeZoneInfo](https://docs.microsoft.com/en-us/dotnet/api/system.timezoneinfo) object as well as its [ID](https://docs.microsoft.com/en-us/dotnet/api/system.timezoneinfo.id).\r\nAnd it accepts `UTC` and `Local` as special values.\r\n\r\nFor example:\r\n\r\n```powershell\r\nGet-Date -TimeZone (Get-TimeZone)\r\n```\r\n\r\n```powershell\r\nGet-Date -Date '2020-08-01T10:00:00-07:00' -TimeZone 'Asia/Tokyo'\r\n```\r\n\r\n```powershell\r\nGet-Date -TimeZone UTC\r\n```\r\n\r\n### Offset\r\nSpecifies the offset of time from UTC of the value to be output.\r\n\r\nFor example:\r\n```powershell\r\nGet-Date -Offset ([TimeSpan]::FromHours(-8))\r\n```\r\n\r\n```powershell\r\nGet-Date -Offset '-8:00'\r\n```\r\n\r\n## Usecase examples\r\nThe following example shows how to convert the time expressed in the US local time to time in Japan.\r\n\r\n```powershell\r\nGet-Date -Date '2020-08-01 10:00' -TimeZone 'America/Los_Angels' | Get-Date -TimeZone 'Asia/Tokyo' -Format f\r\n```\r\n\r\n```output\r\nSunday, August 2, 2020 2:00 PM\r\n```\r\n\r\n## Related proposals\r\n#11731 suggests adding `-AsLocal` parameter. The `-AsLocal` switch is equivalent to `-TimeZone Local`.\r\nThe `-TimeZone` parameter covers the functionality of the `-AsUTC`, `-AsLocal`, and `-AsKind` parameters, and more widely.\r\n\r\nI believe that using `DateTimeOffset` is preferable to using `DateTime` and `DateTimeKind`.\r\n\r\n## Proposed technical implementation details\r\n\r\n### Type of the `-Date` parameter\r\nThe `-Date` parameter must accept `DateTime`, `DateTimeOffset` and `Int64`.\r\nSince there is no existing type that satisfies these requirements, we need to change the type of the `-Date` parameter to a custom type such as the following.\r\n\r\n```cs\r\npublic readonly struct DateInput\r\n{\r\n    public DateInput(DateTime dateTime) {}\r\n    \r\n    public DateInput(DateTimeOffset dateTimeOffset) {}\r\n\r\n    public DateInput(long tick) {}\r\n}\r\n```\r\n\r\n### Converting time zone ID to `TimeZoneInfo` object\r\n`TimeZoneInfo` cannot be implicitly converted from a string representing its ID.\r\nWe can create a custom type for the `-TimeZone` parameter as described above, or create an attribute derived from the [ArgentTransformationAttribute](https://docs.microsoft.com/en-us/dotnet/api/system.management.automation.argumenttransformationattribute) and assign it to `-TimeZone` parameter.\r\n\r\n## Considerations\r\n\r\n### Platform dependence of time zone ID\r\nThe [TimeZoneInfo.FindSystemTimeZoneById method](https://docs.microsoft.com/en-us/dotnet/api/system.timezoneinfo.findsystemtimezonebyid) supports different time zone ID formats, depending on the platform.\r\nFor example, 'Pacific Standard Time' on Windows, 'America/Los_Angeles' on Linux.\r\n\r\nWe need to consider whether the parameter `-TimeZone` should be platform-independent and should be able to take the same value.\r\nBy using a library like [TimeZoneConverter](https://github.com/mj1856/TimeZoneConverter), we can make it platform-independent.\r\n\r\n### Abbreviations for time zone\r\nFor example, a format like '10:00 AM PDT' is used to describe the start time of a webinar or system maintenance.\r\nAbbreviations for time zones such as 'PDT' are widely used, but are not specified in official specifications such as ISO 8601 and are ambiguous.\r\nI think it would be useful if the `-TimeZone` parameter could accept such abbreviations, but should we support this?\r\n\r\n### Removing an `-AsUTC` parameter\r\nConsider removing the `-AsUTC` parameter because its functionality is superseded by `-TimeZone UTC`.\r\nThis parameter was added in the 7.1 preview release and is not yet generally available.\r\n\r\n### Default format for `DateTimeOffset`\r\nCurrently, the default output for `DateTimeOffset` is in the following format:\r\n\r\n```output\r\nDateTime      : 7/29/2020 10:31:25 PM\r\nUtcDateTime   : 7/30/2020 5:31:25 AM\r\nLocalDateTime : 7/29/2020 10:31:25 PM\r\nDate          : 7/29/2020 12:00:00 AM\r\nDay           : 29\r\nDayOfWeek     : Wednesday\r\nDayOfYear     : 211\r\nHour          : 22\r\nMillisecond   : 54\r\nMinute        : 31\r\nMonth         : 7\r\nOffset        : -07:00:00\r\nSecond        : 25\r\nTicks         : 637316586850545851\r\nUtcTicks      : 637316838850545851\r\nTimeOfDay     : 22:31:25.0545851\r\nYear          : 2020\r\n```\r\n\r\nOutput in the following format, like DateTime, will be easier to read.\r\n\r\n```output\r\nWednesday, July 29, 2020 10:31:25 PM (UTC -07:00)\r\n```","author":{"url":"https://github.com/aetos382","@type":"Person","name":"aetos382"},"datePublished":"2020-07-30T05:24:12Z","url":"https://github.com/PowerShell/PowerShell/issues/13312"}

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format)
route-controllervoltron_issues_fragments
route-actionissue_layout
fetch-noncev2:1b98a68c-6285-32c8-c293-cbe3c2eb042a
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-idDC84:332051:1F243:2B7FE:6AFD6600
html-safe-nonce8ba7ac71f5767c3a3110f24405a39137fa61d95b847122f8f0ee237f61733b6a
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEQzg0OjMzMjA1MToxRjI0MzoyQjdGRTo2QUZENjYwMCIsInZpc2l0b3JfaWQiOiIxNTgxNzIxMDg5Nzk1MjUzNzYwIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=
visitor-hmac2152e23e7969f028951747c80d08611815154259ee1c72a7b2226d28f90b6f66
hovercard-subject-tagissue:668382763
github-keyboard-shortcutsrepository,issues,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/issues_fragments/issue_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/PowerShell/PowerShell/13312/issue_layout
twitter:imagehttps://opengraph.githubassets.com/37aad52e1490add9f6494d8763501dded9039f3fabcadf2cd860e31063cc29d8/PowerShell/PowerShell/issues/13312
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/37aad52e1490add9f6494d8763501dded9039f3fabcadf2cd860e31063cc29d8/PowerShell/PowerShell/issues/13312
og:image:altSummary of the new feature/enhancement I propose to add parameters to the Get-Date command that allows specifying the time difference of the value to be output. For example: Get-Date [-Date
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernameaetos382
hostnamegithub.com
expected-hostnamegithub.com
None42a67d7c7488271ca8d7e6dc3942424e6de3bff43b1ed4a9c6f0e1a69b73b389
turbo-cache-controlno-preview
go-importgithub.com/PowerShell/PowerShell git https://github.com/PowerShell/PowerShell.git
octolytics-dimension-user_id11524380
octolytics-dimension-user_loginPowerShell
octolytics-dimension-repository_id49609581
octolytics-dimension-repository_nwoPowerShell/PowerShell
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id49609581
octolytics-dimension-repository_network_root_nwoPowerShell/PowerShell
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release5c3779ac05f3590d8d7ea0c02b14e678ae8179ae
ui-targetfull
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/PowerShell/PowerShell/issues/13312#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2FPowerShell%2FPowerShell%2Fissues%2F13312
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2FPowerShell%2FPowerShell%2Fissues%2F13312
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fissues_fragments%2Fissue_layout&source=header-repo&source_repo=PowerShell%2FPowerShell
Reloadhttps://github.com/PowerShell/PowerShell/issues/13312
Reloadhttps://github.com/PowerShell/PowerShell/issues/13312
Reloadhttps://github.com/PowerShell/PowerShell/issues/13312
PowerShellhttps://github.com/PowerShell
PowerShellhttps://github.com/PowerShell/PowerShell
Codehttps://github.com/PowerShell/PowerShell
Issues1.3k (1.3k)https://github.com/PowerShell/PowerShell/issues
Pull requests365 (365)https://github.com/PowerShell/PowerShell/pulls
Discussionshttps://github.com/PowerShell/PowerShell/discussions
Actionshttps://github.com/PowerShell/PowerShell/actions
Projectshttps://github.com/PowerShell/PowerShell/projects
Security and quality3 (3)https://github.com/PowerShell/PowerShell/security
Insightshttps://github.com/PowerShell/PowerShell/insights
https://github.com/PowerShell/PowerShell
New issuehttps://github.com/login?return_to=https://github.com/PowerShell/PowerShell/issues/13312
New issuehttps://github.com/login?return_to=https://github.com/PowerShell/PowerShell/issues/13312
Add timezone/offset related parameters to the Get-Date commandhttps://github.com/PowerShell/PowerShell/issues/13312#top
Issue-Enhancementthe issue is more of a feature request than a bughttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22Issue-Enhancement%22
Resolution-No ActivityIssue has had no activity for 6 months or morehttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22Resolution-No%20Activity%22
WG-Cmdletsgeneral cmdlet issueshttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22WG-Cmdlets%22
https://github.com/aetos382
aetos (aetos382)https://github.com/aetos382
on Jul 30, 2020https://github.com/PowerShell/PowerShell/issues/13312#issue-668382763
DateTimeOffsethttps://docs.microsoft.com/en-us/dotnet/api/system.datetimeoffset
TimeZoneInfohttps://docs.microsoft.com/en-us/dotnet/api/system.timezoneinfo
IDhttps://docs.microsoft.com/en-us/dotnet/api/system.timezoneinfo.id
#11731https://github.com/PowerShell/PowerShell/issues/11731
ArgentTransformationAttributehttps://docs.microsoft.com/en-us/dotnet/api/system.management.automation.argumenttransformationattribute
TimeZoneInfo.FindSystemTimeZoneById methodhttps://docs.microsoft.com/en-us/dotnet/api/system.timezoneinfo.findsystemtimezonebyid
TimeZoneConverterhttps://github.com/mj1856/TimeZoneConverter
aetos (aetos382)https://github.com/aetos382
Issue-Enhancementthe issue is more of a feature request than a bughttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22Issue-Enhancement%22
on Jul 30, 2020https://github.com/PowerShell/PowerShell/issues/13312#event-3602062876
https://github.com/iSazonov
Ilya (iSazonov)https://github.com/iSazonov
on Jul 30, 2020https://github.com/PowerShell/PowerShell/issues/13312#issuecomment-666223515
Ilya (iSazonov)https://github.com/iSazonov
Area-Cmdlets-Utilityhttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22Area-Cmdlets-Utility%22
on Jul 30, 2020https://github.com/PowerShell/PowerShell/issues/13312#event-3602670375
https://github.com/vexx32
Rain Sallow (/u/ta11ow) (vexx32)https://github.com/vexx32
on Jul 30, 2020https://github.com/PowerShell/PowerShell/issues/13312#issuecomment-666579836
https://github.com/lukeb1961
lukeb1961https://github.com/lukeb1961
on Aug 2, 2020https://github.com/PowerShell/PowerShell/issues/13312#issuecomment-667628850
https://github.com/aetos382
aetos (aetos382)https://github.com/aetos382
on Aug 5, 2020https://github.com/PowerShell/PowerShell/issues/13312#issuecomment-668976834
https://github.com/vexx32
Rain Sallow (/u/ta11ow) (vexx32)https://github.com/vexx32
on Aug 5, 2020https://github.com/PowerShell/PowerShell/issues/13312#issuecomment-669136636
https://github.com/mklement0
Michael Klement (mklement0)https://github.com/mklement0
on Aug 5, 2020https://github.com/PowerShell/PowerShell/issues/13312#issuecomment-669162474
Rain Sallow (/u/ta11ow) (@vexx32)https://github.com/vexx32
#11731 (comment)https://github.com/PowerShell/PowerShell/issues/11731#issuecomment-659279816
https://github.com/apps/microsoft-github-policy-service
microsoft-github-policy-servicehttps://github.com/apps/microsoft-github-policy-service
on Nov 16, 2023https://github.com/PowerShell/PowerShell/issues/13312#issuecomment-1813692814
Microsoft GitHub Policy Servicehttps://aka.ms/1es-gitops
https://github.com/apps/microsoft-github-policy-service
microsoft-github-policy-servicehttps://github.com/apps/microsoft-github-policy-service
on Nov 16, 2023https://github.com/PowerShell/PowerShell/issues/13312#issuecomment-1813692815
Microsoft GitHub Policy Servicehttps://aka.ms/1es-gitops
https://github.com/apps/microsoft-github-policy-service
microsoft-github-policy-servicehttps://github.com/apps/microsoft-github-policy-service
on Nov 16, 2023https://github.com/PowerShell/PowerShell/issues/13312#issuecomment-1813692816
Microsoft GitHub Policy Servicehttps://aka.ms/1es-gitops
microsoft-github-policy-servicehttps://github.com/apps/microsoft-github-policy-service
Resolution-No ActivityIssue has had no activity for 6 months or morehttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22Resolution-No%20Activity%22
on Nov 16, 2023https://github.com/PowerShell/PowerShell/issues/13312#event-10974634108
https://github.com/apps/microsoft-github-policy-service
microsoft-github-policy-servicehttps://github.com/apps/microsoft-github-policy-service
on Nov 23, 2023https://github.com/PowerShell/PowerShell/issues/13312#issuecomment-1824262925
Microsoft GitHub Policy Servicehttps://aka.ms/1es-gitops
microsoft-github-policy-servicehttps://github.com/apps/microsoft-github-policy-service
completedhttps://github.com/PowerShell/PowerShell/issues?q=is%3Aissue%20state%3Aclosed%20archived%3Afalse%20reason%3Acompleted
on Nov 23, 2023https://github.com/PowerShell/PowerShell/issues/13312#event-11046501758
Ryan Yates (kilasuit)https://github.com/kilasuit
WG-Cmdletsgeneral cmdlet issueshttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22WG-Cmdlets%22
WG-Cmdlets-Utilityhttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22WG-Cmdlets-Utility%22
on Jul 17, 2026https://github.com/PowerShell/PowerShell/issues/13312#event-28140057131
Sign up for freehttps://github.com/signup?return_to=https://github.com/PowerShell/PowerShell/issues/13312
Sign in to commenthttps://github.com/login?return_to=https://github.com/PowerShell/PowerShell/issues/13312
Issue-Enhancementthe issue is more of a feature request than a bughttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22Issue-Enhancement%22
Resolution-No ActivityIssue has had no activity for 6 months or morehttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22Resolution-No%20Activity%22
WG-Cmdletsgeneral cmdlet issueshttps://github.com/PowerShell/PowerShell/issues?q=state%3Aopen%20label%3A%22WG-Cmdlets%22
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.