kyle
/
goutils
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
goutils/cmd/utc/README

95 lines
3.5 KiB
Plaintext
Raw Normal View History

Add utc for time -> UTC conversions.
2016-06-14 21:55:04 +00:00
utc: convert times to UTC
utc converts times to UTC. If no arguments are provided, prints the
Usability fixes. + Show timezones in output to better distingush times. + Update README/usage examples. + The -h flag only prints the shorter usage message (which is more likely to fit on a single page). + A new 'help' argument displays the full help message.
2016-06-16 01:24:41 +00:00
current time in UTC. If the only argument provided is "-", utc reads
newline-separated timestamps from standard input. If the argument is
"help", it will print an extended help message with examples. If both
the input and output timezones are the same (e.g., the local time zone
is UTC), a warning message will be printed on standard error. This can
be suppressed with the -q option.
Usage: utc [-f format] [-h] [-o format] [-q] [-u] [-z zone] [time(s)...]
Add utc for time -> UTC conversions.
2016-06-14 21:55:04 +00:00
Flags:
Updating docs, add a few new features to utc.
2016-06-14 22:22:38 +00:00
-f format Go timestamp format for input times. See the Go docs
Add utc for time -> UTC conversions.
2016-06-14 21:55:04 +00:00
(e.g. https://golang.org/pkg/time/#pkg-constants)
for an explanation of this format.
Updating docs, add a few new features to utc.
2016-06-14 22:22:38 +00:00
Default value: 2006-01-02 15:04
Improved time zone check. Previously, the zone check compared time.Local and time.UTC. However, when this was tested on a machine that uses UTC locally, it became apparent that the two pointers can differ while having the same time zone. A more useful check is to look up the offsets for the time zones and compare those --- they'll return the same times.
2016-06-14 23:42:33 +00:00
-h Print this help message.
Updating docs, add a few new features to utc.
2016-06-14 22:22:38 +00:00
Usability fixes. + Show timezones in output to better distingush times. + Update README/usage examples. + The -h flag only prints the shorter usage message (which is more likely to fit on a single page). + A new 'help' argument displays the full help message.
2016-06-16 01:24:41 +00:00
-o format Go timestamp format for outputting times. It uses
the same format as the '-f' argument.
Default value: 2006-01-02 15:04 MST
Updating docs, add a few new features to utc.
2016-06-14 22:22:38 +00:00
Improved time zone check. Previously, the zone check compared time.Local and time.UTC. However, when this was tested on a machine that uses UTC locally, it became apparent that the two pointers can differ while having the same time zone. A more useful check is to look up the offsets for the time zones and compare those --- they'll return the same times.
2016-06-14 23:42:33 +00:00
-q Suppress the timezone check warning message.
Updating docs, add a few new features to utc.
2016-06-14 22:22:38 +00:00
-u Timestamps are in UTC format and should be converted
to the timezone specified by the -z argument (which
defaults to 'Local'). Note that this isn't particularly
useful with no arguments.
Add utc for time -> UTC conversions.
2016-06-14 21:55:04 +00:00
-z zone Text form of the time zone; this can be in short
time zone abbreviation (e.g. MST) or a location
Updating docs, add a few new features to utc.
2016-06-14 22:22:38 +00:00
(e.g. America/Los_Angeles). This has no effect when
printing the current time.
Default value: Local
Add utc for time -> UTC conversions.
2016-06-14 21:55:04 +00:00
Examples (note that the examples are done in the America/Los_Angeles /
PST8PDT time zone):
+ Getting the current time in UTC:
$ utc
Usability fixes. + Show timezones in output to better distingush times. + Update README/usage examples. + The -h flag only prints the shorter usage message (which is more likely to fit on a single page). + A new 'help' argument displays the full help message.
2016-06-16 01:24:41 +00:00
2016-06-14 14:30 PDT = 2016-06-14 21:30 UTC
Add utc for time -> UTC conversions.
2016-06-14 21:55:04 +00:00
+ Converting a local timestamp to UTC:
$ utc '2016-06-14 21:30'
Usability fixes. + Show timezones in output to better distingush times. + Update README/usage examples. + The -h flag only prints the shorter usage message (which is more likely to fit on a single page). + A new 'help' argument displays the full help message.
2016-06-16 01:24:41 +00:00
2016-06-14 21:30 PDT = 2016-06-15 04:30 UTC
Add utc for time -> UTC conversions.
2016-06-14 21:55:04 +00:00
+ Converting a local EST timestamp to UTC (on a machine set to
PST8PDT):
$ utc -z EST '2016-06-14 21:30'
Usability fixes. + Show timezones in output to better distingush times. + Update README/usage examples. + The -h flag only prints the shorter usage message (which is more likely to fit on a single page). + A new 'help' argument displays the full help message.
2016-06-16 01:24:41 +00:00
2016-06-14 21:30 EST = 2016-06-15 02:30 UTC
Add utc for time -> UTC conversions.
2016-06-14 21:55:04 +00:00
+ Converting timestamps in the form '14-06-2016 3:04PM':
$ utc -f '02-01-2006 3:04PM' '14-06-2016 9:30PM'
Usability fixes. + Show timezones in output to better distingush times. + Update README/usage examples. + The -h flag only prints the shorter usage message (which is more likely to fit on a single page). + A new 'help' argument displays the full help message.
2016-06-16 01:24:41 +00:00
2016-06-14 21:30 PDT = 2016-06-15 04:30 UTC
Add utc for time -> UTC conversions.
2016-06-14 21:55:04 +00:00
+ Converting timestamps from standard input:
$ printf "2016-06-14 14:42\n2016-06-13 11:01" | utc -
Usability fixes. + Show timezones in output to better distingush times. + Update README/usage examples. + The -h flag only prints the shorter usage message (which is more likely to fit on a single page). + A new 'help' argument displays the full help message.
2016-06-16 01:24:41 +00:00
2016-06-14 14:42 PDT = 2016-06-14 21:42 UTC
2016-06-13 11:01 PDT = 2016-06-13 18:01 UTC
Add utc for time -> UTC conversions.
2016-06-14 21:55:04 +00:00
+ Converting a UTC timestamp to the local time zone:
$ utc -u '2016-06-14 21:30'
Usability fixes. + Show timezones in output to better distingush times. + Update README/usage examples. + The -h flag only prints the shorter usage message (which is more likely to fit on a single page). + A new 'help' argument displays the full help message.
2016-06-16 01:24:41 +00:00
2016-06-14 21:30 UTC = 2016-06-14 14:30 PDT
Add utc for time -> UTC conversions.
2016-06-14 21:55:04 +00:00
+ Converting a UTC timestamp to EST (on a machine set to
PST8PDT):
$ utc -u -z EST '2016-06-14 21:30'
Usability fixes. + Show timezones in output to better distingush times. + Update README/usage examples. + The -h flag only prints the shorter usage message (which is more likely to fit on a single page). + A new 'help' argument displays the full help message.
2016-06-16 01:24:41 +00:00
2016-06-14 21:30 UTC = 2016-06-14 16:30 EST
Updating docs, add a few new features to utc.
2016-06-14 22:22:38 +00:00
+ Using a different output format:
Usability fixes. + Show timezones in output to better distingush times. + Update README/usage examples. + The -h flag only prints the shorter usage message (which is more likely to fit on a single page). + A new 'help' argument displays the full help message.
2016-06-16 01:24:41 +00:00
$ utc -o '2006-01-02T15:03:04-0700' '2016-06-14 21:30'
2016-06-14T21:09:30-0700 = 2016-06-15T04:04:30+0000
Improved time zone check. Previously, the zone check compared time.Local and time.UTC. However, when this was tested on a machine that uses UTC locally, it became apparent that the two pointers can differ while having the same time zone. A more useful check is to look up the offsets for the time zones and compare those --- they'll return the same times.
2016-06-14 23:42:33 +00:00
+ Example of the warning message when running utc on a machine
where the local time zone is UTC:
$ utc
==================================================================
Note: both input and output timezone offsets are the same --- this
program may not do what you expect it to.
(Converting from UTC (offset +0000) to UTC (offset +0000).)
==================================================================
2016-06-14 23:44 = 2016-06-14 23:44
+ Example of the warning message when running utc on a machine
where the local time zone is GMT:
$ utc
==================================================================
Note: both input and output timezone offsets are the same --- this
program may not do what you expect it to.
(Converting from GMT (offset +0000) to UTC (offset +0000).)
==================================================================
2016-06-14 23:46 = 2016-06-14 23:46
Usability fixes. + Show timezones in output to better distingush times. + Update README/usage examples. + The -h flag only prints the shorter usage message (which is more likely to fit on a single page). + A new 'help' argument displays the full help message.
2016-06-16 01:24:41 +00:00