gcloud topic datetimes

NAME
gcloud topic datetimes - date/time input format supplementary help
DESCRIPTION
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 formats
Absolute date/time input formats minimally support ISO 8601 and RFC 822 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
Relative duration date/time formats
A relative duration specifies a date/time relative to the current time. Relative durations are based on 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
Absolute duration formats
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
NOTES
These variants are also available:
gcloud alpha topic datetimes
gcloud beta topic datetimes