誕生日などのように、カレンダーの日付全体またはその一部を表します。時間帯とタイムゾーンは、他の場所で指定されているか、重要ではありません。日付はグレゴリオ暦を基準にしています。これは次のいずれかを表します。
- ゼロ以外の年、月、日の値を含む完全な日付
- 記念日など、年がゼロである月と日の値
- 月と日の値がゼロである単独の年
- クレジット カードの有効期限など、日がゼロである年と月の値
関連する型は、google.type.TimeOfDay と google.protobuf.Timestamp です。
| JSON 表現 | |
|---|---|
| { "year": integer, "month": integer, "day": integer } | |
| フィールド | |
|---|---|
| year | 
 その日付の年。1~9999、または年のない日付を指定する場合は 0 にする必要があります。 | 
| month | 
 1 年の中の月。1~12、または月と日のない年を指定する場合は 0 にする必要があります。 | 
| day | 
 1 月の中の日付。1~31 で、その年と月に対して有効である必要があります。または、日が重要でない場合に年のみか年と月を指定するには 0 にする必要があります。 |