- 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 leadingP
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
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 2024-02-06 UTC.
[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]
{
"last_modified": "Last updated 2024-02-06 UTC.",
"state": ""
}