Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(1162)

Side by Side Diff: third_party/protobuf/src/google/protobuf/timestamp.proto

Issue 1842653006: Update //third_party/protobuf to version 3. (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: update defines Created 4 years, 8 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
OLDNEW
(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
31 syntax = "proto3";
32
33 package google.protobuf;
34
35 option csharp_namespace = "Google.Protobuf.WellKnownTypes";
36 option cc_enable_arenas = true;
37 option java_package = "com.google.protobuf";
38 option java_outer_classname = "TimestampProto";
39 option java_multiple_files = true;
40 option java_generate_equals_and_hash = true;
41 option objc_class_prefix = "GPB";
42
43 // A Timestamp represents a point in time independent of any time zone
44 // or calendar, represented as seconds and fractions of seconds at
45 // nanosecond resolution in UTC Epoch time. It is encoded using the
46 // Proleptic Gregorian Calendar which extends the Gregorian calendar
47 // backwards to year one. It is encoded assuming all minutes are 60
48 // seconds long, i.e. leap seconds are "smeared" so that no leap second
49 // table is needed for interpretation. Range is from
50 // 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z.
51 // By restricting to that range, we ensure that we can convert to
52 // and from RFC 3339 date strings.
53 // See [https://www.ietf.org/rfc/rfc3339.txt](https://www.ietf.org/rfc/rfc3339.t xt).
54 //
55 // Example 1: Compute Timestamp from POSIX `time()`.
56 //
57 // Timestamp timestamp;
58 // timestamp.set_seconds(time(NULL));
59 // timestamp.set_nanos(0);
60 //
61 // Example 2: Compute Timestamp from POSIX `gettimeofday()`.
62 //
63 // struct timeval tv;
64 // gettimeofday(&tv, NULL);
65 //
66 // Timestamp timestamp;
67 // timestamp.set_seconds(tv.tv_sec);
68 // timestamp.set_nanos(tv.tv_usec * 1000);
69 //
70 // Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`.
71 //
72 // FILETIME ft;
73 // GetSystemTimeAsFileTime(&ft);
74 // UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;
75 //
76 // // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z
77 // // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.
78 // Timestamp timestamp;
79 // timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
80 // timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));
81 //
82 // Example 4: Compute Timestamp from Java `System.currentTimeMillis()`.
83 //
84 // long millis = System.currentTimeMillis();
85 //
86 // Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
87 // .setNanos((int) ((millis % 1000) * 1000000)).build();
88 //
89 //
90 // Example 5: Compute Timestamp from current time in Python.
91 //
92 // now = time.time()
93 // seconds = int(now)
94 // nanos = int((now - seconds) * 10**9)
95 // timestamp = Timestamp(seconds=seconds, nanos=nanos)
96 //
97 //
98 message Timestamp {
99
100 // Represents seconds of UTC time since Unix epoch
101 // 1970-01-01T00:00:00Z. Must be from from 0001-01-01T00:00:00Z to
102 // 9999-12-31T23:59:59Z inclusive.
103 int64 seconds = 1;
104
105 // Non-negative fractions of a second at nanosecond resolution. Negative
106 // second values with fractions must still have non-negative nanos values
107 // that count forward in time. Must be from 0 to 999,999,999
108 // inclusive.
109 int32 nanos = 2;
110 }
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698