| OLD | NEW |
|---|
| (Empty) |
| 1 // Protocol Buffers - Google's data interchange format | |
| 2 // Copyright 2008 Google Inc. All rights reserved. | |
| 3 // https://developers.google.com/protocol-buffers/ | |
| 4 // | |
| 5 // Redistribution and use in source and binary forms, with or without | |
| 6 // modification, are permitted provided that the following conditions are | |
| 7 // met: | |
| 8 // | |
| 9 // * Redistributions of source code must retain the above copyright | |
| 10 // notice, this list of conditions and the following disclaimer. | |
| 11 // * Redistributions in binary form must reproduce the above | |
| 12 // copyright notice, this list of conditions and the following disclaimer | |
| 13 // in the documentation and/or other materials provided with the | |
| 14 // distribution. | |
| 15 // * Neither the name of Google Inc. nor the names of its | |
| 16 // contributors may be used to endorse or promote products derived from | |
| 17 // this software without specific prior written permission. | |
| 18 // | |
| 19 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | |
| 20 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | |
| 21 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR | |
| 22 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT | |
| 23 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | |
| 24 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT | |
| 25 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | |
| 26 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | |
| 27 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
| 28 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | |
| 29 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 30 syntax = "proto3"; | |
| 31 | |
| 32 package google.protobuf; | |
| 33 | |
| 34 option java_generate_equals_and_hash = true; | |
| 35 option java_multiple_files = true; | |
| 36 option java_outer_classname = "TimestampProto"; | |
| 37 option java_package = "com.google.protobuf"; | |
| 38 option csharp_namespace = "Google.Protobuf.WellKnownTypes"; | |
| 39 option objc_class_prefix = "GPB"; | |
| 40 | |
| 41 | |
| 42 // A Timestamp represents a point in time independent of any time zone | |
| 43 // or calendar, represented as seconds and fractions of seconds at | |
| 44 // nanosecond resolution in UTC Epoch time. It is encoded using the | |
| 45 // Proleptic Gregorian Calendar which extends the Gregorian calendar | |
| 46 // backwards to year one. It is encoded assuming all minutes are 60 | |
| 47 // seconds long, i.e. leap seconds are "smeared" so that no leap second | |
| 48 // table is needed for interpretation. Range is from | |
| 49 // 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. | |
| 50 // By restricting to that range, we ensure that we can convert to | |
| 51 // and from RFC 3339 date strings. | |
| 52 // See [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.t
xt). | |
| 53 // | |
| 54 // Example 1: Compute Timestamp from POSIX `time()`. | |
| 55 // | |
| 56 // Timestamp timestamp; | |
| 57 // timestamp.set_seconds(time(NULL)); | |
| 58 // timestamp.set_nanos(0); | |
| 59 // | |
| 60 // Example 2: Compute Timestamp from POSIX `gettimeofday()`. | |
| 61 // | |
| 62 // struct timeval tv; | |
| 63 // gettimeofday(&tv, NULL); | |
| 64 // | |
| 65 // Timestamp timestamp; | |
| 66 // timestamp.set_seconds(tv.tv_sec); | |
| 67 // timestamp.set_nanos(tv.tv_usec * 1000); | |
| 68 // | |
| 69 // Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`. | |
| 70 // | |
| 71 // FILETIME ft; | |
| 72 // GetSystemTimeAsFileTime(&ft); | |
| 73 // UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime; | |
| 74 // | |
| 75 // // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z | |
| 76 // // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z. | |
| 77 // Timestamp timestamp; | |
| 78 // timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL)); | |
| 79 // timestamp.set_nanos((INT32) ((ticks % 10000000) * 100)); | |
| 80 // | |
| 81 // Example 4: Compute Timestamp from Java `System.currentTimeMillis()`. | |
| 82 // | |
| 83 // long millis = System.currentTimeMillis(); | |
| 84 // | |
| 85 // Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000) | |
| 86 // .setNanos((int) ((millis % 1000) * 1000000)).build(); | |
| 87 // | |
| 88 // Example 5: Compute Timestamp from Python `datetime.datetime`. | |
| 89 // | |
| 90 // now = datetime.datetime.utcnow() | |
| 91 // seconds = int(time.mktime(now.timetuple())) | |
| 92 // nanos = now.microsecond * 1000 | |
| 93 // timestamp = Timestamp(seconds=seconds, nanos=nanos) | |
| 94 // | |
| 95 message Timestamp { | |
| 96 // Represents seconds of UTC time since Unix epoch | |
| 97 // 1970-01-01T00:00:00Z. Must be from from 0001-01-01T00:00:00Z to | |
| 98 // 9999-12-31T23:59:59Z inclusive. | |
| 99 int64 seconds = 1; | |
| 100 | |
| 101 // Non-negative fractions of a second at nanosecond resolution. Negative | |
| 102 // second values with fractions must still have non-negative nanos values | |
| 103 // that count forward in time. Must be from 0 to 999,999,999 | |
| 104 // inclusive. | |
| 105 int32 nanos = 2; | |
| 106 } | |
| OLD | NEW |
|---|
Chromium Code Reviews
Issue 1322483002:
Revert https://codereview.chromium.org/1291903002 (protobuf roll). (Closed)
Base URL: https://chromium.googlesource.com/chromium/src.git@master