gcloud alpha topic datetimes - date/time input format supplementary help
(ALPHA) gcloud command line flags and filter expressions that expect date/time string values support common input formats. These formats fall into two main categories: absolute date/times and relative durations.
Absolute date/time input formats minimally support ISO 8601 https://en.wikipedia.org/wiki/ISO_8601 and RFC 822 https://www.ietf.org/rfc/rfc0822.txt date/times. When omitted the date/time value defaults are:
year, month, day - current value
hour, minute, second, fractional second - 0
The supported absolute date/time input formats are listed here.
ISO 8601 / RFC 3339 zulu:
2003-09-25T10:49:41.519Z 2003-09-25T10:49:41Z
ISO 8601 numeric timezone offset:
2003-09-25T10:49:41.5-0000 2003-09-25T10:49:41.5-03:00 2003-09-25T10:49:41.5+0300
ISO with omitted parts:
2003-09-25T10:49:41 2003-09-25T10:49 2003-09-25T10 2003-09-25
RFC 822:
Thu, 25 Sep 2003 10:49:41 -0300
UNIX date command, explicit timezone:
Thu Sep 25 10:36:28 EDT 2003 2003 10:36:28 EDT 25 Sep Thu
local timezone:
Thu Sep 25 10:36:28 2003
omitted parts (date parts default to the current date, time parts default to 0):
Thu Sep 25 10:36:28 Thu Sep 10:36:28 Thu 10:36:28 Thu 10:36 10:36
omitted parts with different order:
Thu Sep 25 2003 Sep 25 2003 Sep 2003 Sep 2003
ISO no separators:
20030925T104941.5-0300 20030925T104941-0300 20030925T104941 20030925T1049 20030925T10 20030925
no T separator:
20030925104941 200309251049
other date orderings:
2003-09-25 2003-Sep-25 25-Sep-2003 Sep-25-2003 09-25-2003
other date separators:
2003.Sep.25 2003/09/25 2003 Sep 25 2003 09 25
A relative duration specifies a date/time relative to the current time. Relative durations are based on ISO 8601 durations https://en.wikipedia.org/wiki/ISO_8601#Durations. They are case-insensitive and must be prefixed with +P or -P.
A fully qualified duration string contains year, month, day, hour, minute, second, and fractional second parts. Each part is a number followed by a single character suffix:
P - period (the duration designator)
Y - year
M - minute if after T or H, month otherwise
D - day
T - separates date parts from time parts
H - hour
M - minute if after T or H, month otherwise
S - second (for fractional seconds, use decimal value for seconds)
At least one part must be specified. Omitted parts default to 0.
-P1Y2M3DT4H5M6.7S +p1y2m3dT4h5m6.7s
A relative duration may be used in any context that expects a date/time string.
For example:
1 month ago: -p1m
30 minutes from now: +pt30m
2 hours and 30 minutes ago: -p2h30m
An absolute duration specifies a period of time. It has the same syntax as a relative duration except that there is no leading + or -, and the leading P is optional.
For example:
1 month: 1m
1 hour 30 minutes: 1h30m
30 minutes: t30m
This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist. These variants are also available:
$ gcloud topic datetimes
$ gcloud beta topic datetimes