Índice
Fecha
Representa una fecha de calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se especifican en otro lugar o son insignificantes. La fecha está relacionada con el calendario gregoriano. Puede representar una de las siguientes opciones:
- Una fecha completa con valores para el año, mes y día que no sean cero.
- Un mes y un día, con cero año (por ejemplo, un aniversario).
- Un año por sí solo, con un mes cero y un día cero.
- Es un año y un mes, con un día cero (por ejemplo, la fecha de vencimiento de una tarjeta de crédito).
Tipos relacionados:
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| Campos | |
|---|---|
year |
Año de la fecha. Debe ser entre 1 y 9,999, o bien 0 para especificar una fecha sin año. |
month |
Mes del año. Debe ser del 1 al 12 o 0 para especificar un año sin un mes ni un día. |
day |
Día del mes. Debe ser entre 1 y 31 y ser válido para el año y el mes o bien 0 para especificar un año solo o un año y un mes en los que el día no sea significativo. |
Fecha y hora
Representa la hora civil (o, en ocasiones, la hora física).
Este tipo puede representar una hora civil de una de las siguientes maneras posibles:
- Cuando se establece utc_offset y no se establece time_zone: Hora civil en un día calendario con un desplazamiento particular desde UTC.
- Cuando se establece time_zone y no se establece utc_offset: Es una hora civil en un día calendario en una zona horaria particular.
- Cuando no se configuran time_zone ni utc_offset: Hora civil en un día calendario en hora local.
La fecha está relacionada con el calendario gregoriano proléptico.
Si el año, el mes o el día son 0, se considera que DateTime no tiene un año, mes o día específicos, respectivamente.
Este tipo también se puede usar para representar una hora física si se configuran todos los campos de fecha y hora, y se establece cualquiera de los casos del elemento time_offset oneof. Considera usar el mensaje Timestamp para el tiempo físico. Si tu caso de uso también requiere almacenar la zona horaria del usuario, puedes hacerlo en otro campo.
Este tipo es más flexible de lo que algunas aplicaciones podrían desear. Asegúrate de documentar y validar las limitaciones de tu aplicación.
| Campos | |
|---|---|
year |
Opcional. Año de la fecha. Debe ser entre 1 y 9999, o bien 0 si se especifica una fecha y hora sin año. |
month |
Opcional. Mes del año. Debe ser del 1 al 12 o 0 si se especifica una fecha y hora sin un mes. |
day |
Opcional. Día del mes. Debe ser entre 1 y 31, y ser válido para el año y el mes, o bien 0 si se especifica una fecha y hora sin un día. |
hours |
Opcional. Horas del día en formato de 24 horas. Debe ser del 0 al 23. El valor predeterminado es 0 (medianoche). Una API puede permitir el valor “24:00:00” para casos como el horario de cierre de empresas. |
minutes |
Opcional. Minutos de horas del día. Debe ser un valor entre 0 y 59 (el valor predeterminado es 0). |
seconds |
Opcional. Segundos de minutos de la hora. Por lo general, debe ser un valor entre 0 y 59 (el valor predeterminado es 0). Una API puede permitir el valor 60 si permite segundos bisiestos. |
nanos |
Opcional. Fracciones de segundos en nanosegundos. Debe ser un valor entre 0 y 999,999,999. El valor predeterminado es 0. |
Campo de unión time_offset. Opcional. Especifica el desplazamiento UTC o la zona horaria del objeto DateTime. Elige con cuidado entre ellos, teniendo en cuenta que los datos de la zona horaria pueden cambiar en el futuro (por ejemplo, un país modifica las fechas de inicio y finalización del horario de verano, y ya se almacenaron objetos DateTime futuros en el rango afectado). Si se omite, se considera que la fecha y hora son locales. Las direcciones (time_offset) solo pueden ser una de las siguientes opciones: |
|
utc_offset |
Es la compensación de UTC. Debe ser en segundos completos, entre -18 y +18 horas. Por ejemplo, un desfase de UTC de -4:00 se representaría como { seconds: -14400 }. |
time_zone |
Zona horaria. |
Intervalo
Representa un intervalo de tiempo, codificado como una marca de tiempo de inicio (inclusiva) y una marca de tiempo de finalización (exclusiva).
El inicio debe ser menor o igual que el final. Cuando el inicio es igual al final, el intervalo está vacío (no coincide con ninguna hora). Cuando no se especifican el inicio ni el final, el intervalo coincide con cualquier hora.
| Campos | |
|---|---|
start_time |
Opcional. Es el inicio inclusivo del intervalo. Si se especifica, la marca de tiempo que coincida con este intervalo deberá ser igual o posterior al inicio. |
end_time |
Opcional. Es el final exclusivo del intervalo. Si se especifica, la marca de tiempo que coincida con este intervalo deberá ser anterior al final. |
LatLng
Es un objeto que representa un par de valores de latitud y longitud. Esto se expresa como un par de números de punto flotante de doble precisión que representan los grados de latitud y longitud. A menos que se especifique lo contrario, este objeto debe cumplir con el estándar WGS84. Los valores deben pertenecer a rangos normalizados.
| Campos | |
|---|---|
latitude |
La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0]. |
longitude |
La longitud expresada en grados. Debe pertenecer al rango [-180.0, +180.0]. |
LocalizedText
Es la variante localizada de un texto en un idioma en particular.
| Campos | |
|---|---|
text |
Cadena localizada en el idioma correspondiente a |
language_code |
Es el código de idioma BCP-47 del texto, como "en-US" o "sr-Latn". Para obtener más información, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. |
TimeZone
Representa una zona horaria de la base de datos de zonas horarias de IANA.
| Campos | |
|---|---|
id |
Zona horaria de la base de datos de zonas horarias de IANA. Por ejemplo, "America/New_York". |
version |
Opcional. Número de versión de la base de datos de zonas horarias de IANA. Por ejemplo, "2019a". |