Package google.type

索引

DateTime

常用時（または物理的な時間）を表します。

この型は、次のいずれかの方法で常用時を表します。

  • utc_offset が設定され、time_zone が設定されていない場合: UTC からの特定のオフセットがある暦日の常用時。
  • time_zone が設定され、utc_offset が未設定の場合: 特定のタイムゾーンにおける暦日の常用時。
  • time_zone と utc_offset のどちらも設定されていない場合: 暦日の常用時（現地時間）。

日付は先発グレゴリオ暦を基準としています。

年、月、日が 0 の場合、DateTime はそれぞれ特定の年、月、日を持たないとみなされます。

この型は、すべての日付と時刻のフィールドが設定され、time_offset の oneof のいずれかが大文字か小文字かのいずれかに設定されている場合は、物理的な時刻を表すためにも使用できます。代わりに、Timestamp のメッセージを物理的な時間に使用することをご検討ください。ユースケースでユーザーのタイムゾーンも保存する必要がある場合は、別のフィールドで保存できます。

このタイプは、一部のアプリケーションの要件よりも柔軟性があります。アプリケーションの制限事項を必ず文書化して検証してください。

フィールド
year

int32

省略可。日付の年。1 ～ 9999 にする必要があります。年のない日時を指定する場合は 0 にします。
month

int32

省略可。月。1 ～ 12 にする必要があります。月のない日時を指定する場合は 0 にする必要があります。
day

int32

省略可。日。1 ～ 31 の値で、年と月に対して有効か、日なしの日時を指定する場合は 0 にする必要があります。
hours

int32

省略可。時間（24 時間形式）。0 ～ 23 の範囲で指定します。デフォルトは 0（午前 0 時）です。API ではビジネスの終了時間などのシナリオにおいて、値 "24:00:00" を許可することもできます。
minutes

int32

省略可。分。0 ～ 59 にする必要があります。デフォルトは 0 です。
seconds

int32

省略可。秒。通常は 0 ～ 59 にする必要があります。デフォルトは 0 です。API がうるう秒を許可する場合、値 60 が許可されます。
nanos

int32

省略可。秒の小数部分（ナノ秒単位）。0 ～ 999,999,999 の範囲で指定する必要があります。デフォルトは 0 です。
共用体フィールド time_offset。省略可。DateTime の UTC オフセットまたはタイムゾーンを指定します。タイムゾーン データは将来変更される可能性があることを考慮して慎重に選択してください（たとえば、国によって DST の開始日と終了日が変更され、影響を受ける範囲内の将来の DateTime がすでに保存されている場合など）。省略した場合、DateTime は現地時間とみなされます。time_offset は次のいずれかになります。
utc_offset

Duration

UTC オフセット。秒（-18 時間～+18 時間）で指定します。たとえば、UTC オフセットが -4:00 の場合は、{ seconds: -14400 } となります。
time_zone

TimeZone

タイムゾーン。

LatLng

緯度と経度のペアを表すオブジェクト。これは緯度を表す倍精度値と経度を表す倍精度値のペアで表現されます。特に明記されていない限り、このオブジェクトは WGS84 規格に準拠する必要があります。値は正規化範囲内で指定する必要があります。

フィールド
latitude

double

緯度（度単位）。範囲 [-90.0, +90.0] 内になければなりません。
longitude

double

経度（度単位）。範囲 [-180.0, +180.0] 内になければなりません。

TimeZone

IANA タイムゾーン データベースのタイムゾーンを表します。

フィールド
id

string

IANA タイムゾーン データベースのタイムゾーン（例: "America/New_York"）。
version

string

省略可。IANA タイムゾーン データベースのバージョン番号（例: "2019a"）。