L1L`XPL0IT

✏️ Edit: datetimes.py

📁 /snap/google-cloud-cli/503/lib/surface/topic/datetimes.py

# -*- coding: utf-8 -*- #
# Copyright 2015 Google LLC. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""Date/time input format supplementary help."""

from googlecloudsdk.calliope import base

# NOTE: If the name of this topic is modified, please make sure to update all
# references to it in error messages and other help messages as there are no
# tests to catch such changes.
class DateTimes(base.TopicCommand):
  """Date/time input format supplementary help.

*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](https://en.wikipedia.org/wiki/ISO_8601) and
  [RFC 822](https://www.rfc-editor.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

### 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](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

### 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
  """

Cancel

💻 Terminal

📤 Upload

📁 /snap/google-cloud-cli/503/lib/surface/topic

//snap/google-cloud-cli/503/lib/surface/topic

Name	Size	Perm	Modified	Actions
📁 __pycache__/	-	0775	2026-09-29 12:17	🗑 Delete
__init__.py	1.2K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
accessibility.py	1.6K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
arg_files.py	7.4K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
cli_trees.py	3.1K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
client_certificate.py	4K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
command_conventions.py	7.9K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
configurations.py	4.2K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
datetimes.py	4.2K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
endpoint_override.py	2.6K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
escaping.py	3.7K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
filters.py	12.7K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
flags_file.py	3.6K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
formats.py	5K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
gcloudignore.py	5K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
offline_help.py	2.6K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
projections.py	4.5K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
resource_keys.py	3.1K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
startup.py	3.6K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del
uninstall.py	2.2K	0644	1980-01-01 08:00	👁 View ✏️ Edit 📝 Rename 📦 Move 🗑 Del