gcloud alpha topic datetimes

NAME
gcloud alpha topic datetimes - date/time input format supplementary help
DESCRIPTION
(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 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
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