nushell/docs/commands/into_datetime.md
JT 8c0a2d3c15
Auto-generate markdown command docs (#4451)
* Finish updating

* a couple improvements

* Update renames

* cleanup examples
2022-02-13 21:22:51 -05:00

1.1 KiB

title layout version
into datetime command 0.59.0

converts text into datetime

Signature

> into datetime ...rest --list --timezone --offset --format

Parameters

  • ...rest: optionally convert text into datetime by column paths
  • --list: lists strftime cheatsheet
  • --timezone {string}: Specify timezone if the input is timestamp, like 'UTC/u' or 'LOCAL/l'
  • --offset {int}: Specify timezone by offset if the input is timestamp, like '+8', '-4', prior than timezone
  • --format {string}: Specify date and time formatting

Examples

Convert to datetime

> '16.11.1984 8:00 am +0000' | into datetime

Convert to datetime

> '2020-08-04T16:39:18+00:00' | into datetime

Convert to datetime using a custom format

> '20200904_163918+0000' | into datetime -f '%Y%m%d_%H%M%S%z'

Convert timestamp (no larger than 8e+12) to datetime using a specified timezone

> '1614434140' | into datetime -z 'UTC'

Convert timestamp (no larger than 8e+12) to datetime using a specified timezone offset (between -12 and 12)

> '1614434140' | into datetime -o +9