Package google.protobuf

Indice

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.