Índice
DateTime
Representa la hora civil (o, en ocasiones, la hora física).
Este tipo puede representar una hora civil de una de las siguientes maneras:
- Cuando utc_offset está establecido y time_zone no está establecido, se muestra una hora civil en un día calendario con un desplazamiento particular de UTC.
- Cuando se establece time_zone y no se establece utc_offset: una hora civil en un día calendario en una zona horaria en particular.
- Cuando no se establecen time_zone ni utc_offset, se muestra una 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 la fecha y hora no tiene un año, un mes o un 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 de time_offset oneof. En su lugar, considera usar el mensaje Timestamp para la hora física. Si tu caso de uso también desea almacenar la zona horaria del usuario, puedes hacerlo en otro campo.
Este tipo es más flexible que el que pueden desear algunas aplicaciones. 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 debe ser 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 de 0 a 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 en UTC o la zona horaria de DateTime. Elige cuidadosamente entre ellos, teniendo en cuenta que los datos de 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 las DateTime futuras en el rango afectado ya se habían almacenado). Si se omite, se considera que la fecha y hora están en la hora local. time_offset puede ser solo uno de los siguientes: |
|
utc_offset |
Compensación de UTC. Debe ser un número entero de segundos, entre -18 horas y +18 horas. Por ejemplo, un desfase de UTC de -4:00 se representaría como { seconds: -14400 }. |
time_zone |
Zona horaria |
Expr
Representa una expresión textual en la sintaxis de Common Expression Language (CEL). CEL es un lenguaje de expresión similar a C. La sintaxis y la semántica de CEL se documentan en https://github.com/google/cel-spec.
Ejemplo (comparación):
title: "Summary size limit"
description: "Determines if a summary is less than 100 chars"
expression: "document.summary.size() < 100"
Ejemplo (igualdad):
title: "Requestor is owner"
description: "Determines if requestor is the document owner"
expression: "document.owner == request.auth.claims.email"
Ejemplo (lógica):
title: "Public documents"
description: "Determine whether the document should be publicly visible"
expression: "document.type != 'private' && document.type != 'internal'"
Ejemplo (manipulación de datos):
title: "Notification string"
description: "Create a notification string with a timestamp."
expression: "'New message received at ' + string(document.create_time)"
El servicio que evalúa la expresión determina las variables y las funciones exactas a las que se puede hacer referencia en la expresión. Para obtener más información, consulta la documentación del servicio.
| Campos | |
|---|---|
expression |
Representación textual de una expresión en la sintaxis de Common Expression Language. |
title |
Opcional. Título de la expresión (una string corta que describe el propósito de esta). Se puede usar, p. ej., en IU que permiten ingresar la expresión. |
description |
Opcional. Descripción de la expresión. Es un texto más largo que describe la expresión (p. ej., cuando se coloca el cursor sobre ella en una IU). |
location |
Opcional. Una string que indica la ubicación de la expresión para los informes de errores (p. ej., un nombre de archivo y una posición en este). |
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, p. ej., “America/New_York”. |
version |
Opcional. Número de versión de la base de datos de zonas horarias de IANA, p. ej., “2019a”. |