Index
DateTime
Représente le temps civil (ou parfois l'heure physique).
Ce type peut représenter une durée civile de l'une des manières suivantes:
- Lorsque utc_offset est défini et que time_zone n'est pas défini: heure civile d'un jour calendaire avec un décalage spécifique par rapport à l'heure UTC.
- Lorsque time_zone est défini et que utc_offset n'est pas défini: il s'agit d'une heure civile d'un jour calendaire dans un fuseau horaire spécifique.
- Lorsque les valeurs time_zone et utc_offset ne sont pas définis: heure civile d'un jour calendaire en heure locale.
La date est donnée selon le calendrier grégorien proleptique.
Si l'année, le mois ou le jour sont 0, le DateTime est considéré comme n'ayant pas respectivement une année, un mois ou un jour spécifique.
Ce type peut également être utilisé pour représenter une heure physique si tous les champs de date et d'heure sont définis, et si un cas particulier de l'élément oneof time_offset est défini. Envisagez plutôt d'utiliser le message Timestamp pour le temps physique. Si, dans votre cas d'utilisation, vous souhaitez également stocker le fuseau horaire de l'utilisateur, vous pouvez le faire dans un autre champ.
Ce type est plus flexible que certaines applications pourraient le vouloir. Veillez à documenter et à valider les limites de votre application.
| Champs | |
|---|---|
year |
Facultatif. Année de la date. La valeur doit être comprise entre 1 et 9 999, ou égale à 0 si vous spécifiez une date et une heure sans année. |
month |
Facultatif. Mois de l'année. Elle doit être comprise entre 1 et 12, ou égale à 0 si vous spécifiez une date et une heure sans mois. |
day |
Facultatif. Jour du mois. Elle doit être comprise entre 1 et 31, et valide pour l'année et le mois, ou égale à 0 si vous spécifiez une date et une heure sans jour. |
hours |
Facultatif. Heure de la journée au format 24 heures. Doit être comprise entre 0 et 23. Valeur par défaut : 0 (minuit). Une API peut choisir d'autoriser la valeur "24:00:00" pour des cas tels que l'heure de fermeture des bureaux. |
minutes |
Facultatif. Minutes de l'heure de la journée. Doit être comprise entre 0 et 59. Valeur par défaut : 0. |
seconds |
Facultatif. Secondes de l'heure de la journée. Doit normalement être compris entre 0 et 59. Valeur par défaut : 0. Une API peut autoriser la valeur 60 si elle autorise les secondes intercalaires. |
nanos |
Facultatif. Fractions de secondes en nanosecondes. Doit être comprise entre 0 et 999 999 999. Valeur par défaut : 0. |
Champ d'union time_offset. Facultatif. Spécifie soit le décalage UTC, soit le fuseau horaire de DateTime. Choisissez bien entre les deux, étant donné que les données de fuseau horaire peuvent changer à l'avenir (par exemple, un pays modifie ses dates de début et de fin d'heure d'été, et les dates et heures futures de la période concernée avaient déjà été enregistrées). Si cette valeur n'est pas spécifiée, la valeur DateTime est considérée comme exprimée en heure locale. time_offset ne peut être qu'un des éléments suivants : |
|
utc_offset |
Décalage UTC. Doit être une seconde entière, comprise entre -18 heures et +18 heures. Par exemple, un décalage UTC de -4:00 serait représenté par { seconds: -14400 }. |
time_zone |
Fuseau horaire. |
LatLng
Objet représentant une paire latitude/longitude. Elle est exprimée par une paire de doubles représentant les degrés de latitude et de longitude. Sauf indication contraire, cet objet doit être conforme à la norme WGS84. Les valeurs doivent se situer dans les limites normalisées.
| Champs | |
|---|---|
latitude |
Latitude en degrés. Elle doit être comprise dans la plage [-90.0, +90.0]. |
longitude |
Longitude en degrés. Elle doit être comprise dans la plage [-180.0, +180.0]. |
TimeZone
Représente un fuseau horaire de la base de données des fuseaux horaires IANA.
| Champs | |
|---|---|
id |
Fuseau horaire de la base de données des fuseaux horaires IANA, par exemple "America/New_York". |
version |
Facultatif. Numéro de version de la base de données des fuseaux horaires IANA, par exemple "2019a". |