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 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
Domain: github.com
Links:
Viewport: width=device-width
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-profiling 0 react-import-map react,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-controller voltron_issues_fragments route-action issue_layout fetch-nonce v2:1b98a68c-6285-32c8-c293-cbe3c2eb042a current-catalog-service-hash 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 request-id DC84:332051:1F243:2B7FE:6AFD6600 html-safe-nonce 8ba7ac71f5767c3a3110f24405a39137fa61d95b847122f8f0ee237f61733b6a visitor-payload eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEQzg0OjMzMjA1MToxRjI0MzoyQjdGRTo2QUZENjYwMCIsInZpc2l0b3JfaWQiOiIxNTgxNzIxMDg5Nzk1MjUzNzYwIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= visitor-hmac 2152e23e7969f028951747c80d08611815154259ee1c72a7b2226d28f90b6f66 hovercard-subject-tag issue:668382763 github-keyboard-shortcuts repository,issues,copilot google-site-verification Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I octolytics-url https://collector.github.com/github/collect analytics-location / fb:app_id 1401488693436528 apple-itunes-app app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/PowerShell/PowerShell/13312/issue_layout twitter:image https://opengraph.githubassets.com/37aad52e1490add9f6494d8763501dded9039f3fabcadf2cd860e31063cc29d8/PowerShell/PowerShell/issues/13312 twitter:card summary_large_image og:image https://opengraph.githubassets.com/37aad52e1490add9f6494d8763501dded9039f3fabcadf2cd860e31063cc29d8/PowerShell/PowerShell/issues/13312 og:image:alt 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 og:image:width 1200 og:image:height 600 og:site_name GitHub og:type object og:author:username aetos382 hostname github.com expected-hostname github.com None 42a67d7c7488271ca8d7e6dc3942424e6de3bff43b1ed4a9c6f0e1a69b73b389 turbo-cache-control no-preview go-import github.com/PowerShell/PowerShell git https://github.com/PowerShell/PowerShell.git octolytics-dimension-user_id 11524380 octolytics-dimension-user_login PowerShell octolytics-dimension-repository_id 49609581 octolytics-dimension-repository_nwo PowerShell/PowerShell octolytics-dimension-repository_public true octolytics-dimension-repository_is_fork false octolytics-dimension-repository_network_root_id 49609581 octolytics-dimension-repository_network_root_nwo PowerShell/PowerShell turbo-body-classes logged-out env-production page-responsive disable-turbo false browser-stats-url https://api.github.com/_private/browser/stats browser-errors-url https://api.github.com/_private/browser/errors release 5c3779ac05f3590d8d7ea0c02b14e678ae8179ae ui-target full theme-color #1e2327 color-scheme light dark react-app-name issues
URLs of crawlers that visited me.