Package google.type

Index

Date

Représente une date du calendrier entière ou partielle, par exemple un anniversaire. L'heure de la journée et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. La date est donnée selon le calendrier grégorien. Il peut s'agir de l'un des éléments suivants :

  • Une date complète, avec des valeurs non nulles pour l'année, le mois et le jour.
  • un mois et un jour, avec une année nulle (par exemple, un anniversaire) ;
  • une année seule, avec un mois et un jour nuls ;
  • Une année et un mois, avec un jour zéro (par exemple, la date d'expiration d'une carte de crédit).

Types associés :

Champs
year

int32

Année de la date. Elle doit être comprise entre 1 et 9999, ou égale à 0 si vous spécifiez une date sans année.
month

int32

Mois d'une année. Il doit être compris entre 1 et 12, ou égal à 0 si vous spécifiez une année sans mois ni jour.
day

int32

Jour du mois. Il doit être compris entre 1 et 31, et valide pour l'année et le mois, ou égal à 0 si vous spécifiez une année seule, ou une année et un mois où le jour n'est pas significatif.

DateTime

Représente l'heure civile (ou parfois l'heure physique).

Ce type peut représenter une heure civile de plusieurs manières :

  • Lorsque utc_offset est défini et que time_zone ne l'est pas : une 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 : une heure civile pour un jour du calendrier dans un fuseau horaire spécifique.
  • Si ni time_zone ni utc_offset ne sont définis : une heure civile d'un jour du calendrier en heure locale.

La date est liée au calendrier grégorien proleptique.

Si l'année, le mois ou le jour sont définis sur 0, cela signifie que la valeur DateTime ne comporte pas d'année, de mois ou de jour spécifiques, respectivement.

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 l'un des cas de time_offset est défini. Envisagez d'utiliser le message Timestamp pour le temps physique. Si votre cas d'utilisation nécessite également de stocker le fuseau horaire de l'utilisateur, vous pouvez le faire dans un autre champ.

Ce type est plus flexible que ce que certaines applications peuvent souhaiter. Veillez à documenter et à valider les limites de votre application.

Champs
year

int32

Facultatif. Année de la date. Elle doit être comprise entre 1 et 9999, ou égale à 0 si vous spécifiez une date et heure sans année.
month

int32

Facultatif. Mois de l'année. Il doit être compris entre 1 et 12, ou égal à 0 si vous spécifiez une date et heure sans mois.
day

int32

Facultatif. Jour du mois. Il doit être compris entre 1 et 31, et valide pour l'année et le mois, ou égal à 0 si vous spécifiez une date et heure sans jour.
hours

int32

Facultatif. Heure de la journée au format 24 heures. Elle doit être comprise entre 0 et 23, et la valeur par défaut est 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

int32

Facultatif. Minutes de l'heure de la journée. Elle doit être comprise entre 0 et 59 (0 par défaut).
seconds

int32

Facultatif. Secondes de l'heure de la journée. Elles doivent normalement être comprises entre 0 et 59 (0 par défaut). Une API peut autoriser la valeur 60 si elle autorise les secondes intercalaires.
nanos

int32

Facultatif. Fractions de secondes en nanosecondes. La valeur doit être comprise entre 0 et 999 999 999 (0 par défaut).
Champ d'union time_offset. Facultatif. Spécifie le décalage UTC ou le fuseau horaire de DateTime. Choisissez soigneusement entre les deux, en gardant à l'esprit que les données de fuseau horaire peuvent changer à l'avenir (par exemple, si un pays modifie les dates de début et de fin de l'heure d'été, et que les DateTime futurs de la plage concernée ont déjà été stockés). Si elle est omise, la valeur DateTime est considérée comme étant en heure locale. time_offset ne peut être qu'un des éléments suivants :
utc_offset

Duration

Décalage UTC. Doit être un nombre entier de secondes, compris entre -18 heures et +18 heures. Par exemple, un décalage UTC de -4:00 serait représenté par { seconds: -14400 }.
time_zone

TimeZone

Fuseau horaire

Intervalle

Représente un intervalle de temps, encodé sous la forme d'un code temporel de début (inclusif) et d'un code temporel de fin (exclusif).

La valeur de début doit être inférieure ou égale à celle de fin. Lorsque la valeur de début est la même que la valeur de fin, l'intervalle est vide (il ne correspond à aucune durée). Lorsque les heures de début et de fin ne sont pas spécifiées, l'intervalle couvre n'importe quelle période.

Champs
start_time

Timestamp

Facultatif. Valeur de début (inclusive) de l'intervalle.

Si elle est spécifiée, un code temporel correspondant à cet intervalle devra être égal ou postérieur à l'heure de début.
end_time

Timestamp

Facultatif. Valeur de fin (exclusive) de l'intervalle.

Si elle est spécifiée, un code temporel correspondant à cet intervalle devra être antérieur à l'heure de fin.

LatLng

Objet représentant une paire latitude/longitude. Cette valeur 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

double

Latitude en degrés. Elle doit être comprise dans la plage [-90.0, +90.0].
longitude

double

Longitude en degrés. Elle doit être comprise dans la plage [-180.0, +180.0].

LocalizedText

Variante localisée d'un texte dans une langue spécifique.

Champs
text

string

Chaîne localisée dans la langue correspondant à language_code ci-dessous.
language_code

string

Code de langue BCP-47 du texte, tel que "en-US" ou "sr-Latn".

Pour en savoir plus, consultez la page http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

TimeZone

Représente un fuseau horaire de la base de données des fuseaux horaires IANA.

Champs
id

string

Fuseau horaire de la base de données des fuseaux horaires IANA. Par exemple, "America/New_York".
version

string

Facultatif. Numéro de version de la base de données des fuseaux horaires IANA. Par exemple, "2019a".