- NAME
-
- gcloud alpha topic datetimes - date/time input format supplementary help
- DESCRIPTION
-
(ALPHA)gcloudcommand 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 leadingPis 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 datetimesgcloud beta topic datetimes
gcloud alpha topic datetimes
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.
