Indice
Duration
(messaggio)
Durata
Una durata rappresenta un intervallo di tempo firmato e fisso, costituito da un numero di secondi e frazioni di secondo con una risoluzione di nanosecondi. È indipendente da qualsiasi calendario e concetto come "giorno" o "mese". Si riferisce al timestamp in quanto la differenza tra due valori di timestamp è una durata e può essere aggiunta o sottratta da un timestamp. L'intervallo è di circa +-10.000 anni.
Esempio 1: durata del calcolo calcolata tra due timestamp in pseudo codice.
Timestamp start = ...;
Timestamp end = ...;
Duration duration = ...;
duration.seconds = end.seconds - start.seconds;
duration.nanos = end.nanos - start.nanos;
if (duration.seconds < 0 && duration.nanos > 0) {
duration.seconds += 1;
duration.nanos -= 1000000000;
} else if (duration.seconds > 0 && duration.nanos < 0) {
duration.seconds -= 1;
duration.nanos += 1000000000;
}
Esempio 2: timestamp di calcolo da timestamp + durata in pseudo codice.
Timestamp start = ...;
Duration duration = ...;
Timestamp end = ...;
end.seconds = start.seconds + duration.seconds;
end.nanos = start.nanos + duration.nanos;
if (end.nanos < 0) {
end.seconds -= 1;
end.nanos += 1000000000;
} else if (end.nanos >= 1000000000) {
end.seconds += 1;
end.nanos -= 1000000000;
}
Nome campo | Tipo | Descrizione |
---|---|---|
seconds |
int64 |
Secondi firmati dell'intervallo di tempo. Il valore deve essere compreso tra -315.576.000.000 e +315.576.000.000 inclusi. |
nanos |
int32 |
Frazioni firmate di un secondo con risoluzione nanoseconda dell'intervallo di tempo. Le durate inferiori a 1 secondo sono rappresentate da un campo 0 seconds e un campo nanos positivo o negativo. Per durate di almeno un secondo, un valore diverso da zero per il campo nanos deve avere lo stesso segno del campo seconds . Il valore deve essere compreso tra -999.999.999 e +999.999.999 inclusi. |