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 オフセットまたはタイムゾーンを指定します。タイムゾーン データが将来変更される可能性があることを考慮して、慎重に選択してください（たとえば、ある国で夏時間の開始日または終了日が変更され、影響を受ける期間の将来の DateTime がすでに保存されている場合など）。省略した場合、DateTime はローカル時間とみなされます。time_offset は次のいずれかになります。
utc_offset

Duration

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

TimeZone

タイムゾーン。

TimeOfDay

1 日のうちの時刻を表します。日付とタイムゾーンは重要ではないか、他の場所で指定されています。API は、うるう秒を許可するようにできます。関連する型は、google.type.Date と google.protobuf.Timestamp です。

フィールド
hours

int32

24 時間形式の時間。0 以上の値を指定してください。通常は 23 以下にする必要があります。API ではビジネスの終了時間などのシナリオにおいて、値 "24:00:00" を許可することもできます。
minutes

int32

分。0 以上 59 以下にする必要があります。
seconds

int32

1 分の秒数。0 以上で、通常は 59 以下にする必要があります。API がうるう秒を許可する場合、値 60 が許可されます。
nanos

int32

秒の小数点以下（ナノ秒単位）。0 以上 999,999,999 以下にする必要があります。

TimeZone

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

フィールド
id

string

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

string

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